Multiplayer Manager の概要

​

主な機能

• 簡単なセッション管理と XBOX services マッチメイキング
• 状態ベースおよびイベントベースのプログラミング モデル
• Multiplayer XR に準拠すると同時に XBOX services のベスト プラクティスを保証
• 2015 マルチプレイヤー フローチャートを実装

• 大規模な MPSD セッション (100 メンバーを超える) はサポートされていません。
• ピア ホスト型マルチプレイヤー設計のみを対象としています。専用サーバーを持つタイトルは、代わりに Multiplayer Activity Service または Multiplayer Service API と サービス間呼び出し (NDA トピック) を使用してください。

​

概要

• ロビー セッション: デバイスに対してローカルなユーザーと、一緒にプレイしたい招待されたフレンドを管理するために使用される永続的なセッション。 グループはゲーム (たとえば、複数のラウンド、マップ、レベル) をプレイできます。ロビー セッションは、この中心的なフレンドのグループ (デバイスに対してローカルなプレイヤーを含む) を追跡します。 通常、このグループは、ホストがメニューをナビゲートしたり、グループ メンバーとチャットしてどのゲーム モードをプレイするかを決めているときに形成されます。
• ゲーム セッション: ゲームの特定のインスタンスをプレイしているプレイヤーを追跡します。 たとえば、レース、マップ、またはレベルです。 ロビー セッションのメンバーを含む新しいゲーム セッションを、XblMultiplayerManagerJoinGameFromLobby を介して作成できます。 メンバーが招待を承諾すると、そのメンバーはロビーおよびゲーム セッション (空きがある場合) に追加されます。 マッチメイキングが有効な場合はゲーム セッションに追加のプレイヤーを追加できますが、それらの追加プレイヤーはロビー セッションには追加されません。 これは、ゲームが終了するとロビー セッションのプレイヤーは一緒にいるが、マッチメイキングからの追加のプレイヤーはそうではないことを意味します。
• XblMultiplayerManagerMember: ローカルまたはリモート デバイスにサインインしている個々のユーザーを表します。
• XblMultiplayerManagerDoWork: タイトルと XBOX services Multiplayer サービスの間で適切なゲーム状態の更新が維持されるようにします。 最高のパフォーマンスを確保するため、XblMultiplayerManagerDoWork はフレームごとに 1 回など、頻繁に呼び出す必要があります。 XblMultiplayerManagerDoWork は、ゲームが処理するための XblMultiplayerEvent コールバック イベントの配列を提供します。

​

ステート マシン

​

スレッド処理

​

状態ベースのモデル更新

​

イベントと通知

​

フラット C API

size_t eventCount{ 0 };
const XblMultiplayerEvent* events{ nullptr };
HRESULT hr = XblMultiplayerManagerDoWork(&events, &eventCount);
if (FAILED(hr))
{
    // Handle failure.
}

for (auto i = 0u; i < eventCount; ++i)
{
    switch (events[i].EventType)
    {
        case XblMultiplayerEventType::MemberJoined:
        {
            // Handle MemberJoined.
            size_t memberCount = 0;
            hr = XblMultiplayerEventArgsMembersCount(events[i].EventArgsHandle, &memberCount);
            assert(SUCCEEDED(hr));

            std::vector<XblMultiplayerManagerMember> members(memberCount);
            hr = XblMultiplayerEventArgsMembers(events[i].EventArgsHandle, memberCount, members.data());
            assert(SUCCEEDED(hr));
            ...

            break;
        }

        case XblMultiplayerEventType::SessionPropertyChanged:
        {
            // Handle SessionPropertyChanged.
            const char* changedProperty{ nullptr };
            hr = XblMultiplayerEventArgsPropertiesJson(events[i].EventArgsHandle, &changedProperty);
            assert(SUCCEEDED(hr));
            ...

            break;
        }
        ...
    }
}

• XblMultiplayerEvent
• XblMultiplayerEventArgsMembers
• XblMultiplayerEventArgsMembersCount
• XblMultiplayerEventArgsPropertiesJson
• XblMultiplayerEventType
• XblMultiplayerManagerDoWork
• XblMultiplayerManagerMember

​

シナリオ

• Multiplayer Manager を使用してフレンドとマルチプレイヤー ゲームをプレイできるようにする
• Multiplayer Manager を使用して SmartMatch でマルチプレイヤー ゲームを見つける
• Multiplayer Manager を使用してゲーム招待を送信する
• Multiplayer Manager を使用してゲームを開始するためのプロトコル アクティベーションの処理

​

Multiplayer Manager が行わないこと

• MMORPG (大規模多人数同時参加型オンライン ゲーム) のような永続的なオンライン サーバー ゲーム、または大規模なセッション (1 セッションに 100 プレイヤーを超える) を必要とするその他のゲーム タイプ
• サーバー間のセッション管理
• きめ細かなレート制限 に準拠するための MPSD 呼び出しのスロットリング
• Multiplayer service API と Multiplayer Manager API の混在

​

リソース