> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # ライセンス供与テストの有効化 > XStore のライセンス供与 API をテストするために、ライセンス供与可能な XBOX 開発ビルドを設定します。関連するシナリオとパートナー センターで必要な構成手順を含みます。 この記事では、ライセンス供与関連のシナリオをテストするために、開発ビルドをライセンス供与可能な状態に設定する方法について説明します。 ## 関連するシナリオと API 以下の API をテストするには、この記事で説明するとおりに開発環境を設定する必要があります。 | API | 用途 | | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | [XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members) | ゲームの体験版またはディスク ベース ライセンスの特性を照会します。 | | [XStoreQueryLicenseTokenAsync](/reference/system/xstore/xstore_members) | サービス ベースの検証に有効なライセンス トークンを生成します。[ライセンス トークンの使用](/publishing/xstore-commerce/xstore-license-tokens)を参照してください。 | | [XStoreQueryAddOnLicensesAsync](/reference/system/xstore/xstore_members) | デジタル ゲーム ライセンスに関連付けられたアドオン ライセンス (パッケージのない耐久型) を返します。 | | [XStoreRegisterGameLicenseChanged](/reference/system/xstore/xstore_members) | ライセンスの変更 (例: 体験版ライセンスが完全なライセンスにアップグレードされる場合) を検出するために登録します。 | ## コンテキスト RETAIL シナリオでは、ゲームをプレイするにはライセンスが必要です。ライセンス要求は、インストールされたディスクを確認するか、Microsoft サービスに要求を送信します。アカウントが直接または満足させる購入 (たとえば、サブスクリプションやバンドルから) を通じて製品に対する権利がある場合、ライセンスが付与されます。ライセンスは共有シナリオでも付与できます。共有の詳細については、[ゲームの製品共有モデル](/publishing/xstore-commerce/xstore-product-sharing)を参照してください。 開発シナリオでは、既定でこの動作に従いません。これらのシナリオには次のものが含まれます。 * Loose ビルド (Visual Studio F5 配置、xbapp/wdapp register/deploy) * ローカル パッケージ ビルド (makepkg、xbapp/wdapp install) これらのビルドは、ライセンス供与チェックや関連構成なしで起動します。ほとんどの `XStore` API はまだ機能しますが、ゲームや耐久型をライセンス供与するときに予期しない結果が発生する可能性があります。 ビルドをライセンス供与可能に動作するように構成するには、MicrosoftGameConfig に適切な ID 値を適用します ([XStore 開発とテストの有効化](/publishing/xstore-commerce/xstore-product-testing-setup)で説明されています)。 その後、次の手順を実行する必要があります。 1. [ゲームまたは DLC に固有のコンテンツ ID を記録](#get-contentid) 2. [ビルド タイプに応じてビルドにコンテンツ ID を適用](#apply-content-id-to-build) 3. [**コンソールのみ**: ビルドに EKBID を記録して適用](#apply-ekbid-to-build-only-applicable-to-console) その後、ビルドを実行する各アカウントについて、プラットフォームの適切な Store から製品を購入することでエンタイトルメントを取得する必要があります。 ## ContentID を取得する **\[詳細を表示]** を選択した後、**\[パッケージ]** ページで ContentID を見つけることができます。 パートナー センターの [パッケージ] ページ サンドボックス版と RETAIL 版のコンテンツ ID は異なる場合があります。ゲームの RETAIL 版をインストールすると、その製品はサンドボックスで必要なものとは異なるコンテンツ ID に関連付けられます。地域別パッケージが含まれる場合もコンテンツ ID は異なります。 ### コンソール Gaming Command Prompt で `xbapp list /d` (または DLC の場合は `xbapp listdlc /d`) を実行して、インストール済みパッケージのコンテンツ ID を見つけます。 ```cmd theme={null} Registered Applications by Package Full Name: 41336MicrosoftATG.InGameStoreXS_2020.7.27.0_neutral__dspnxghe87tn0 Install Drive: Development Size: 0.28 GB. ContentId: {2797FA46-A93B-494C-AD80-B67C9FCA939F} ProductId: {4C544E39-5130-3044-C057-5A3446536A00} EKBID: {37E80840-6BE0-46F8-8EDB-92F877056087} DisplayName: ATG In-Game Store Sample 41336MicrosoftATG.InGameStoreXS_dspnxghe87tn0!Game ``` ### PC Gaming Command Prompt で `wdapp list /d` (または DLC の場合は `wdapp listdlc /d`) を実行して、インストール済みパッケージのコンテンツ ID を見つけます。Store からインストールしたパッケージの場合は、`/includeStore` フラグを使用します。 ## ビルドにコンテンツ ID を適用する Loose ビルドの場合、MicrosoftGameConfig に次のセクションを追加します。 ```xml theme={null} 2797FA46-A93B-494C-AD80-B67C9FCA939F 00000000-0000-0000-0000-000000000001 ``` パッケージ ビルドの場合、`makepkg` にコンテンツ ID を渡します。例: ```cmd theme={null} makepkg pack /v /f chunks.xml /d Gaming.Xbox.XboxOne.x64\Layout\Image\Loose /pd ./output /contentid 2797FA46-A93B-494C-AD80-B67C9FCA939F ``` `/contentid` パラメーターなしでパッケージを作成した場合、ローカル ソースからインストールするときに、インストール プロセスは MicrosoftGameConfig の使用可能な `ContentIdOverride` を適用します。 Store からインストールされたビルド (サンドボックスまたは RETAIL) は常に (パートナー センターで確認できる) 適切なコンテンツ ID を持っています。 ## ビルドに EKBID を適用する (コンソールのみ該当) EKBID (Escrow Key Blob ID) を設定して、コンソール上でビルドをライセンス供与可能にします。ほとんどのシナリオでは、単にすべてゼロの既定のテスト値または 33EC8436-5A0E-4F0D-B1CE-3F29C3955039 からオーバーライドするだけで済みます。 次のコマンドで EKBID をオーバーライドします。 ```cmd theme={null} xbapp setekbid {} ``` 例: ```cmd theme={null} xbapp setekbid 41336MicrosoftATG.InGameStoreXS_2020.7.27.0_neutral__dspnxghe87tn0 {00000000-0000-0000-0000-000000000001} ``` この設定は PC には関係ありません (`wdapp setekbid` コマンドはありません)。 ### 体験版と EKBID **体験版** の場合、実際の EKBID を適用する必要があります。ゲームが使用する EKBID を見つけるには、Store からインストールされたビルドに対して `xbapp list /d` を実行します。詳細については、[ゲームの体験版の実装](/publishing/xstore-commerce/xstore-trials)を参照してください。 ## テスト アカウントがサンドボックスで製品への権利を持っていることを確認する サンドボックスと RETAIL の両方に公開された製品では、DevEntitlementTool を使用してテスト アカウントのエンタイトルメントを照会および取得できます。 エンタイトルメントを取得する最善の方法は、プロトコル アクティベーションを通じて製品の Store ページに直接移動することです。サンドボックスにのみ公開された製品は検索できない場合があるためです。開発コンソールまたは PC は、ゲームが公開されているサンドボックスに設定されている必要があります。詳細については、XBOX services Sandboxes overview のドキュメントを参照してください。PC については、[Store 操作のためにサンドボックスを適切に切り替える](/publishing/xstore-commerce/xstore-switching-sandbox)を参照してください。 適切にサインインしたら、Store プロトコル リンクを使用して Store ページに移動します。 **コンソールの場合:** Gaming Command prompt を使用: `xbapp launch ms-windows-store://pdp/?productid=` **PC の場合:** \[実行] ボックス (⊞Win +R) または Web ブラウザーで `msxbox://game/?productId=` (XBOX App で製品を表示する) または `ms-windows-store://pdp/?productid=` (Microsoft Store で製品を表示する) Store ページに移動したら、**\[購入]** または **\[入手]** を選択して、テスト アカウント用に製品のライセンスを取得します。ゲームと DLC のダウンロードとインストールは自動的に開始するはずです。ローカル ビルドで反復開発する予定の場合は、操作をキャンセルできます。 ビルドを実行し、ライセンス関連の XStore API が機能することを想定するすべてのアカウントについて、エンタイトルメントを取得する必要があります。 ## DLC ローカル DLC をライセンス供与可能にするには、コンテンツ ID を `makepkg` に適用し、`xbapp setekbid` を既定値以外に設定する必要があります。ライセンス供与用に構成する必要があるのは DLC のみで、ベース ゲームは必要ありません。 パッケージ化された耐久型を使用して呼び出す場合、ライセンス上書きは次の API に関連します。 * [XStoreAcquireLicenseForDurablesAsync](/reference/system/xstore/xstore_members) * [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForPackageAsync](/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForStoreIdAsync](/reference/system/xstore/xstore_members) * [XStoreRegisterPackageLicenseLost](/reference/system/xstore/xstore_members) 詳細については、以下を参照してください。 [ダウンロード可能なコンテンツ (DLC) の管理とライセンス供与](/publishing/xstore-commerce/xstore-dlc) [パッケージのない耐久型の使用方法](/publishing/xstore-commerce/xstore-dwob) ## リファレンス API ドキュメント * [XStore (API の内容)](/reference/system/xstore/xstore_members) * 関数 * [XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members) * [XStoreQueryLicenseTokenAsync](/reference/system/xstore/xstore_members) * [XStoreQueryAddOnLicensesAsync](/reference/system/xstore/xstore_members) * [XStoreRegisterGameLicenseChanged](/reference/system/xstore/xstore_members) * [XStoreAcquireLicenseForDurablesAsync](/reference/system/xstore/xstore_members) * [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForPackageAsync](/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForStoreIdAsync](/reference/system/xstore/xstore_members) * [XStoreRegisterPackageLicenseLost](/reference/system/xstore/xstore_members) ## 関連項目 [コマースの概要](/publishing/xstore-commerce/xstore-commerce-overview)
[XStore 開発とテストの有効化](/publishing/xstore-commerce/xstore-product-testing-setup)
[Store 操作のためにサンドボックスを適切に切り替える](/publishing/xstore-commerce/xstore-switching-sandbox)
[XStore API リファレンス](/reference/system/xstore/xstore_members) ## Related topics - [ダウンロード可能なコンテンツ (DLC) の管理とライセンス供与](/ja-jp/publishing/xstore-commerce/xstore-dlc.md) - [XStore 開発とテストの有効化](/ja-jp/publishing/xstore-commerce/xstore-product-testing-setup.md) - [ゲームの体験版の実装](/ja-jp/publishing/xstore-commerce/xstore-trials.md) - [プレイヤーにアドオン コンテンツへのアクセスを付与する](/ja-jp/publishing/xstore-commerce/xstore-granting-access.md) - [XStoreRegisterGameLicenseChanged](/ja-jp/reference/system/xstore/functions/xstoreregistergamelicensechanged.md)