サンドボックスのセットアップ

概要

このトピックでは、サンドボックスをセットアップし、XBOX services を使用するためにアプリケーションを構成するために必要な ID の取得方法について説明します。サンドボックスは個々の開発キットに対してコンテンツを分離し、開発とテストのためのクリーンな環境を提供します。 XBOX services はイベント、実績、マルチプレイヤー機能などのオンライン機能を提供します。サンドボックスを有効にして XBOX services を使用するには、開発キットとタイトルを構成するためにいくつかの ID を取得する必要があります。これらは同じ手順で行うことができます。手順は次のとおりです。

ID を取得します。
開発キットにサンドボックスを設定します。
TitleID と、必要に応じて他のオプション識別子をタイトルにバインドします。

重要な ID

XBOX One (以降) 向けのタイトルおよびアプリケーションの開発において重要な ID は 3 つあります: サンドボックス ID、TitleID、サービス構成識別子 (SCID) です。開発キットを使用するにはサンドボックス ID が必要ですが、初期開発では TitleID と SCID は必須ではないものの、XBOX services を使用する場合には必要になります。したがって、3 つすべてを同時に取得することを推奨します。

サンドボックス ID

サンドボックスは開発期間中、開発キットのためにコンテンツの分離を提供し、タイトルを開発およびテストするためのクリーンな環境を保証します。サンドボックス ID はサンドボックスを識別します。 1 つのコンソールは同時に 1 つのサンドボックスにしかアクセスできませんが、1 つのサンドボックスに複数のコンソールがアクセスすることは可能です。サンドボックス ID は大文字と小文字を区別します。

TitleID

TitleID は XBOX services に対してタイトルを一意に識別します。 TitleID はサービス全体で使用され、ユーザーがタイトルの XBOX コンテンツ、ユーザー統計、実績などにアクセスできるようにし、XBOX マルチプレイヤー機能を有効にします。 Title ID は使用方法や場所により、大文字と小文字を区別する場合があります。

サービス構成識別子 (SCID)

開発の一環として、イベント、実績、その他多くのオンライン機能を作成します。これらはすべてサービス構成の一部であり、アクセスするには SCID が必要です。以前のバージョンの XBOX OS とは異なり、Microsoft GDK Game OS 向けに開発されたタイトルには 1 つの SCID しか存在しないため、特定のサンドボックス内のタイトルのすべてのインスタンスは同じ構成を共有します。 Microsoft GDK Game OS の SCID は、常に TitleID と同じ値の GUID の先頭にゼロを付加したものです。 Microsoft Game Development Kit (GDK) タイトルから XBOX services とやり取りする大多数のケースでは、SCID を明示的に指定する必要はありませんが、XBOX services REST エンドポイントと直接やり取りする場合には必要な場合があります。 SCID は大文字と小文字を区別します。

ID の取得

現在のところ、開発者アカウントマネージャーと連携して ID を取得します。

サンドボックス ID を設定しないと開発キットを起動できません。これを行うには、GDK コマンドウィンドウを開き、次のように Configuration (xbconfig.exe) (NDA トピック) コマンドを使用します。

現在のサンドボックスを確認します。コマンドプロンプトで xbconfig sandboxid を入力します。
期待するものでない場合は、サンドボックス ID を変更します。コマンドプロンプトで xbconfig sandboxid=<your sandbox id> を入力します。
コマンドプロンプトで Reboot (xbreboot.exe) (NDA トピック) を使用してコンソールを再起動します。
サンドボックスが正しくリセットされたことを確認します。コマンドプロンプトで xbconfig sandboxid を入力します。

TitleID および他のオプション識別子をバイナリに追加する

サンドボックスは開発キットごとにプラットフォームレベルで構成されますが、TitleID は特定のバイナリにバインドされます。バイナリに TitleID を追加するには、そのバイナリの MicrosoftGame.config ファイルを変更し、<Game> ノードに次のように新しいノードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    ...
    <TitleId>yourTitleId</TitleId>
    <StoreId>yourStoreId</StoreId>
    <MSAAppId>yourMSAAppId</MSAAppId>
    ...
</Game>  

2022 年 3 月の Microsoft Game Development Kit (GDK) 以降、MicrosoftGame.config で MSAAppId と TitleId のいずれか一方が指定されている場合、両方が必要となります。詳細については、MicrosoftGame.config Element - MSAAppId および MicrosoftGame.config Element - TitleId を参照してください。

RequiresXboxLive フラグ

RequiresXboxLive フラグが true に設定されている場合、XBOX network へのアクティブな接続があり、かつタイトルが XBOX services での認証をクリアしない限り、タイトルは起動しません。これにより、タイトルが最新のコンテンツ更新を取得していることが保証されます。タイトルの実行中に接続が失われると、タイトルは一時停止され、その後終了されます。 “インターネット必須” のタイトルのみが RequiresXboxLive を true としてマークする必要があります。この方法でタイトルをマークしても、タイトルに必要なサービスが稼働していることは保証されないことに注意してください。 RequiresXboxLive も同様に MicrosoftGame.config ファイル内の Game の下のノードです。

XBOX Services