Skip to main content
このガイドでは、統合 SDK を使用して、音声、チャット、およびデータネットワーキング向けの PlayFab Party と、ロビーおよびマッチメイキングサービス向けの PlayFab Multiplayer を統合する方法を説明します。

前提条件

開始する前に、以下を確認してください:
  • コア SDK のセットアップと認証を完了済みであること
  • ログインプロセスから取得した認証済みの PFEntityHandle
  • Game Manager で構成された PlayFab タイトル ID
  • 非同期プログラミングパターンの基本的な理解
このガイドでは、コアクイックスタートガイドに従って、既に PlayFab SDK を初期化し、プレイヤーを認証していることを前提としています。まだの場合は、まずそのガイドを完了してください。

達成すること

このクイックスタートの終わりまでに、以下を達成します:
  • ネットワーキングとチャット用に PlayFab Party を初期化する
  • ローカルユーザーとチャットコントロールを作成する
  • 通信用の Party ネットワークをセットアップする
  • PlayFab Multiplayer を初期化してロビーを作成する
  • Party と Multiplayer リソースのクリーンアップ手順を理解する

ヘッダーとインクルード

必須ヘッダー

PlayFab Party および Multiplayer 機能にアクセスするために、ヘッダーファイルに SDK ヘッダーをインクルードします:

実装ファイル

実装ファイルに PartyImpl.h をインクルードし、Party 名前空間を使用します:

ステップ 1: PlayFab Party を初期化する

PartyManager のシングルトンリファレンスを作成し、タイトル ID と、高度なスレッド制御のためのオプションのタスクキューで構成することで、PlayFab Party を初期化します。
audioTaskQueue および networkingTaskQueue パラメーターを使用すると、スレッド処理をきめ細かく制御するためのカスタム XTaskQueue インスタンスを指定できます。デフォルトのスレッド動作を使用するには、これらを nullptr に設定します。

ステップ 2: ローカルユーザーを作成する

このデバイス上で認証されたプレイヤーを表すローカルユーザーオブジェクトを作成します。このユーザーは、すべてのネットワーキングおよびチャット操作に必要です。

ステップ 3: チャットコントロールを作成する

このデバイス上のユーザーの音声およびテキストチャット操作を管理するためのチャットコントロールを作成します。
チャットコントロールは、オーディオ入出力を処理し、音声通信機能を有効にします。

ステップ 4: Party ネットワークを作成する

Party ネットワーク (チャットとデータを交換できるデバイスとユーザーの安全なコレクション) を作成します。Party ネットワークは通常、ゲームのマルチプレイヤーセッションまたはロビーの概念に対応します。
PartyInvitationConfiguration に、有効で一意のネットワーク識別子 (GUID) を必ず指定してください。この ID は、他のプレイヤーがあなたのネットワークに参加するために使用します。
🎉 おめでとうございます! PlayFab Party のネットワーキングとチャットのセットアップに成功しました。

ステップ 5: PlayFab Multiplayer を初期化する

ロビーとマッチメイキング機能を有効にするために、PlayFab Multiplayer サービスを初期化します。

ステップ 6: ロビーを作成する

マッチ開始前にプレイヤーグループを管理するためのロビーを作成します。ロビーはオーナー移行やアクセス制御などの機能をサポートします。
🎉 素晴らしい! Party ネットワーキングと Multiplayer ロビーサービスの両方をセットアップしました。

リソースのクリーンアップ

ゲームがシャットダウンする際や PlayFab リソースをクリーンアップする必要がある場合は、正しい順序で適切にクリーンアップを行ってください:
リソースは必ず次の順序でクリーンアップしてください: Party、Multiplayer、エンティティハンドル、サービス構成、そして PlayFab Services。

次のステップ

Party と Multiplayer のセットアップが完了したので、次はこれらの追加機能を探索しましょう:

Party ネットワーキング機能

  • 音声チャット - Azure Cognitive Services 統合によるリアルタイム音声通信を有効にする
  • テキストチャット - 翻訳とモデレーションを備えたテキストメッセージングを実装する
  • データチャネル - プレイヤー間でカスタムゲームデータを送信する
  • ネットワーク管理 - プレイヤーの接続、切断、ネットワークイベントを処理する

Multiplayer ロビー機能

  • マッチメイキング統合 - ロビーを PlayFab マッチメイキングに接続する
  • ロビープロパティ - ゲーム設定とメタデータを保存および同期する
  • メンバーデータ - ロビー内でプレイヤー固有の情報を共有する
  • 検索と発見 - パブリックロビーを見つけて参加する

コアコンセプト

リファレンスドキュメント

最終更新日 2026年8月25日