エンタイトルメント利用可能性を設定する
注釈:本資料はAI技術を用いて翻訳されています。
エンタイトルメント利用可能性設定機能を使用したい場合は、サポートチームにお問い合わせください。この機能を有効にし、詳細をご案内いたします。この機能を有効にすると、破壊的な変更が発生する可能性があります。
はじめに
AccelByte Gaming Services (AGS) に同期されたエンタイトルメントは、現在、どのサードパーティプラットフォームから来たかを指定していません。その結果、プレイヤーが1つのプラットフォームでエンタイトルメントを所有している場合、そのエンタイトルメントは他のすべてのサードパーティプラットフォームからもアクセスできることを意味します。
ただし、一部のサードパーティプラットフォームには、自社のプラットフォームまたは他のプラットフォームから取得したアイテムへの排他的アクセスに関する特定の制限があります。サードパーティプラットフォームでのこれらのエンタイトルメントの利用可能性を制限するために、2つの主要なコンポーネントを含むソリューションを開発しました。
エンタイトルメント用の新しい概念 - プラットフォームソースを作成しました。以下に完全なソースのリストがあります。
同時に、管理者が(各サードパーティプラットフォームに対して)この特定のプラットフォームでアクセスできるエンタイトルメントのプラットフォームソースを設定できるように、エンタイトルメント利用可能性設定ページを作成しました。
- すべての可能なプラットフォームソース:
- PlayStation
- Xbox
- Steam
- Epic
- Oculus
- Twitch
- Apple
- Android
- Nintendo
- Other
- これは、AGS決済サービスを使用した実通貨購入アイテム用です
- System
- これは、報酬、シーズンパス、注文VC購入、その他のVC購入から直接取得したエンタイトルメント用です
この記事では、AGS管理者ポータルまたはAGS CLIで以下を行う方法について説明します:
- エンタイトルメントのプラットフォームソースを見つける
- 各サードパーティプラットフォームのプラットフォームソースを設定する
この記事では、この機能を有効にすることによる潜在的な破壊的変更についても説明します
前提条件
- AGS管理者ポータルへのアクセス。
- 適切なネームスペースを作成済みであること。
- この機能は、IAMクライアントが指定されたプラットフォームで設定されている場合にのみ使用する必要があります。そうでない場合、プレイヤーがどのプラットフォームにいるかを判断できません。詳細については、IAMクライアントの作成と編集を参照してください。
- AGS CLIの手順に従うには、AGS CLIをインストールし、これらの機能にアクセスできるアカウントでサインインしている必要があります。インストールとサインインを参照してください。例ではBashシェルを使用します。

エンタイトルメント利用可能性設定機能を有効にする
この機能を有効にするには、サポートチームに連絡する必要があります。この機能を有効にし、詳細をご案内いたします。有効にすると破壊的な変更が発生する可能性があります。
- Admin Portal
- AGS CLI

ネームスペースでこの機能が有効かどうかを確認するには、次のコマンドを実行します。<YourNamespace> をご自身のネームスペースに置き換えてください。
ags platform entitlements get-config-info --namespace <YourNamespace>
出力で enableEntitlementOriginFeature が true の場合、この機能は有効です。
エンタイトルメントのプラットフォームソースを見つける
- Admin Portal
- AGS CLI
ユーザーエンタイトルメントを検索する際、オプションのフィルターとしてプラットフォームソースを指定することもできます。

検索結果では、新しい列でエンタイトルメントのプラットフォームソースを確認できます。

1つのプラットフォームソースからプレイヤーのエンタイトルメントを一覧表示するには、次のコマンドを実行します。<YourNamespace> をご自身のネームスペースに、<UserId> をプレイヤーのユーザーIDに、<PlatformSource> を Steam や System などのプラットフォームソースに置き換えてください。PlayStationの値は Playstation、Appleは IOS、Androidは GooglePlay です。すべてのソースのエンタイトルメントを一覧表示するには、--origin を省略します。
ags platform entitlements list --namespace <YourNamespace> --user-id <UserId> --origin <PlatformSource>
出力内の各エンタイトルメントのプラットフォームソースは、origin フィールドに含まれています。
エンタイトルメント利用可能性の設定
- Admin Portal
- AGS CLI
-
デフォルトでは、この機能が有効になると、各サードパーティプラットフォームに対して、プラットフォーム自体がリストに追加され、プラットフォーム自体からのすべてのエンタイトルメントにプレイヤーがアクセスできるようになります。Systemもデフォルトソースとして追加されます。これらのデフォルトソースは削除できません。その結果、プラットフォームソースがSystemとマークされているすべてのエンタイトルメントは、すべてのプラットフォームからアクセスできることを意味します。

-
Otherは、他のすべてのプラットフォーム(上記にリストされていない)を指し、デフォルトですべてのプラットフォームソースを含むように設定されています。
注記シーズンパスはプラットフォーム固有ではないため、プレイヤーが1つのプラットフォームで購入して再度購入しても、1回しか取得できません。そのため、異なるプラットフォーム用に異なるパスコードを作成し、異なる報酬を追加することをお勧めします。これがユニークなアイテムになる場合は、各プラットフォーム用に1つのパスコードを作成する必要があります。
-
選択したプラットフォームに新しいソースを追加するには、「Add」ボタンをクリックします。追加するソースを選択するよう求めるポップアップウィンドウが表示されます。新しいソースが追加されると、成功メッセージが表示されます。

-
プラットフォームの現在の設定を取得します。
<YourNamespace>をご自身のネームスペースに、<Platform>をこれらの手順の最後にある表のプラットフォームの値に置き換えてください。その他のすべてのプラットフォームにはOtherを使用します。ags platform entitlements get-config --namespace <YourNamespace> --platform <Platform>出力の
allowedPlatformOriginsフィールドには、このプラットフォーム上のプレイヤーがアクセスできるプラットフォームソースが一覧表示されます。 -
現在の
allowedPlatformOriginsのリストに、追加したいプラットフォームソースを加えたentitlement-config.jsonという名前のファイルを作成します。たとえば、SteamのプレイヤーがEpicのエンタイトルメントにもアクセスできるようにするには、次のようにします。{
"allowedPlatformOrigins": ["Steam", "System", "Epic"]
}警告このリストは現在の設定を置き換えるため、新しいソースだけでなく、保持したいすべてのソースを含めてください。リストに含めなかったソースは削除されます。リストにはプラットフォーム自体と
Systemを含める必要があります。含まれていない場合、リクエストは失敗します。 -
設定を更新します。
ags platform entitlements update-config --namespace <YourNamespace> --platform <Platform> --json @entitlement-config.json
AGS CLIでは、プラットフォームとプラットフォームソースに次の値を使用します。
| プラットフォームソース | 値 |
|---|---|
| PlayStation | Playstation |
| Xbox | Xbox |
| Steam | Steam |
| Epic | Epic |
| Oculus | Oculus |
| Twitch | Twitch |
| Apple | IOS |
| Android | GooglePlay |
| Nintendo | Nintendo |
| Other | Other |
| System | System |
Twitch と System はプラットフォームソースのみです。これらをプラットフォームとして利用可能性を設定することはできません。
潜在的な破壊的変更
この機能を有効にすることを決定した場合、いくつかの主要な潜在的な破壊的変更があります。
-
以前は、プレイヤーはエンタイトルメントがどこから来たかに関係なく、すべてのサードパーティプラットフォームですべてのエンタイトルメントにアクセスできました。この機能を有効にすると、プレイヤーのエンタイトルメントへのアクセスは、エンタイトルメント利用可能性設定に基づいて決定されるため、プレイヤーが一部のプラットフォームで一部のエンタイトルメントへのアクセスを失う可能性があります。
-
消耗品エンタイトルメントの場合、以前はすべての消耗品エンタイトルメントがアイテムに基づいて互いにスタックされていました。この機能を有効にすると、消耗品エンタイトルメントはソースとアイテムによってスタックされます。IAP/DLCから同期されたすべてのアイテムは、プラットフォームソースにスタックされます。
IAMクライアントに指定されたプラットフォームが設定されていない場合、デフォルトですべてのエンタイトルメントを返すため、エンタイトルメント利用可能性の設定は意味がありません。
IAMクライアントにプラットフォームを設定している場合は、正しいプラットフォームで設定されているかどうかを確認してください。たとえば、PSN IAMクライアントはプラットフォームPSNで設定する必要があります。指定されたプラットフォームをすでに設定している場合は、ゲームロジックに影響があるかどうかを確認する必要があります。