ปาร์ตี้ในเครื่อง เกมแพด และคอนโทรลเลอร์บนโทรศัพท์ในเกม PlayDrop

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

• controller.support เป็น off, optional หรือ required ประกาศไว้ในทุกเกม รวมถึง off
• controller.type ระบุปุ่มควบคุมขั้นต่ำที่เกมต้องใช้: any (ทิศทาง ปุ่มยืนยัน และปุ่มยกเลิก) simpler (สติ๊กหนึ่งอัน ปุ่มหน้าสี่ปุ่ม และปุ่ม Menu ซึ่งคอนโทรลเลอร์บนโทรศัพท์ผ่านเกณฑ์) หรือ standard (ปุ่มลูกศร สติ๊กที่กดได้สองอัน ปุ่มหน้าสี่ปุ่ม ปุ่มไหล่สองปุ่ม ทริกเกอร์สองปุ่ม และปุ่ม Menu)
• party.local ระบุจำนวนผู้เล่นที่แน่ชัดบนหน้าจอเดียว เลข 1 ต้องมีประเภท solo เมื่อเปิดรองรับคอนโทรลเลอร์ ทุกจำนวนที่ระบุต้องเล่นด้วยคอนโทรลเลอร์ได้

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();

• เรียก enableControllerInput() หนึ่งครั้งหลัง init() ฟังก์ชันนี้จะปฏิเสธด้วย controller_input_unavailable หรือ controller_input_timeout เมื่อโฮสต์ให้อินพุตไม่ได้ โดยเกมยังทำงานต่อไป
• gamepad(playerIndex) ส่งคืนสแนปช็อตในเลย์เอาต์มาตรฐานของเบราว์เซอร์: axes (x/y ซ้าย x/y ขวา จาก -1 ถึง 1) buttons สิบเจ็ดปุ่ม source (physical หรือ virtual) และ id โดย playerIndex 0 คือผู้เล่นคนที่ 1
• ปุ่มมีชื่อตามตำแหน่ง เช่น south และ east ส่วน pad.label("south") ให้ข้อความที่จะแสดงบนหน้าจอ: "A", "Cross" หรือ "B" ขึ้นกับคอนโทรลเลอร์ pad.has("dpad") บอกว่ามีปุ่มควบคุมนั้นหรือไม่
• ปุ่ม Menu และ Home เป็นของ PlayDrop และเกมจะอ่านค่าได้เป็นสถานะไม่ได้กดเสมอ
• ห้ามเรียก navigator.getGamepads() เด็ดขาด: คอนโทรลเลอร์บนโทรศัพท์ส่งถึงเกมผ่าน SDK เท่านั้น และ PlayDrop จะบันทึกคำเตือน

sdk.device.localPlayers แสดงช่องที่ผู้เล่นเลือกไว้ { playerIndex, gamepadKey } และ onLocalPlayersChange(callback) รายงานการเปลี่ยนแปลง คอนโทรลเลอร์ที่ตัดการเชื่อมต่อยังคงช่องของตัวเองไว้ เมื่อรายชื่อผู้เล่นเปลี่ยนหรือว่างลง ให้กลับไปที่เมนูที่เหมาะสมแทนที่จะให้เกมพัง คอนโทรลเลอร์ตัวเดียวคืออินพุตทั่วไป ไม่ใช่ปาร์ตี้

จากปุ่มในเกม sdk.social.openParty({ mode: "local" }) จะเปิดหน้าต่างจับคู่ของ PlayDrop พร้อมคิวอาร์โค้ดสำหรับโทรศัพท์และเกมแพดที่เชื่อมต่ออยู่ เสนอเฉพาะโหมดที่คุณประกาศไว้

โฮสต์เริ่มเกมเป็นปาร์ตี้ในเครื่องหรือปาร์ตี้ออนไลน์อย่างใดอย่างหนึ่ง ไม่ใช่ทั้งสองอย่าง: ผู้เล่นในเครื่องเข้าร่วมห้องออนไลน์ไม่ได้ สำหรับการเล่นออนไลน์กับเพื่อน ดูปาร์ตี้ออนไลน์และแชทเสียง

แสดงสีและข้อความปุ่มของผู้เล่นแต่ละคน ให้ใครก็ได้กดปุ่มเพื่อเข้าร่วม และทำให้ HUD อ่านได้จากโซฟา คงการควบคุมแบบสัมผัสและคีย์บอร์ดไว้สำหรับการเล่นคนเดียว