ロビーの招待 - XBOX Game Development Documentation

この記事では、ロビーの招待の概要と、Lobby and Matchmaking SDK での使い方について説明します。

プレイヤー (すなわち title_player_account PlayFab エンティティ) のみが招待を送受信できます。ゲームサーバー (すなわち game_server PlayFab エンティティ) はできません。ゲームサーバーがロビーとどのようにやり取りするかの詳細については、ゲームサーバーとロビーを参照してください。

招待の種類

ゲームで利用する可能性が高い招待には 2 種類あります。

ゲーム内招待
プラットフォーム招待

ゲーム内招待によるロビーへの参加

ロビーのメンバーは、ロビーサービスを介して直接、他のプレイヤーをそのロビーに招待できます。
ロビーオーナーは、ロビープロパティ RestrictInvitesToLobbyOwner を介して、招待の送信をオーナーのみに制限することを選択できます。
この招待は、ロビーの接続文字列を招待されたプレイヤーと共有します。
招待されたプレイヤーは PFLobbyInviteReceivedStateChange を通じて招待を受け取り、添付された接続文字列を使用してロビーに参加できます。
これらの招待はクロスプラットフォームで機能しますが、ゲーム内でのみ動作します。

プラットフォーム招待によるロビーへの参加

ロビーのメンバーは、プラットフォーム固有の招待メカニズムを介して、ロビーの接続文字列を他のプレイヤーに直接共有できます。
これらの招待はクロスプラットフォームでは機能しませんが、受信者がゲームを既に実行していなくても受信できます。
招待されたプレイヤーがプラットフォームメカニズム経由で接続文字列を受け取ると、添付された接続文字列を使用してロビーに参加できます。

Lobby and Matchmaking SDK を使用した招待の送受信例

招待の受信者側でゲーム内招待の受信を有効にするには PFMultiplayerStartListeningForLobbyInvites を使用します。招待リスナーは正常にセットアップされると、そのステータスが Listening に変わります。

HRESULT AllowInvitations(
    const PFEntityKey* entity)
{
    return PFMultiplayerStartListeningForLobbyInvites(g_pfmHandle, entity);
}

void HandleInvitationListenerStatusChange(
    const PFLobbyInvitationListenerStatusChangedStateChange& invitationListenerStateChange)
{
    PFLobbyInvitationListenerStatus status;
    HRESULT hr = PFMultiplayerGetLobbyInvitationListenerStatus(
        g_pfmHandle,
        &invitationListenerStateChange.listeningEntity,
        &status);
    assert(SUCCEEDED(hr));

    switch (status)
    {
        case PFLobbyInvitationListenerStatus::Listening:
        {
            Log("%s is listening for invitations", invitationListenerStateChange.listeningEntity.id);
            break;
        }
        case PFLobbyInvitationListenerStatus::NotAuthorized:
        {
            Log("Invitation listener not authorized!"); // this is likely an issue with the listener's entity token.
            break;
        }
        default:
    }
}

ロビーサービスを介して別の PlayFab ユーザーに招待を送信するには PFLobbySendInvite を使用します。受信者は PFLobbyInviteReceivedStateChange を受け取ります。

HRESULT SendInvite(PFLobbyHandle lobby, const PFEntityKey* sender, const PFEntityKey* receiver)
{
    return PFLobbySendInvite(lobby, sender, receiver, nullptr);
}

void HandleInvitationNotification(const PFLobbyInviteReceivedStateChange& invite)
{
    Log("%s invited to lobby by %s", invite.listeningEntity.id, invite.invitingEntity.id);
    // pass invite.connectionString to PFMultiplayerJoinLobby
}

関連項目

最終更新日 2026年8月13日

関連トピック

ロビーへの参加 Lobby と Matchmaking を組み合わせて使用する PFLobbySendInvite PlayFab Multiplayer C++ SDK リリースノートロビーの作成

⌘I