CurrentAppSimulator クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テスト中にシミュレートされたライセンス情報を取得するために使用できるオブジェクトのインスタンス化に使用されるメソッドとプロパティを定義します。
注意
CurrentAppSimulator クラスと、Windows.ApplicationModel.Store 名前空間内の他の型は、新機能で更新されなくなりました。 Visual Studio でプロジェクトのターゲットを Windows 10 Anniversary Edition (10.0、ビルド 14393) 以降のリリースに設定している (つまり、Windows 10 Version 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 CurrentAppSimulatorPublic 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 ファイルの詳細については、「 CurrentAppSimulator で WindowsStoreProxy.xml ファイルを使用する」を参照してください。
プロパティ
| AppId |
シミュレートされたアプリ ID を取得します。 CurrentAppSimulator はアプリの開発中のテストのみを目的としているため、返される CurrentAppSimulator.AppId には 0 のみが含まれます。 アプリが Windows ストアに一覧表示されると、 CurrentApp.AppId はアプリのオンボーディング中に生成され、Windows ストア カタログ内のアプリの一覧に使用される GUID を 取得します。 注意 アプリの更新やアプリの説明の変更によって CurrentApp.AppId が変更されることはありません。 |
| LicenseInformation |
シミュレーションによって提供される現在のアプリのシミュレートされたライセンス メタデータを取得します。 |
| LinkUri |
現在のアプリの Microsoft Store 登録情報ページを表すシミュレートされた Uniform Resource Identifier (URI) を取得します。 |
メソッド
| GetAppPurchaseCampaignIdAsync() |
現在のアプリのプロモーション キャンペーン ID を取得します。 |
| GetAppReceiptAsync() |
このアプリとアプリ内製品の購入に対するすべての領収書の要求をシミュレートするためにユーザーが使用できる非同期操作を作成します。 レシート情報を使用する方法の例については、「 レシートを使用して製品の購入を確認する」を参照してください。 |
| GetProductReceiptAsync(String) |
指定した製品 ID の領収書の要求をシミュレートするためにユーザーが使用できる非同期操作を作成します。 レシート情報を使用する方法の例については、「 レシートを使用して製品の購入を確認する」を参照してください。 |
| GetUnfulfilledConsumablesAsync() |
ローカルで満たされていない購入済みのコンシューマブルなアプリ内製品の一覧を返します。 |
| LoadListingInformationAsync() |
シミュレートされたアプリのリスト情報を非同期的に読み込みます。 返される ListingInformation オブジェクトには、ユーザーが現在存在している市場に固有の登録情報 (名前、価格、年齢評価など) が含まれています。 さらに、アプリ内製品を介して利用可能な製品のリスト情報も提供されます。 注意 シミュレーションの目的で、このメソッドは、返されたオブジェクトのメンバーのデータ ソースとして、WindowsStoreProxy.xml ファイル内の 要素を使用します。 詳細については、 CurrentAppSimulator のコード例を参照してください。 |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
シミュレートされたアプリリスト情報を非同期的に読み込み、指定されたすべてのキーワードに一致する ProductListings コレクション内のアプリ内製品を返します。 |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
シミュレートされたアプリリスト情報を非同期的に読み込み、指定された製品 ID のいずれかに一致する ProductListings コレクション内の使用可能なアプリ内製品を返します。 |
| ReloadSimulatorAsync(StorageFile) |
WindowsStoreProxy.xmlファイルを含む StorageFile を使用してシミュレーターを再読 み 込みします。 このメソッドを呼び出して独自のファイルを読み込まない場合、シミュレーターは既定値のセットを含む WindowsStoreProxy.xml ファイルを作成/読み込み (上書きしません) します。 |
| ReportConsumableFulfillmentAsync(String, Guid) |
コンシューマブル アドオン (アプリ内製品または IAP とも呼ばれます) の購入が満たされ、ユーザーがコンテンツにアクセスする権利を持っていることを Microsoft Store に通知することをシミュレートします。 |
| 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 を表示する非同期操作を作成します。 このオーバーロードには、ストア内の 1 つの製品エントリで表されるアプリ内購入の大規模なカタログ内で特定のオファーの詳細を表示するために使用できるパラメーターが含まれます。 |