一起玩

PlayDrop 游戏中的在线队伍和语音聊天

让朋友们在线一起玩你的游戏：声明队伍人数，打开 PlayDrop 的队伍窗口，用 sdk.multiplayer.join 加入预留的房间，并控制房间语音。

PlayDrop 队伍是一群一起在游戏之间移动的朋友。当一支队伍启动你的游戏时，PlayDrop 会在你服务器的某个房间里为队伍成员预留席位，让朋友们进入同一场对局，而不是被分开。语音聊天在 PlayDrop 中运行，而不是在你的游戏中。

你需要什么

一个实时游戏服务器：队伍在你的 Colyseus 房间中游玩。
已登录的玩家：房间会拒绝访客。
catalogue.json 中的以下声明：

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 人。它是一起进入的队伍人数，不是房间容量：两支四人队伍可以共用一个八人房间。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" });

当 PlayDrop 以队伍方式启动游戏时，join 会使用玩家预留的队伍席位，否则就独立加入。如果队伍加入失败，它会拒绝；绝不会悄悄把玩家放进另一个房间。访客会收到 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) 读取队伍，后者会先发送当前状态：{ 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) 可以单独覆盖一位玩家的设置，updatePositions([{ player, position: { x, y, z } }]) 为近距离模式提供位置；传入 null 可清除队伍分配或覆盖设置。谁能听到谁由 PlayDrop 强制执行。在浏览器中，sdk.multiplayer.voice.updateSpatialState({ listener: { position, forward, up }, speakers: [{ userId, position }] }) 只调整音量和声像。

语音受玩家同意、静音和屏蔽的约束，并取决于宿主版本和功能推出进度。

暂停

队伍胶囊不会暂停游戏。PlayDrop 的暂停会让你的客户端停下，但房间保持连接，你的服务器也会继续运行。一位玩家暂停不能让其他人的对局停下；如需暂停对局，请在服务器上实现。

测试

上传一个私密版本，然后在两个窗口中分别用 player=1 和 player=2 打开测试链接，方法见实时游戏服务器。使用控制器的本地队伍是另一种模式：请参阅本地队伍和控制器。

一起玩