PlayDrop ゲームのオンラインパーティーとボイスチャット

• リアルタイムゲームサーバー：パーティーはあなたの Colyseus のルームで遊びます。
• サインイン中のプレイヤー：ルームはゲストを受け付けません。
• catalogue.json での次の宣言：

{
  "types": ["solo", "online", "party"],
  "party": { "online": [2, 3, 4] },
  "roomVoice": true,
  "server": { "entry": "server/index.mjs", "rooms": ["game"] }
}

party.online には、一緒に参加できるグループの正確な人数（最大4人）を列挙します。[2, 4] なら3人は対象外です。これは参加するグループの人数で、ルームの定員ではありません。4人のパーティー2組が8席のルームを共有することもできます。party には party タイプが、party.online には online が必要です。roomVoice: true でルーム音声が有効になり、これにも online が必要です。

if (!sdk.me.isLoggedIn) {
  await sdk.me.promptLogin();
}
const room = await sdk.multiplayer.join("game", { mode: "versus" });

join は、PlayDrop がパーティーとして起動した場合はプレイヤーの予約済みの席を使い、そうでない場合は単独で参加します。パーティーの参加に失敗した場合は拒否され、プレイヤーを黙って別のルームに入れることは決してありません。ゲストには authentication_required が返り、PlayDrop がサインイン画面を表示します。sdk.me.onAuthChange からもう一度参加してください。ラウンドをまたいで同じルームを使い続けましょう。

再読み込みのあとは、sdk.multiplayer.reconnect(roomName, token) で予約済みの席を復元できます。トークンは、このゲーム、バージョン、ユーザー専用に非公開で保存しておいた再接続トークンです。multiplayer_reconnect_expired、multiplayer_reconnect_unavailable、party_reconnect_mismatch が返ったら、トークンを破棄して join を呼び出してください。

ボタンから sdk.social.openParty({ mode: "online" }) を呼び出すと、PlayDrop のパーティー画面が開きます。プレイヤーはここで友達を招待したり、音声をオン・オフしたりできます。既存のパーティーがあれば再利用されます。openParty() はパーティーメニューを、openParty({ section: "voice" }) は音声設定を開きます。mode と section を一緒に使わないでください。Promise は、キャンセルした場合も含めて画面が閉じると正常終了します。

パーティーの情報は sdk.social.getParty() か sdk.social.onPartyChange(callback) で読み取ります。onPartyChange は最初に現在の状態を届けます：{ partyId, leaderUserId, revision, members, launch }。パーティーがこのゲームを遊んでいるとき、launch.status は joining または ready です。メンバーであるだけでは、プレイヤーが同じルームにいるとは限りません。join を使ってください。

パーティーのメンバー管理は PlayDrop の役割です。ゲームはパーティーのメンバーを追加・削除したり、マイクを制御したりできません。プレイヤーはこの画面から友達をパーティーに招待します。ただし、ゲームは sdk.social.sendMessage を使って、独自の招待カードや挑戦カードを友達に送れます。共有、フレンド、招待をご覧ください。

roomVoice: true にすると、サーバーのコードなしでルームの全員が話せます。誰の声を誰が聞けるかを変えるには、サーバーでルームを紐づけてポリシーを設定します。

import { playdrop } from "@playdrop/server";

const platform = playdrop.multiplayer.forRoom(this);
platform.voice.setPolicy("team");
platform.voice.setTeam(client.auth, "red");

ポリシーは all、team、proximity（{ range } 付き）、off です。setAudience(player, audience) は1人のプレイヤーの設定を上書きし、updatePositions([{ player, position: { x, y, z } }]) は近接判定に位置を渡します。チームや上書きを解除するには null を渡します。誰の声を誰が聞けるかは PlayDrop が強制します。ブラウザの sdk.multiplayer.voice.updateSpatialState({ listener: { position, forward, up }, speakers: [{ userId, position }] }) が調整するのは、音量と左右の定位だけです。

音声には、プレイヤーの同意、ミュート、ブロックが適用され、ホストのビルドや提供状況にも左右されます。

パーティーのカプセル表示は、ゲームプレイを一時停止しません。PlayDrop の一時停止はクライアントを止めますが、ルームの接続は維持され、サーバーは動き続けます。1人のプレイヤーの一時停止で、ほかのプレイヤーの試合を止めてはいけません。試合の一時停止が必要なら、サーバー側で実装してください。

非公開バージョンをアップロードし、リアルタイムゲームサーバーで説明しているとおり、テスト用リンクを player=1 と player=2 で2つのウィンドウに開きます。コントローラーを使うローカルパーティーは別のモードです。ローカルパーティーとコントローラーをご覧ください。