CurrentApp 类

定义

定义可用于获取有关当前应用的许可证和列表信息以及执行应用内产品购买的方法和属性。

注意

CurrentApp 类和 Windows.ApplicationModel.Store 命名空间中的其他类型不再使用新功能进行更新。 如果你的项目针对的是 Visual Studio 中的 Windows 10 周年纪念版(10.0;版本 14393) 或更高版本(即,针对 Windows 10 版本 1607 或更高版本),我们建议你使用 Windows.Services.Store 命名空间。 有关详细信息,请参阅应用内购买和试用。 例如,使用 桌面桥的 Windows 桌面应用程序或使用合作伙伴中心 (开发沙盒的应用或游戏不支持 CurrentApp 类,任何与 Xbox Live) 集成的游戏都不支持 CurrentApp 类。 这些产品必须使用 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 CurrentApp
Public Class CurrentApp
继承
Object Platform::Object IInspectable 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

获取你的应用在 Windows 应用商店中经认证上市后由 Windows 应用商店生成的 GUID

注意

应用进入 Windows 应用商店后,将来的应用更新或更改应用说明不会导致 CurrentApp.AppId 发生更改。

LicenseInformation

获取当前应用的许可证元数据。

LinkUri

获取 Windows 应用商店 Web 目录中应用一览页的统一资源标识符 (URI) 。

方法

GetAppPurchaseCampaignIdAsync()

检索当前应用的促销活动 ID。

GetAppReceiptAsync()

请求购买应用和任何应用内产品的所有收据。 有关如何使用收据信息的示例,请参阅 使用收据验证产品购买情况。

GetCustomerCollectionsIdAsync(String, String)

检索 Microsoft Store ID 密钥,该密钥可用于查询产品权利或使用当前用户拥有的产品权利。

GetCustomerPurchaseIdAsync(String, String)

检索 Microsoft Store ID 密钥,该密钥可用于代表当前用户授予免费产品的权利。

GetProductReceiptAsync(String)

请求指定产品 ID 的收据。 有关如何使用收据信息的示例,请参阅 使用收据验证产品购买情况。

GetUnfulfilledConsumablesAsync()

返回尚未向 Microsoft Store 报告为已完成的已购买易耗品应用内产品的列表。

LoadListingInformationAsync()

异步加载应用的列表信息。

返回的 ListingInformation 对象包含列表信息 (例如,特定于用户当前所在市场的名称、价格、年龄分级) 。 此外,还提供了可用应用内产品的列表信息。

LoadListingInformationByKeywordsAsync(IIterable<String>)

异步加载应用列表信息,返回 ProductListings 集合中与所有提供的关键字匹配的功能和产品。

LoadListingInformationByProductIdsAsync(IIterable<String>)

异步加载应用列表信息,返回 ProductListings 集合中与任何给定产品 ID 匹配的功能和产品。

ReportConsumableFulfillmentAsync(String, Guid)

通知 Microsoft Store 购买易耗型加载项 (也称为应用内产品或 IAP) 已完成,并且用户有权访问内容。

ReportProductFulfillment(String)

通知 Microsoft Store 应用程序已完成应用内产品。 在应用使用此方法确认履行之前,无法重新购买此产品。

RequestAppPurchaseAsync(Boolean)

请求购买完整的应用许可证。

RequestProductPurchaseAsync(String)

请求购买加载项 (也称为应用内产品或 IAP) 。 此外,调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。

RequestProductPurchaseAsync(String, Boolean)

注意

[RequestProductPurchaseAsync (String、 Boolean) 可能会在Windows 8.1后更改或不可用。 请改用 RequestProductPurchaseAsync (String)

请求购买加载项 (也称为应用内产品或 IAP) 。 此外,调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

请求购买加载项 (也称为应用内产品或 IAP) 。 此外,调用此方法会显示用于通过 Microsoft Store 完成事务的 UI。 此重载包括可用于显示应用内购买的大型目录中特定产品/服务的详细信息的参数,该目录由应用商店中的单个产品条目表示。

适用于

另请参阅