CurrentAppSimulator Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет методы и свойства, используемые для создания экземпляра объекта, который можно использовать для получения смоделированных сведений о лицензии во время тестирования.
Примечание
Класс CurrentAppSimulator и другие типы в пространстве имен Windows.ApplicationModel.Store больше не обновляются с помощью новых функций. Если проект приложения ориентирован на Windows 10 Anniversary Edition (10.0; сборка 14393) или более поздние версии в Visual Studio (то есть, вы ориентируете приложение на Windows 10 версии 1607 и более поздние версии), рекомендуется вместо этого использовать пространство имен Windows.Services.Store. Подробнее см. в разделе Покупки из приложения и пробные версии. Класс CurrentAppSimulator не поддерживается в классических приложениях Windows, использующих мост для классических приложений, а также в приложениях или играх, использующих песочницу разработки в Центре партнеров (например, это относится к любой игре, которая интегрируется с Xbox Live). Эти продукты должны использовать для реализации покупок из приложения и пробных версий пространство имен Windows.Services.Store.
public ref class CurrentAppSimulator abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CurrentAppSimulator final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class CurrentAppSimulator
Public Class CurrentAppSimulator
- Наследование
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
Пока приложение не будет указано в Microsoft Store, объект CurrentApp не будет работать в приложении. Используйте CurrentAppSimulator для тестирования лицензирования и продуктов из приложения во время разработки приложения. После тестирования приложения и перед его отправкой в Microsoft Store необходимо заменить экземпляры CurrentAppSimulator на CurrentApp. Ваше приложение не пройдет сертификацию, если оно использует CurrentAppSimulator.
При использовании CurrentAppSimulator начальное состояние лицензирования приложения описывается в файле с именем WindowsStoreProxy.xml. Методы CurrentAppSimulator, которые изменяют состояние лицензии, например путем приобретения лицензии или обработки покупки из приложения, обновляют только состояние лицензии объекта в памяти. Содержимое WindowsStoreProxy.xml не изменяется. При очередном запуске приложения состояние лицензии возвращается к описанному в WindowsStoreProxy.xml.
Дополнительные сведения о файле WindowsStoreProxy.xml см. в разделе Использование файла WindowsStoreProxy.xml с CurrentAppSimulator.
Свойства
AppId |
Возвращает идентификатор имитированного приложения. Так как CurrentAppSimulator предназначен только для тестирования во время разработки приложения, возвращенный CurrentAppSimulator.AppId будет содержать только 0. После того как приложение будет указано в Магазине Windows, CurrentApp.AppId получит GUID , созданный во время подключения приложения и используемый для перечисления приложения в каталоге Магазина Windows. Примечание Обновление или изменение описания приложения не приведет к изменению CurrentApp.AppId. |
LicenseInformation |
Получает имитированные метаданные лицензии для текущего приложения, предоставленные симуляцией. |
LinkUri |
Возвращает имитированный универсальный код ресурса (URI), представляющий страницу описания в Microsoft Store для текущего приложения. |
Методы
GetAppPurchaseCampaignIdAsync() |
Извлекает идентификатор рекламной кампании для текущего приложения. |
GetAppReceiptAsync() |
Создает асинхронную операцию, которую пользователь может использовать для имитации запроса всех квитанций для этого приложения и любых покупок продуктов из приложения. Примеры использования сведений о квитанциях см. в разделе Использование квитанций для проверки покупок продуктов. |
GetProductReceiptAsync(String) |
Создает асинхронную операцию, которую пользователь может использовать для имитации запроса квитанции для указанного идентификатора продукта. Примеры использования сведений о квитанциях см. в разделе Использование квитанций для проверки покупок продуктов. |
GetUnfulfilledConsumablesAsync() |
Возвращает список приобретенных потребляемых продуктов из приложения, которые не были выполнены локально. |
LoadListingInformationAsync() |
Загружает сведения о списке имитированного приложения асинхронно. Возвращенный объект ListingInformation содержит сведения о листинге (например, имя, цена, возрастная категория), относящиеся к рынку, в котором находится пользователь. Кроме того, предоставляется список продуктов, доступных через продукты из приложения. Примечание В целях моделирования этот метод использует элемент в файле WindowsStoreProxy.xml в качестве источника данных для членов возвращаемого объекта. Дополнительные сведения см. в примерах кода в CurrentAppSimulator. |
LoadListingInformationByKeywordsAsync(IIterable<String>) |
Загружает сведения о списке имитированного приложения асинхронно, возвращая продукты из приложения в коллекции ProductListings , которые соответствуют всем предоставленным ключевым словам. |
LoadListingInformationByProductIdsAsync(IIterable<String>) |
Загружает сведения о списке имитированного приложения в асинхронном режиме, возвращая доступные в приложении продукты в коллекции ProductListings , которые соответствуют любому из заданных идентификаторов продуктов. |
ReloadSimulatorAsync(StorageFile) |
Перезагружает симулятор с помощью StorageFile, содержащего файлWindowsStoreProxy.xml . Если этот метод не вызывается для загрузки собственного файла, симулятор создаст или загрузит (но не перезапишет) файлWindowsStoreProxy.xml , содержащий набор значений по умолчанию. |
ReportConsumableFulfillmentAsync(String, Guid) |
Имитирует уведомление Microsoft Store о том, что покупка потребляемой надстройки (также называемой продуктом из приложения или IAP) выполнена и что пользователь имеет право на доступ к содержимому. |
RequestAppPurchaseAsync(Boolean) |
Создает асинхронную операцию, которая имитирует запрос пользователя на покупку полной лицензии для текущего приложения. |
RequestProductPurchaseAsync(String) |
Создает асинхронную операцию, отображающую пользовательский интерфейс, используемый для имитации покупки надстройки (также называемой продуктом из приложения или IAP) в Microsoft Store. |
RequestProductPurchaseAsync(String, Boolean) |
Примечание [RequestProductPurchaseAsync(String, Boolean) может быть изменен или недоступен для выпусков после Windows 8.1. Вместо этого используйте RequestProductPurchaseAsync(String). Создает асинхронную операцию, отображающую пользовательский интерфейс, используемый для имитации покупки надстройки (также называемой продуктом из приложения или IAP) в Microsoft Store. |
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Создает асинхронную операцию, отображающую пользовательский интерфейс, используемый для имитации покупки надстройки (также называемой продуктом из приложения или IAP) в Microsoft Store. Эта перегрузка включает параметры, которые можно использовать для отображения сведений о конкретном предложении в большом каталоге покупок из приложения, который представлен одной записью продукта в Магазине. |