CurrentApp クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のアプリに関するライセンス情報と一覧情報を取得し、アプリ内製品の購入を実行するために使用できるメソッドとプロパティを定義します。
注意
Windows.ApplicationModel.Store 名前空間の CurrentApp クラスとその他の型は、新機能で更新されなくなりました。 Visual Studio でプロジェクトのターゲットを Windows 10 Anniversary Edition (10.0、ビルド 14393) 以降のリリースに設定している (つまり、Windows 10 Version 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 |
アプリが Windows ストアに登録されていることが認定されている場合に、Windows ストアによって生成される GUID を 取得します。 注意 アプリが Windows ストアに入ると、今後のアプリの更新やアプリの説明の変更によって CurrentApp.AppId が変更されることはありません。 |
| LicenseInformation |
現在のアプリのライセンス メタデータを取得します。 |
| LinkUri |
Windows ストアの Web カタログにあるアプリの登録情報ページの URI (Uniform Resource Identifier) を取得します。 |
メソッド
| 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>) |
アプリのリスト情報を非同期的に読み込み、指定された製品 ID のいずれかに一致する ProductListings コレクション内の機能と製品を返します。 |
| ReportConsumableFulfillmentAsync(String, Guid) |
コンシューマブル アドオン (アプリ内製品または IAP とも呼ばれます) の購入が完了し、ユーザーがコンテンツにアクセスする権利を持っていることを Microsoft Store に通知します。 |
| 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 が表示されます。 このオーバーロードには、ストアの 1 つの製品エントリで表されるアプリ内購入の大規模なカタログ内の特定のオファーの詳細を表示するために使用できるパラメーターが含まれます。 |