前提条件
開始する前に、以下を確認してください:- コア 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 を初期化します。
ステップ 2: ローカルユーザーを作成する
このデバイス上で認証されたプレイヤーを表すローカルユーザーオブジェクトを作成します。このユーザーは、すべてのネットワーキングおよびチャット操作に必要です。ステップ 3: チャットコントロールを作成する
このデバイス上のユーザーの音声およびテキストチャット操作を管理するためのチャットコントロールを作成します。ステップ 4: Party ネットワークを作成する
Party ネットワーク (チャットとデータを交換できるデバイスとユーザーの安全なコレクション) を作成します。Party ネットワークは通常、ゲームのマルチプレイヤーセッションまたはロビーの概念に対応します。PartyInvitationConfiguration に、有効で一意のネットワーク識別子 (GUID) を必ず指定してください。この ID は、他のプレイヤーがあなたのネットワークに参加するために使用します。ステップ 5: PlayFab Multiplayer を初期化する
ロビーとマッチメイキング機能を有効にするために、PlayFab Multiplayer サービスを初期化します。ステップ 6: ロビーを作成する
マッチ開始前にプレイヤーグループを管理するためのロビーを作成します。ロビーはオーナー移行やアクセス制御などの機能をサポートします。リソースのクリーンアップ
ゲームがシャットダウンする際や PlayFab リソースをクリーンアップする必要がある場合は、正しい順序で適切にクリーンアップを行ってください:リソースは必ず次の順序でクリーンアップしてください: Party、Multiplayer、エンティティハンドル、サービス構成、そして PlayFab Services。
次のステップ
Party と Multiplayer のセットアップが完了したので、次はこれらの追加機能を探索しましょう:Party ネットワーキング機能
- 音声チャット - Azure Cognitive Services 統合によるリアルタイム音声通信を有効にする
- テキストチャット - 翻訳とモデレーションを備えたテキストメッセージングを実装する
- データチャネル - プレイヤー間でカスタムゲームデータを送信する
- ネットワーク管理 - プレイヤーの接続、切断、ネットワークイベントを処理する
Multiplayer ロビー機能
- マッチメイキング統合 - ロビーを PlayFab マッチメイキングに接続する
- ロビープロパティ - ゲーム設定とメタデータを保存および同期する
- メンバーデータ - ロビー内でプレイヤー固有の情報を共有する
- 検索と発見 - パブリックロビーを見つけて参加する
