CurrentApp クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel.Store

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 CurrentApp

Public Class CurrentApp

継承: Object Platform::Object IInspectable CurrentApp

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 つの製品エントリで表されるアプリ内購入の大規模なカタログ内の特定のオファーの詳細を表示するために使用できるパラメーターが含まれます。

適用対象