Multiplayer Session Directory の概要

• MPSD セッション
• MPSD 変更通知の処理と切断検出
• セッションへの MPSD ハンドル
• セッション更新の同期
• MPSD の呼び出し
• Multiplayer Session Explorer

​

MPSD セッション

• タイトルによって作成および管理されます。
• 一意の URI を持ちます。詳細については、Session Directory URIs を参照してください。
• セッションメンバーと呼ばれるユーザー間の接続を可能にします。
• メンバーごとの属性、ゲーム設定、ブートストラップ情報、ゲームサーバー情報など、ゲームプレイを可能にするデータを格納します。

​

MPSD 変更通知の処理と切断検出

• タイトルが開始したイベント購読に基づいて、セッション変更が発生したときに簡潔な通知 (ショルダータップ) を送信する。
• ユーザーの切断を検出する。
• 切断検出に基づいて、ユーザーを非アクティブに設定してからセッションから削除する。

​

ユーザー接続を確立する

1. タイトルは XblMultiplayerSetSubscriptionsEnabled を呼び出します。このメソッドは、クライアントがマルチプレイヤー目的で RTA 接続を使用する意図があることを XSAPI に伝えます。
2. タイトルが現在のユーザーを Active 状態に設定して XblMultiplayerWriteSessionAsync または XblMultiplayerWriteSessionByHandleAsync を最初に呼び出すと、接続が作成され MPSD に接続されます。

​

セッション変更を購読する

​

ショルダータップを処理する

​

接続状態変更の通知を処理する

• XblMultiplayerSessionSubscriptionLostHandler ハンドラー - タイトルの RTA サービスを使用した MPSD への接続が失われたときに発生します。このイベントが発生したときは、タイトルはマルチプレイヤーをシャットダウンする必要があります。
• XblRealTimeActivityConnectionStateChangeHandler ハンドラー - タイトルの RTA サービスへの接続の健全性の一時的な変化時に発生します。このイベントを受信してもタイトルは何もアクションを取る必要はありませんが、イベントは診断目的で有用な場合があります。

​

クライアントを切断する

​

切断検出

​

RTA 再接続を処理する

void* context{ nullptr };
XblFunctionContext connectionIdChangedFunctionContext = XblMultiplayerAddConnectionIdChangedHandler(
    xblContextHandle,
    [](void* context) {
        XblMultiplayerSessionHandle sessionHandle; // Retrieve the MPSD session to update
        XblMultiplayerSessionCurrentUserSetStatus(sessionHandle, XblMultiplayerSessionMemberStatus::Active);

        auto asyncBlock = std::make_unique<XAsyncBlock>();
        asyncBlock->queue = queue;
        asyncBlock->context = nullptr;
        asyncBlock->callback = [](XAsyncBlock* asyncBlock)
        {
            std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };

            XblMultiplayerSessionHandle sessionHandle;
            HRESULT hr = XblMultiplayerWriteSessionResult(asyncBlock, &sessionHandle);
            if (SUCCEEDED(hr))
            {
                // If the write call succeeds, the connection ID has been updated and no further action is needed.
            }
            else
            {
                // If the write call fails, it's likely that the user has been removed from the session.
            }
        };

        auto hr = XblMultiplayerWriteSessionAsync(xblContextHandle, sessionHandle, XblMultiplayerSessionWriteMode::UpdateExisting, asyncBlock.get());
        if (SUCCEEDED(hr))
        {
            asyncBlock.release();
        }
    }, 
    context);

​

セッションへの MPSD ハンドル

​

ハンドルタイプ

​

招待ハンドル

​

招待ハンドルを作成する

​

アクティビティハンドルを作成する

​

ハンドルを使用する

1. タイトルアクティベーションパラメーターからハンドル ID を取得します。
2. ローカル MPSD セッションオブジェクトを作成し、アクティブとして参加します。
3. 適切なハンドルを渡して、セッションを書き込みます。

​

セッション更新の同期

• arbiter がセッションの共有部分を更新します。実装に単一の arbiter が含まれる場合、ほとんどの書き込み操作で同期された更新の使用を避けることができます。タイトルは次のケースで同期を回避できます。
  • arbiter の ID の通信に関連しない限り、arbiter がセッションの共有部分に対して行うすべての更新
  • タイトルがセッション内のメンバーエリアに対して行うすべての更新

  [!NOTE] 前述の更新タイプは同期を必要としませんが、XblMultiplayerSessionProperties::HostDeviceToken プロパティへの更新は同期することが依然として重要です。 このプロパティは、arbiter の移行の一部として arbiter の ID を通信するために使用されます。

• すべてのクライアントがセッションの共有部分を更新します。この場合、セッションの共有部分へのすべての更新を同期する必要があります。ただし、タイトルは同期なしで自分自身のメンバーエリアに書き込むことができます。

​

Multiplayer API を使用したセッション同期の更新

• XblMultiplayerWriteSessionAsync
• XblMultiplayerWriteSessionByHandleAsync

​

Multiplayer REST API を使用したセッション同期の更新

​

MPSD の呼び出し

• RESTful 機能のラッパーとして機能するクラスを含むマルチプレイヤー API を使用することをお勧めします。詳細については、XblMultiplayer プレフィックス関数を参照してください。SmartMatch マッチメーキングには、XblMatchmaking プレフィックス関数によって表されるマッチメーキング API を使用します。
• XBOX services RESTful リファレンス に含まれるマルチプレイヤーとマッチメーキングの REST API への直接的な標準 HTTP 呼び出しを使用します。適用可能な URI は、Session Directory URIs (マルチプレイヤー用) および Matchmaking URIs (マッチメーキング用) セクションに記載されています。関連する JSON オブジェクトは、JavaScript Object Notation (JSON) オブジェクトリファレンスセクションに記載されています。

​

Multiplayer API を使用して MPSD を呼び出す

​

Multiplayer REST API を使用して MPSD と対話する

​

セッションとセッションテンプレートのクエリ (REST)

​

基本的なセッション情報のクエリ

​

セッションテンプレートのクエリ

• /serviceconfigs//sessiontemplates
• /serviceconfigs//sessiontemplates/

​

セッション状態のクエリ

• /serviceconfigs//sessions
• /serviceconfigs//sessiontemplates//sessions

​

Multiplayer Session Explorer

​

Multiplayer Session Explorer にアクセスする

​

メインページを開く

1. ツールのメインページを開きます。セキュリティコンテキスト (サインインしているユーザーとサンドボックス) およびサンドボックス内の SCID のリストが表示されます。
2. Menu ボタンを押してこのページをホームに固定すると、URI を再入力する必要がなくなります。

​

利用可能なセッションとテンプレートを表示する

1. ツールで SCID を選択して、その SCID 内のサインインユーザーがメンバーとして含まれているセッションのリストを表示します。
2. 同じページで、SCID を選択して、SCID のサービス構成内のセッションテンプレートおよびローカライゼーション文字列を表示できます。これらの項目は Partner Center 経由で取り込まれます。

​

セッションの全内容を表示する

• GET 呼び出しが X-Xbl-Contract-Version ヘッダーで古いコントラクトバージョンを使用している可能性があります。Multiplayer Session Explorer は常に最新のコントラクトバージョンを使用してセッションを表示します。
• セッションが GET 経由で通常通り要求されると、期限切れタイムアウトなどの変換と副作用がトリガーされる可能性があります。Multiplayer Session Explorer は、ロジック、変換、または副作用を実行することなく、セッションが保存されているスナップショットを表示します。
• nextTimer JSON オブジェクトフィールドは、副作用と同時に計算されるため、MPSD セッションには存在しません。

​

参照

• Multiplayer Session advanced topics トピックの Session overview セクション
• マルチプレイヤーセッションのステータスコード
• Multiplayer tasks トピックの MPSD セッションを更新する セクション
• Multiplayer tasks トピックの タイトルアクティベーションから MPSD セッションに参加する セクション
• Multiplayer tasks トピックの MPSD セッション変更通知の購読 セクション
• マッチメーキングの概要