Nhóm chơi cục bộ, tay cầm và điện thoại làm tay cầm trong game PlayDrop

{
  "types": ["solo", "party"],
  "party": { "local": [1, 2, 3, 4] },
  "controller": { "support": "optional", "type": "simpler" }
}

• controller.support là off, optional hoặc required. Hãy khai báo trường này cho mọi game, kể cả off.
• controller.type nêu bộ điều khiển tối thiểu game cần: any (hướng, Xác nhận và Hủy), simpler (một cần điều khiển, bốn nút mặt và Menu; tay cầm điện thoại đáp ứng được) hoặc standard (D-pad, hai cần điều khiển nhấn được, bốn nút mặt, hai nút vai, hai cò và Menu).
• party.local liệt kê chính xác số người chơi trên một màn hình; giá trị 1 yêu cầu loại solo. Khi bật hỗ trợ tay cầm, mọi số lượng được liệt kê đều phải chơi được bằng tay cầm.

await sdk.device.enableControllerInput().catch(() => { /* keep keyboard and touch */ });

const stop = sdk.device.onButton(({ playerIndex, button, pressed }) => {
  if (button === "south" && pressed) jump(playerIndex);
});

function update() {
  for (const slot of sdk.device.localPlayers) {
    const pad = sdk.device.gamepad(slot.playerIndex);
    if (pad?.connected) move(slot.playerIndex, pad.axes[0], pad.axes[1]);
  }
  requestAnimationFrame(update);
}
update();

• Gọi enableControllerInput() một lần sau init(). Lệnh này bị từ chối với controller_input_unavailable hoặc controller_input_timeout khi host không cung cấp được đầu vào; game vẫn tiếp tục chạy.
• gamepad(playerIndex) trả về một ảnh chụp trạng thái theo bố cục chuẩn của trình duyệt: axes (trái x/y, phải x/y từ -1 đến 1), mười bảy buttons, source (physical hoặc virtual) và id. playerIndex 0 là người chơi 1.
• Các nút có tên theo vị trí như south và east. pad.label("south") cho biết nhãn cần hiển thị: "A", "Cross" hoặc "B" tùy tay cầm. pad.has("dpad") cho biết một điều khiển có tồn tại hay không.
• Menu và Home thuộc về PlayDrop và luôn được đọc là không được nhấn.
• Không bao giờ gọi navigator.getGamepads(): tay cầm điện thoại chỉ đến được game qua SDK, và PlayDrop sẽ ghi một cảnh báo.

sdk.device.localPlayers liệt kê các ô người chơi đã chọn, { playerIndex, gamepadKey }, và onLocalPlayersChange(callback) báo các thay đổi. Một tay cầm bị ngắt kết nối vẫn giữ ô của nó. Khi danh sách người chơi thay đổi hoặc trở nên trống, hãy quay về một menu hợp lý thay vì để game gặp lỗi. Một tay cầm đơn lẻ chỉ là đầu vào thông thường, không phải nhóm chơi.

Từ một nút bấm, sdk.social.openParty({ mode: "local" }) mở cửa sổ ghép nối của PlayDrop với mã QR cho điện thoại và các tay cầm đã kết nối. Chỉ cung cấp những chế độ bạn đã khai báo.

Host khởi động game dưới dạng nhóm chơi cục bộ hoặc nhóm chơi trực tuyến, không bao giờ cả hai: người chơi cục bộ không thể tham gia phòng trực tuyến. Để chơi trực tuyến với bạn bè, hãy xem nhóm chơi trực tuyến và thoại.

Hiển thị màu và nhãn nút tay cầm của từng người chơi, cho phép bất kỳ ai nhấn một nút để tham gia, và giữ HUD dễ đọc từ ghế sofa. Hãy giữ điều khiển cảm ứng và bàn phím cho chế độ chơi đơn.