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명 파티 두 개가 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" });

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)으로 읽으세요. 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)는 플레이어 한 명의 설정을 재정의하고, updatePositions([{ player, position: { x, y, z } }])는 근접 모드에 위치를 전달합니다. 팀 지정이나 재정의를 지우려면 null을 넘기세요. 누가 누구의 말을 들을 수 있는지는 PlayDrop이 강제합니다. 브라우저에서 sdk.multiplayer.voice.updateSpatialState({ listener: { position, forward, up }, speakers: [{ userId, position }] })는 볼륨과 좌우 위치만 조정합니다.

음성은 플레이어의 동의, 음소거, 차단 설정을 따르며, 호스트 빌드와 배포 범위에 따라 달라집니다.

파티 캡슐은 게임 플레이를 일시 정지하지 않습니다. PlayDrop이 일시 정지하면 클라이언트는 멈추지만, 방은 연결된 상태로 남고 서버는 계속 실행됩니다. 한 플레이어의 일시 정지로 다른 플레이어의 경기가 멈추면 안 됩니다. 경기 일시 정지가 필요하면 서버에 구현하세요.

비공개 버전을 업로드한 다음, 실시간 게임 서버에서 설명한 대로 테스트 링크를 player=1과 player=2로 두 창에서 여세요. 컨트롤러를 쓰는 로컬 파티는 별개의 모드입니다. 로컬 파티와 컨트롤러를 참고하세요.