CurrentAppSimulator クラス

定義

名前空間:: Windows.ApplicationModel.Store

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

テスト中にシミュレートされたライセンス情報を取得するために使用できるオブジェクトのインスタンス化に使用されるメソッドとプロパティを定義します。

手記

CurrentAppSimulator クラスと、Windows.ApplicationModel.Store 名前空間内の他の型は、新機能で更新されなくなりました。 プロジェクトが Windows 10 Anniversary Edition (10.0;ビルド 14393) 以降のリリース (つまり、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

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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) を取得します。

名前

説明

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)	Important アプリ内購入機能は、昇格されたアプリケーションではサポートされていません。現在のアプリの完全なライセンスを購入するユーザー要求をシミュレートする非同期操作を作成します。
RequestProductPurchaseAsync(String, Boolean)	Important アプリ内購入機能は、昇格されたアプリケーションではサポートされていません。手記 [RequestProductPurchaseAsync(String, Boolean) は、Windows 8.1後にリリースで変更または使用できない場合があります。代わりに、RequestProductPurchaseAsync(String)を使用します。 Microsoft Store からのアドオン (アプリ内製品または IAP とも呼ばれます) の購入をシミュレートするために使用される UI を表示する非同期操作を作成します。
RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)	Important アプリ内購入機能は、昇格されたアプリケーションではサポートされていません。 Microsoft Store からのアドオン (アプリ内製品または IAP とも呼ばれます) の購入をシミュレートするために使用される UI を表示する非同期操作を作成します。このオーバーロードには、ストア内の 1 つの製品エントリで表されるアプリ内購入の大規模なカタログ内の特定のオファーの詳細を表示するために使用できるパラメーターが含まれます。
RequestProductPurchaseAsync(String)	Important アプリ内購入機能は、昇格されたアプリケーションではサポートされていません。 Microsoft Store からのアドオン (アプリ内製品または IAP とも呼ばれます) の購入をシミュレートするために使用される UI を表示する非同期操作を作成します。

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?