CurrentAppSimulator Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет методы и свойства, используемые для создания экземпляра объекта, который можно использовать для получения имитированных сведений о лицензии во время тестирования.
Заметка
Класс CurrentAppSimulator и другие типы в пространстве имен Windows.ApplicationModel.Store больше не обновляются с новыми функциями. Если проект предназначен для Юбилейный выпуск Windows 10 (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 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) |
Important Функции покупки в приложении не поддерживаются в приложениях с повышенными привилегиями. Создает асинхронную операцию, которая имитирует запрос пользователя на покупку полной лицензии для текущего приложения. |
| RequestProductPurchaseAsync(String, Boolean) |
Important Функции покупки в приложении не поддерживаются в приложениях с повышенными привилегиями. Заметка [RequestProductPurchaseAsync(String, Boolean) может быть изменено или недоступно для выпусков после Windows 8.1. Вместо этого используйте RequestProductPurchaseAsync(String). Создает асинхронную операцию, отображающую пользовательский интерфейс, используемый для имитации покупки надстройки (также называемой продуктом в приложении или IAP) из Microsoft Store. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
Important Функции покупки в приложении не поддерживаются в приложениях с повышенными привилегиями. Создает асинхронную операцию, отображающую пользовательский интерфейс, используемый для имитации покупки надстройки (также называемой продуктом в приложении или IAP) из Microsoft Store. Эта перегрузка включает параметры, которые можно использовать для отображения сведений о конкретном предложении в большом каталоге покупок в приложении, представленных одной записью продукта в Магазине. |
| RequestProductPurchaseAsync(String) |
Important Функции покупки в приложении не поддерживаются в приложениях с повышенными привилегиями. Создает асинхронную операцию, отображающую пользовательский интерфейс, используемый для имитации покупки надстройки (также называемой продуктом в приложении или IAP) из Microsoft Store. |