Grup lokal, gamepad, dan pengontrol ponsel di game PlayDrop

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

• controller.support bernilai off, optional, atau required. Deklarasikan di setiap game, termasuk off.
• controller.type menyebutkan kontrol minimum yang dibutuhkan game: any (arah, Konfirmasi, dan Batal), simpler (satu stik, empat tombol muka, dan Menu; pengontrol ponsel memenuhi syarat), atau standard (D-pad, dua stik yang bisa diklik, empat tombol muka, dua tombol bahu, dua pelatuk, dan Menu).
• party.local mencantumkan jumlah pemain persis di satu layar; nilai 1 memerlukan tipe solo. Jika dukungan pengontrol aktif, setiap jumlah yang dicantumkan harus bisa dimainkan dengan pengontrol.

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

• Panggil enableControllerInput() sekali setelah init(). Panggilan ini ditolak dengan controller_input_unavailable atau controller_input_timeout saat host tidak bisa menyediakan input; game tetap berjalan.
• gamepad(playerIndex) mengembalikan snapshot dalam tata letak standar browser: axes (x/y kiri, x/y kanan dari -1 sampai 1), tujuh belas buttons, source (physical atau virtual), dan id. playerIndex 0 adalah pemain 1.
• Tombol memiliki nama posisi seperti south dan east. pad.label("south") memberikan petunjuk tombol yang perlu ditampilkan: "A", "Cross", atau "B", tergantung pengontrolnya. pad.has("dpad") menunjukkan apakah sebuah kontrol tersedia.
• Menu dan Home adalah milik PlayDrop dan selalu terbaca sebagai dilepas.
• Jangan pernah memanggil navigator.getGamepads(): pengontrol ponsel hanya sampai ke game lewat SDK, dan PlayDrop mencatat peringatan.

sdk.device.localPlayers mencantumkan slot yang dipilih pemain, { playerIndex, gamepadKey }, dan onLocalPlayersChange(callback) melaporkan perubahannya. Pengontrol yang terputus tetap memegang slotnya. Saat daftar pemain berubah atau menjadi kosong, kembali ke menu yang masuk akal alih-alih membuat game crash. Satu pengontrol saja hanyalah input biasa, bukan grup.

Dari sebuah tombol, sdk.social.openParty({ mode: "local" }) membuka jendela pemasangan PlayDrop dengan kode QR ponsel dan gamepad yang terhubung. Tawarkan hanya mode yang sudah Anda deklarasikan.

Host memulai game sebagai grup lokal atau grup online, tidak pernah keduanya: pemain lokal tidak bisa bergabung ke room online. Untuk bermain online bersama teman, lihat grup online dan suara.

Tampilkan warna dan petunjuk tombol pengontrol setiap pemain, biarkan siapa pun menekan tombol untuk bergabung, dan buat HUD tetap terbaca dari sofa. Pertahankan kontrol sentuh dan keyboard untuk bermain solo.