CurrentAppSimulator 类

定义

定义用于实例化可用于在测试期间获取模拟许可证信息的对象的方法和属性。

注意

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

获取模拟的应用 ID。 由于 CurrentAppSimulator 仅用于在应用开发期间进行测试,因此返回的 CurrentAppSimulator.AppId 仅包含 0。

应用在 Windows 应用商店上列出后, CurrentApp.AppId 将在应用载入期间生成 GUID ,并用于在 Windows 应用商店目录中列出你的应用。

注意

应用更新或更改应用说明不会对 CurrentApp.AppId 进行更改。

LicenseInformation

获取模拟提供的当前应用的模拟许可证元数据。

LinkUri

获取模拟的统一资源标识符 (URI) ,该 URI 表示当前应用的 Microsoft Store 一览页。

方法

GetAppPurchaseCampaignIdAsync()

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

GetAppReceiptAsync()

创建用户可用于模拟请求此应用的所有收据和任何应用内产品购买的异步操作。 有关如何使用收据信息的示例,请参阅 使用收据验证产品购买情况。

GetProductReceiptAsync(String)

创建用户可用于模拟请求指定产品 ID 收据的异步操作。 有关如何使用收据信息的示例,请参阅 使用收据验证产品购买情况。

GetUnfulfilledConsumablesAsync()

返回尚未在本地完成的已购买易耗品应用内产品的列表。

LoadListingInformationAsync()

异步加载模拟应用列表信息。

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

注意

出于模拟目的,此方法使用WindowsStoreProxy.xml文件中的元素作为返回对象成员的数据源。 有关详细信息,请参阅 CurrentAppSimulator 中的代码示例。

LoadListingInformationByKeywordsAsync(IIterable<String>)

异步加载模拟应用列表信息,并在 ProductListings 集合中返回与所有提供的关键字匹配的应用内产品。

LoadListingInformationByProductIdsAsync(IIterable<String>)

异步加载模拟应用列表信息,并在 ProductListings 集合中返回与任何给定产品 ID 匹配的应用内产品。

ReloadSimulatorAsync(StorageFile)

使用包含WindowsStoreProxy.xml文件的 StorageFile 重新加载模拟器。

如果不调用此方法来加载自己的文件,模拟器将创建/加载 (但不覆盖包含一组默认值 的WindowsStoreProxy.xml 文件) 。

ReportConsumableFulfillmentAsync(String, Guid)

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

RequestAppPurchaseAsync(Boolean)

创建模拟用户请求以购买当前应用的完整许可证的异步操作。

RequestProductPurchaseAsync(String)

创建一个异步操作,该操作显示用于模拟从 Microsoft Store 购买加载项 (也称为应用内产品或 IAP) 的 UI。

RequestProductPurchaseAsync(String, Boolean)

注意

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

创建一个异步操作,该操作显示用于模拟从 Microsoft Store 购买加载项 (也称为应用内产品或 IAP) 的 UI。

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

创建一个异步操作,该操作显示用于模拟从 Microsoft Store 购买加载项 (也称为应用内产品或 IAP) 的 UI。 此重载包括可用于在应用商店中单个产品条目表示的大型应用内购买目录中显示特定产品/服务的详细信息的参数。

适用于

另请参阅