Groupes locaux, manettes et manettes téléphone dans les jeux PlayDrop

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

• controller.support vaut off, optional ou required. Déclarez-le pour chaque jeu, y compris off.
• controller.type indique les commandes minimales dont le jeu a besoin : any (directions, Valider et Annuler), simpler (un stick, quatre boutons d’action et Menu ; les manettes téléphone conviennent) ou standard (croix directionnelle, deux sticks cliquables, quatre boutons d’action, deux boutons de tranche, deux gâchettes et Menu).
• party.local liste les nombres exacts de joueurs sur un même écran ; un 1 exige le type solo. Avec la prise en charge des manettes, chaque nombre listé doit être jouable avec des manettes.

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

• Appelez enableControllerInput() une fois après init(). La promesse est rejetée avec controller_input_unavailable ou controller_input_timeout quand l’hôte ne peut pas fournir les commandes ; le jeu continue de tourner.
• gamepad(playerIndex) renvoie un état ponctuel au format standard du navigateur : axes (x/y gauche, x/y droite, de -1 à 1), dix-sept buttons, source (physical ou virtual) et id. Le playerIndex 0 correspond au joueur 1.
• Les boutons portent des noms de position comme south et east. pad.label("south") donne l’intitulé à afficher : « A », « Cross » ou « B » selon la manette. pad.has("dpad") indique si une commande existe.
• Les boutons Menu et Accueil appartiennent à PlayDrop et sont toujours lus comme relâchés.
• N’appelez jamais navigator.getGamepads() : les manettes téléphone n’atteignent les jeux qu’à travers le SDK, et PlayDrop journalise un avertissement.

sdk.device.localPlayers liste les emplacements choisis par les joueurs, { playerIndex, gamepadKey }, et onLocalPlayersChange(callback) signale les changements. Une manette déconnectée conserve son emplacement. Quand la liste des joueurs change ou se vide, revenez à un menu adapté au lieu de planter. Une manette seule est une simple commande de jeu, pas un groupe.

Depuis un bouton, sdk.social.openParty({ mode: "local" }) ouvre la fenêtre d’appairage de PlayDrop, avec le QR code pour les téléphones et les manettes connectées. Ne proposez que les modes que vous avez déclarés.

L’hôte démarre un jeu soit en groupe local, soit en groupe en ligne, jamais les deux : les joueurs en local ne peuvent pas rejoindre de salles en ligne. Pour jouer en ligne avec des amis, consultez groupes en ligne et voix.

Affichez la couleur et l’intitulé de bouton de chaque joueur, laissez chacun appuyer sur un bouton pour rejoindre la partie et gardez l’interface du jeu lisible depuis un canapé. Conservez les commandes tactiles et clavier pour le jeu en solo.