CurrentApp Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет методы и свойства, которые можно использовать для получения сведений о лицензиях и описаниях текущего приложения и выполнения покупок продуктов из приложения.
Примечание
Класс CurrentApp и другие типы в пространстве имен Windows.ApplicationModel.Store больше не обновляются новыми функциями. Если проект приложения ориентирован на Windows 10 Anniversary Edition (10.0; сборка 14393) или более поздние версии в Visual Studio (то есть, вы ориентируете приложение на Windows 10 версии 1607 и более поздние версии), рекомендуется вместо этого использовать пространство имен Windows.Services.Store. Подробнее см. в разделе Покупки из приложения и пробные версии. Класс CurrentApp не поддерживается в классических приложениях Windows, использующих мост для классических приложений, а также в приложениях или играх, использующих песочницу разработки в Центре партнеров (например, это относится к любой игре, которая интегрируется с Xbox Live). Эти продукты должны использовать для реализации покупок из приложения и пробных версий пространство имен Windows.Services.Store.
public ref class CurrentApp 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 CurrentApp 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 CurrentAppPublic Class CurrentApp- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
Этот объект получает свои данные из Microsoft Store, поэтому у вас должна быть учетная запись разработчика, а приложение должно быть опубликовано в Microsoft Store. Перед отправкой в Microsoft Store можно протестировать код с помощью имитированной версии этого класса (состояние которого инициализировано из XML-файла). См . раздел CurrentAppSimulator.
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
Свойства
| AppId |
Получает GUID , созданный Магазином Windows, когда ваше приложение сертифицировано для публикации в Магазине Windows. Примечание После того как приложение появится в Магазине Windows, будущие обновления приложения или изменения в его описании не приведут к изменению CurrentApp.AppId. |
| LicenseInformation |
Возвращает метаданные лицензии для текущего приложения. |
| LinkUri |
Возвращает универсальный код ресурса (URI) страницы описания приложения в веб-каталоге Магазина Windows. |
Методы
| GetAppPurchaseCampaignIdAsync() |
Извлекает идентификатор кампании продвижения для текущего приложения. |
| GetAppReceiptAsync() |
Запрашивает все квитанции о покупке приложения и любых продуктов из приложения. Примеры использования сведений о квитанциях см. в разделе Использование квитанций для проверки покупок продуктов. |
| GetCustomerCollectionsIdAsync(String, String) |
Извлекает ключ идентификатора Microsoft Store, который можно использовать для запроса прав на продукты или использования прав продукта, принадлежащих текущему пользователю. |
| GetCustomerPurchaseIdAsync(String, String) |
Извлекает ключ идентификатора Microsoft Store, который можно использовать для предоставления прав на бесплатные продукты от имени текущего пользователя. |
| GetProductReceiptAsync(String) |
Запрашивает квитанцию для указанного идентификатора продукта. Примеры использования сведений о квитанциях см. в разделе Использование квитанций для проверки покупок продуктов. |
| GetUnfulfilledConsumablesAsync() |
Возвращает список приобретенных потребляемых продуктов из приложения, которые не были зарегистрированы в Microsoft Store как выполненные. |
| LoadListingInformationAsync() |
Загружает сведения о списке приложения асинхронно. Возвращенный объект ListingInformation содержит сведения о листинге (например, имя, цену, возрастную категорию), относящиеся к рынку, в котором в данный момент находится пользователь. Кроме того, приведены сведения о доступных продуктах из приложения. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
Загружает сведения о списке приложений асинхронно, возвращая функции и продукты в коллекции ProductListings , которые соответствуют всем предоставленным ключевым словам. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
Загружает сведения о списке приложений асинхронно, возвращая функции и продукты в коллекции ProductListings , которые соответствуют любому из заданных идентификаторов продуктов. |
| ReportConsumableFulfillmentAsync(String, Guid) |
Уведомляет Microsoft Store о том, что покупка потребляемой надстройки (также называемой продуктом из приложения или IAP) выполнена и что пользователь имеет право на доступ к содержимому. |
| ReportProductFulfillment(String) |
Уведомляет Microsoft Store о том, что приложение выполнило продукт из приложения. Этот продукт нельзя приобрести повторно, пока приложение не подтвердит выполнение с помощью этого метода. |
| 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. Эта перегрузка включает параметры, которые можно использовать для отображения сведений о конкретном предложении в большом каталоге покупок из приложения, который представлен одной записью продукта в Магазине. |