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
Наследование
Object Platform::Object IInspectable 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.

Применяется к

См. также раздел