- ゲーム内で誰がアクションを行ったのか?
- 誰が実績を獲得するのか?
- 誰が購入を行っているのか?
XBOX One ERA と Microsoft Game Development Kit (GDK) のユーザー モデルの違い
新しい Microsoft Game Development Kit (GDK) タイトルを開発する場合でも、以前のタイトルを XBOX One ERA から移植する場合でも、XBOX One ERA のユーザー モデルに慣れていると、ユーザーと入力デバイスの管理の実装は混乱することがあります。- ゲームのセーブや実績が必要な場合など、ユーザーが必要なタイトルは、プライマリ ユーザーを確立する必要があります。このプライマリ ユーザーはタイトル専用の構成要素で、システムから提供されるものではありません。
- タイトルは XUserAddAsync の呼び出しを介して追加されたユーザーについてのみ知っています。タイトルは、追加していないユーザーに対してシステムが行ったアクションについて通知されません。
- 以前にタイトル ユーザーに関連付けられていたデバイスが、タイトルが認識していないユーザーに関連付けられた場合、タイトルには新しいユーザーなしにデバイス関連付けイベントのみが通知されます。
- タイトル ユーザーに関連付けられていなかったデバイスが、XUserAddAsync で追加されていない別のユーザーに関連付けられた場合、タイトルには関連付けイベントは通知されません。
- Account Picker は、どのように呼び出されたか (System Guide vs XUserAddAsync) に基づいて異なる動作をします。
UserManagement サンプルは、さまざまなゲーム状況におけるユーザー管理と入力デバイスのペアリング動作を扱います。また、ユーザーと入力デバイスに関する XR 要件も扱います。サンプルの詳細については、Microsoft Game Development Kit サンプル を参照してください。
指定したユーザーを識別する方法
ゲームは入力デバイスと対話するために ローカル ID を使用します。ローカル ID は、ゲーム セッション内のユーザーの生存期間中、そのユーザーと共に留まる識別子です。ローカル ID は、ゲームが生成する任意のプロセス、またはゲームが XLaunchNewGame を呼び出す場合に使用できます。ゲーム セッションをまたいでユーザーを識別するためにローカル ID を使用しないでください。 ユーザーのローカル ID を取得するには、XUserGetLocalId 関数を使用します。特定の入力デバイスを識別する方法
ゲームパッド、アーケード スティック、ホイールなどのゲーミング デバイスはすべて、APP_LOCAL_DEVICE_ID 構造体によって表される一意の デバイス ID を持ちます。このデバイス ID は、ゲームの複数回の起動やシステムの再起動をまたいで持続します。デバイス ID は、同じシステム上で実行される 2 つの異なるゲームの間で異なります。 コンソールでXInput を使用している場合、XInputGetDeviceId を使用してデバイス ID を取得できます。
GameInput を使用している場合、IGameInputDevice::GetDeviceInfo の呼び出しから返される GameInputDeviceInfo オブジェクトの deviceId メンバーからデバイス ID を取得できます。
ユーザー モデル
タイトルにユーザーが必要な場合 (たとえばゲームのセーブや実績が必要な場合)、タイトルはプライマリ ユーザーの確立に完全に責任があります。このプライマリ ユーザーは、複数のユーザーがサインインできる場合でも維持される必要があります。また、タイトルは必要に応じてプライマリ ユーザーを変更できるようにする必要があります。そうする方法は、XUserAddAsync で Account Picker を呼び出す ユーザー切り替え プロンプトを持つことです。 Account Picker は、以前にコンソールにサインインしたすべてのユーザーをリストし、新しいアカウントにサインインするための Add new ボタンを持ち、一時的なゲスト ユーザーのサインインを可能にします。これらのユーザー アカウントは、ユーザーの真の身元に関係なく選択できます。システムは、この方法で他人としてプレイすることを選ぶユーザーをサポートします。 Microsoft Game Development Kit (GDK) タイトルは、システム上のユーザーについての完全な知識を持ちません。代わりに、ユーザーは XUserAddAsync の呼び出しを介してのみタイトルに追加できます。この方法で追加されたユーザーが、タイトルが対話できる唯一のユーザーです。システムは、タイトルが追加していないユーザーに対して行われたアクションについてタイトルに通知しません。その結果、タイトルは独自のユーザー リストを保持する必要があります。 Account Picker は、System Guide からと XUserAddAsync 経由の 2 つの方法で表示できます。このピッカーはこの 2 つの状況で異なる動作をします。タイトルにサインインしているユーザーの集合は、常にシステムにサインインしているユーザーのサブセットです。タイトルには、システムがサインインしていないユーザーはサインインできません。ただし、システムには、タイトルが知らないユーザーが存在する可能性があります。
入力デバイスの関連付け
Microsoft Game Development Kit (GDK) では、ユーザーに任意の数の入力デバイスを関連付けることができます。ユーザーとデバイスの間の 1 対 1 のマッピングを想定した古いタイトルを移植する場合、これは困難なことがあります。 デバイスの関連付けは通常、Account Picker を介して行われます。UI からユーザーを選択した入力デバイスが、そのユーザーに関連付けられるようになります。関連付けは他のケースからも変わることがあります。たとえば、ユーザーがサインアウトされたときや、AddDefaultUserSilently および AddDefaultUserAllowingUI オプションを使用して UI なしで XUserAddAsync が使用されるときなどです。 Account Picker も、ピッカーがどのように表示されたかに基づいて関連付けに関して異なる動作をします。
Account Picker なしに、AddDefaultUserSilently または AddDefaultUserAllowingUI オプションのいずれかを利用する XUserAddAsync の呼び出しによって、タイトルにユーザーが自動的にサインインされた場合、システムが持っていた入力デバイスのペアリングがタイトルに伝達されます。
ユーザー デバイスの関連付け変更の通知を受け取るには、XUserRegisterForDeviceAssociationChanged メソッドを使用して XUserDeviceAssociationChangedCallback コールバックを登録できます。特定のデバイスの関連付けを検索するために XUserFindForDevice を呼び出すこともできます。
タイトルは XUserAddAsync で追加されたユーザーについてのみ知ることができるため、ユーザー デバイスの関連付けのコールバックとメソッドは、タイトルが以前に追加したユーザーのみを返せます。
既定のオーディオ エンドポイントとユーザーのマッチング
ヘッドセットやマイクは、ゲームと共に頻繁に提供されます。次のような重要な質問があります。- ユーザーはヘッドセットを持っていますか? 持っている場合、どのヘッドセットを使用している可能性が高いですか? 既定の通信レンダリング オーディオ エンドポイントは何ですか?
- ユーザーには関連付けられたマイクがありますか? 既定の通信キャプチャ エンドポイントは何ですか?