アプリ内購入と試用版

Windows.Services.Store 名前空間を使用するアプリ内購入と試用版

このセクションでは、Windows.Services.Store 名前空間の重要なタスクと概念の概要を説明します。 この名前空間は、Visual Studio で Windows 10 Anniversary Edition (10.0、ビルド 14393) 以降のリリース (これは Windows 10 バージョン 1607 に相当します) を対象とするアプリでのみ使用できます。 可能な場合は、Windows.ApplicationModel.Store 名前空間ではなく Windows.Services.Store 名前空間を使用することをお勧めします。 Windows.ApplicationModel.Store 名前空間については、こちらの記事を参照してください。

このセクションの内容

• ビデオ
• StoreContext クラスの概要
• アプリ内購入を実装する
• 試用版機能を実装する
• アプリ内購入または試用版の実装をテストする
• アプリ内購入の領収書
• デスクトップ ブリッジでの StoreContext クラスの使用
• 製品、SKU、可用性
• Store ID

StoreContext クラスの概要

Windows.Services.Store 名前空間へのメイン エントリ ポイントは、StoreContext クラスです。 このクラスには、現在のアプリとその利用可能なアドオンに関する情報の取得、現在のアプリまたはそのアドオンに関するライセンス情報の取得、現在のユーザー向けのアプリまたはアドオンの購入、その他のタスクの実行に使用できるメソッドが用意されています。 StoreContext オブジェクトを取得するには、次のいずれかを実行します。

• シングルユーザー アプリ (つまり、アプリを起動したユーザーのコンテキストでのみ実行されるアプリ) では、静的な GetDefault メソッドを使用して StoreContext オブジェクトを取得します。これは、ユーザーの Microsoft Store 関連のデータにアクセスするために使用することができます。 ほとんどのユニバーサル Windows プラットフォーム (UWP) アプリは、シングルユーザー アプリです。

  Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
  

• マルチユーザー アプリでは、静的な GetForUser メソッドを使用して、StoreContext オブジェクトを取得します。これは、アプリの使用中、Microsoft アカウントでサインインしている特定のユーザーの Microsoft Store 関連データにアクセスするために使用できます。 次の例では、最初に使用可能なユーザーの StoreContext オブジェクトを取得します。

  var users = await Windows.System.User.FindAllAsync();
  Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
  

StoreContext オブジェクトを構成すると、このオブジェクトのメソッドを呼び出して、現在のアプリやそのアドオンに関するストア製品情報の取得、現在のアプリとそのアドオンに関するライセンス情報の取得、現在のユーザー向けのアプリやアドオンの購入、その他のタスクを実行できます。 このオブジェクトを使用して実行できる一般的なタスクの詳細については、次の記事を参照してください。

• アプリとアドオンの製品情報の取得
• アプリとアドオンのライセンス情報の取得
• アプリとアドオンのアプリ内購入の有効化
• コンシューマブルなアドオン購入の有効化
• アプリのサブスクリプション アドオンの有効化
• アプリの試用版の実装

StoreContext および Windows.Services.Store 名前空間内のその他の型を使用する方法を示すサンプル アプリについては、「Microsoft Store のサンプル」を参照してください。

アプリ内購を実装する

Windows.Services.Store 名前空間を使用してアプリで顧客にアプリ内購入を提供するには、次の手順を行います。

1. ユーザーが購入できるアドオンをアプリで提供する場合、パートナー センターで、アプリに関するアドオンの申請を作成します。

2. アプリまたはアプリで提供されるアドオンの製品情報を取得し、ライセンスがアクティブであるかどうかを確認する (つまり、ユーザーが、アプリまたはアドオンを使用するライセンスを持っているかどうかを確認する) ためのアプリのコードを記述します。 ライセンスがアクティブでない場合は、アプリ内購入としてユーザーに販売するためのアプリまたはアドオンを提供する UI を表示します。

3. ユーザーがアプリまたはアドオンの購入を選んだ場合、製品を購入するための適切なメソッドを使用します。

   • ユーザーがアプリまたは非消費型アドオンを購入する場合は、「アプリとアドオンのアプリ内購入の有効化」の手順に従います。
   • ユーザーが消費型アドオンを購入する場合は、「コンシューマブルなアドオン購入の有効化」の手順に従います。
   • ユーザーがサブスクリプション アドオンを購入する場合は、「アプリのサブスクリプション アドオンの有効化」の手順に従います。

4. この記事のテストのガイダンスに従って、実装をテストします。

試用版機能を実装する

Windows.Services.Store 名前空間を使用して、アプリの試用版で機能を除外または制限するには、次の手順を行います。

1. パートナー センターでアプリを無料試用版として構成します。

2. アプリまたはアプリで提供されるアドオンの製品情報を取得し、アプリに関連付けられているライセンスが試用版ライセンスであるかどうかを確認するためのアプリのコードを記述します。

3. 試用版の場合は、アプリ内の特定の機能を除外または制限し、ユーザーがフル ライセンスを購入したときに、その機能を有効にします。 詳細とコード例については、「アプリの試用版の実装」を参照してください。

4. この記事のテストのガイダンスに従って、実装をテストします。

アプリ内購入または試用版の実装をテストする

アプリで Windows.Services.Store 名前空間内の API を使用してアプリ内購入または試用版機能を実装する場合、アプリを Microsoft Store に発行し、そのアプリを開発用デバイスにダウンロードし、そのライセンスを使用してテストを行う必要があります。 次のプロセスに従ってコードをテストします。

1. アプリがまだ公開されておらず、Microsoft Store で利用できない場合、アプリが Windows アプリ認定キットの最低限の要件を満たしていることを確認し、パートナー センターにそのアプリを申請します。その後で、アプリが認定プロセスに合格したことを確認します。 テスト中は Microsoft Store で検索できないようにアプリを構成することができます。 パッケージ フライトの適切な構成をご確認ください。 正しく構成されていないパッケージ フライトは、ダウンロードできない可能性があります。

2. 次に、以下の手順が完了していることを確認します。

   • StoreContext クラスと、Windows.Services.Store 名前空間内のその他の関連する型を使用して アプリ内購入または試用版機能を実装するアプリのコードを記述します。
   • ユーザーが購入できるアドオンをアプリで提供する場合、パートナー センターで、アプリに関するアドオンの申請を作成します。
   • アプリの試用版で一部の機能を除外または制限する場合は、パートナー センターで、アプリを無料試用版として構成します。

3. Visual Studio でプロジェクトを開き、[プロジェクト] メニューをクリックし、[Microsoft Store] をポイントして、[アプリを Microsoft Store に関連付ける] をクリックします。 ウィザードの手順を完了し、テストに使用するパートナー センター アカウントのアプリとアプリ プロジェクトを関連付けます。

   Note

   プロジェクトを Microsoft Store 内のアプリと関連付けない場合、StoreContext メソッドによって、戻り値の ExtendedError プロパティがエラー コード値 0x803F6107 に設定されます。 この値は、Microsoft Store でアプリが認識されていないことを示します。

4. 前の手順で指定したアプリを Microsoft Store からまだインストールしていない場合は、アプリを 1 回実行し、そのアプリを閉じます。 これにより、アプリの有効なライセンスが開発用デバイスにインストールされます。

5. Visual Studio で、プロジェクトの実行またはデバッグを開始します。 コードでは、ローカル プロジェクトに関連付けられたアプリとアドオンの情報を Microsoft Store アプリから取得する必要があります。 アプリを再インストールするように求められたら、指示に従ってプロジェクトを実行またはデバッグします。

   Note

   これらの手順を完了すると、新しいパッケージを Microsoft Store に申請しなくても、引き続き開発用コンピューターでアプリのコードを更新し、更新されたプロジェクトをデバッグできます。 テストに使用するローカル ライセンスを取得するために、アプリの Microsoft Store バージョンを開発用コンピューターにダウンロードする必要があるのは 1 回だけです。 新しいアプリ パッケージを Microsoft Store に申請する必要があるのは、テストが完了した後、顧客がアプリ内でアプリ内購入または試用版関連の機能を利用できるようにするときだけです。

アプリで Windows.ApplicationModel.Store 名前空間を使用すると、アプリを Microsoft Store に申請する前に、テスト中にアプリで CurrentAppSimulator クラスを使用して、ライセンス情報をシミュレートできます。 詳細については、「CurrentApp クラスと CurrentAppSimulator クラスの概要」を参照してください。

アプリ内購入の領収書

Windows.Services.Store 名前空間には、アプリのコードで正常な購入の取引領収書を取得するために使用できる API は用意されていません。 これは、クライアント側の API を使用して取引領収書を取得できる Windows.ApplicationModel.Store 名前空間を使用するアプリのエクスペリエンスと異なる点です。

Windows.Services.Store 名前空間を使用してアプリ内購入を実装し、特定の顧客がアプリまたはアドオンを購入したかどうかを検証する必要がある場合は、Microsoft Store コレクション REST API の製品のクエリ メソッド を使用できます。 このメソッドで返されるデータによって、指定された顧客に特定の製品に対する権利があるかどうかを確認し、そのユーザーが取得した製品の取引に関するデータを取得できます。 Microsoft Store コレクション API では、Azure AD 認証を使用してこの情報を取得します。

デスクトップ ブリッジでの StoreContext クラスの使用

デスクトップ ブリッジを使用するデスクトップ アプリケーションでは、StoreContext クラスを使用してアプリ内購入と試用版を実装できます。 ただし、Win32 デスクトップ アプリケーション、またはレンダリング フレームワーク (WPF や Windows App SDK アプリケーションなど) に関連付けられているウィンドウ ハンドル (HWND) を含んだデスクトップ アプリケーションがある場合、アプリケーションでは、オブジェクトによって表示されるモーダル ダイアログのオーナー ウィンドウとなるアプリケーション ウィンドウを指定するように、StoreContext オブジェクトを構成する必要があります。

多くの StoreContext メンバー (および StoreContext オブジェクトを介してアクセスされる他の関連する型のメンバー) では、製品の購入など、Microsoft Store に関連する操作を行うためのモーダル ダイアログがユーザーに表示されます。 デスクトップ アプリケーションで、モーダル ダイアログの所有者ウィンドウを指定するように StoreContext オブジェクトを構成しない場合、このオブジェクトによって、不正確なデータまたはエラーが返されます。

デスクトップ ブリッジを使用するデスクトップ アプリケーションで StoreContext オブジェクトを構成するには、次の手順に従います。

.NET 6 以降の場合

アプリケーションが、.NET 6 以降を使用して C# で記述されている場合、次の手順に従います。

1. プロジェクト ファイルの TargetFramework プロパティが、WinRT.Interop 名前空間へのアクセスを提供する Windows ランタイム API にアクセスする特定の Windows SDK バージョンに設定されていることを確認します。 次に例を示します。

   <PropertyGroup>
     <!-- You can also target other versions of the Windows SDK and .NET, e.g. "net6.0-windows10.0.19041.0" -->
     <TargetFramework>net6.0-windows10.0.22000.0</TargetFramework>
   </PropertyGroup>
   

2. この記事で既に説明したように、GetDefault メソッド (アプリがマルチユーザー アプリの場合は GetForUser) を使用して、StoreContext オブジェクトを取得します。 指定したウィンドウ ハンドルを使用してダイアログを初期化するには、WinRT.Interop.WindowNative.GetWindowHandle メソッドと WinRT.Interop.InitializeWithWindow.Initialize メソッドを使用します (「ウィンドウ ハンドルを取得する (HWND)」および「CoreWindow に依存する WinRT UI オブジェクトを表示する」を参照)。

   StoreContext context = StoreContext.GetDefault();
   // Obtain window handle by passing in pointer to the window object
   var hwnd = WinRT.Interop.WindowNative.GetWindowHandle(windowObject);
   // Initialize the dialog using wrapper function for IInitializeWithWindow
   WinRT.Interop.InitializeWithWindow.Initialize(context, hwnd); 
   

以前のバージョンの .NET または C++ の場合

アプリケーションが以前のバージョンの .NET または C++ で記述されている場合は、次の手順に従います。

1. 次のいずれかを実行して、アプリで IInitializeWithWindow インターフェイスにアクセスできるようにします。

   • アプリケーションが、C# や Visual Basic (.NET 6 以降) などのマネージド言語で記述されている場合 (.NET 6 以降)、次の C# の例に示すように、アプリのコードで ComImport 属性を使用して IInitializeWithWindow インターフェイスを宣言します。 この例では、コード ファイルに System.Runtime.InteropServices 名前空間の using ステートメントが含まれていることを前提としています。

     [ComImport]
     [Guid("3E68D4BD-7135-4D10-8018-9FB6D9F33FA1")]
     [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
     public interface IInitializeWithWindow
     {
         void Initialize(IntPtr hwnd);
     }
     

   • アプリケーションが C++ で記述されている場合、コードに shobjidl.h ヘッダー ファイルへの参照を追加します。 このヘッダー ファイルには、IInitializeWithWindow インターフェイスの宣言が含まれています。

2. この記事で既に説明したように、GetDefault メソッド (アプリがマルチユーザー アプリの場合は GetForUser) を使用して、StoreContext オブジェクトを取得し、このオブジェクトを IInitializeWithWindow オブジェクトにキャストします。 次に、IInitializeWithWindow.Initialize メソッドを呼び出し、StoreContext メソッドによって表示されるモーダル ダイアログの所有者にするウィンドウのハンドルを渡します。 次の C# の例は、アプリのメイン ウィンドウをメソッドに渡す方法を示しています。 「ウィンドウ ハンドルを取得する (HWND)」および「CoreWindow に依存する WinRT UI オブジェクトを表示する」も参照してください。

   StoreContext context = StoreContext.GetDefault();
   IInitializeWithWindow initWindow = (IInitializeWithWindow)(object)context;
   initWindow.Initialize(System.Diagnostics.Process.GetCurrentProcess().MainWindowHandle);
   

製品、SKU、可用性

Microsoft Store 内のすべての製品には、少なくとも 1 つの "SKU" があり、各 SKU には、少なくとも 1 つの "可用性" があります。 パートナー センターでは、ほとんどの場合、これらの概念は開発者から抽象化されており、多くの開発者はアプリまたはアドオンの SKU や可用性を定義することはありません。 ただし、Windows.Services.Store 名前空間内の Microsoft Store 製品のオブジェクト モデルには、SKU と可用性が含まれているため、これらの概念の基本を理解しておくと、一部のシナリオで役立ちます。

ストア ID

Microsoft Store 内のすべてのアプリ、アドオン、またはその他の製品には、Store ID (これは、"製品 Store ID" と呼ばれる場合もあります) が関連付けられています。 多くの API では、アプリまたはアドオンに対して操作を実行するために Store ID が必要です。

Microsoft Store 内の製品の Store ID は、12 文字の英数字文字列です (例: 9NBLGGH4R315)。 Microsoft Store 内の製品の Store ID を取得するには、いくつかの異なる方法があります。

• アプリの場合、Store ID は、パートナー センターの [アプリ ID] ページで取得できます。
• アドオンの場合、Store ID はパートナー センターのアドオンの概要ページで取得できます。
• どの製品についても、製品を表す StoreProduct オブジェクトの StoreId プロパティを使用して、プログラムで Store ID を取得することもできます。

SKU と可用性を持つ製品の場合、SKU と可用性にも、形式が異なる独自の Store ID があります。

コードでアドオンの製品 ID を使用する方法

アプリのコンテキストでユーザーがアドオンを利用できるようにするには、パートナー センターでアドオンの申請を作成するときに、アドオン用の固有の製品 ID を入力しなければなりません。 この製品 ID を使用して、コード内でアドオンを参照できますが、製品 ID を使用できる特定のシナリオは、アプリ内のアプリ内購入に使用する名前空間によって異なります。

Windows.Services.Store 名前空間を使用するアプリ

アプリで Windows.Services.Store 名前空間を使用している場合、製品 ID を使用すると、アドオンを表す StoreProduct、またはアドオンのライセンスを表す StoreLicense を簡単に識別できます。 製品 ID は、StoreProduct.InAppOfferToken プロパティおよび StoreLicense.InAppOfferToken プロパティによって公開されます。

Windows.ApplicationModel.Store 名前空間を使用するアプリ

アプリで Windows.ApplicationModel.Store 名前空間を使用している場合は、ほとんどの操作に、パートナー センターでアドオンに割り当てた製品 ID を使用する必要があります。 次に例を示します。

• 製品 ID を使用して、アドオンを表す ProductListing、またはアドオンのライセンスを表す ProductLicense を識別します。 製品 ID は、ProductListing.ProductId プロパティおよび ProductLicense.ProductId プロパティによって公開されます。

• RequestProductPurchaseAsync メソッドを使用してユーザー用にアドオンを購入する場合、製品 ID を指定します。 詳しくは、「アプリ内製品購入の有効化」をご覧ください。

• ReportConsumableFulfillmentAsync メソッドを使用して消費型アドオンをフルフィルメント済みとして報告する場合、製品 ID を指定します。 詳細については、「コンシューマブルなアプリ内製品購入の有効化」を参照してください。

関連トピック

• アプリとアドオンの製品情報の取得
• アプリとアドオンのライセンス情報の取得
• アプリとアドオンのアプリ内購入の有効化
• コンシューマブルなアドオン購入の有効化
• アプリのサブスクリプション アドオンの有効化
• アプリの試用版の実装
• Microsoft Store の操作のエラー コード
• Windows.ApplicationModel.Store 名前空間を使用するアプリ内購入と試用版