Lokale Partys, Gamepads und Handy-Controller in PlayDrop-Spielen

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

• controller.support ist off, optional oder required. Deklariere es bei jedem Spiel, auch off.
• controller.type nennt die Mindestausstattung, die das Spiel braucht: any (Richtungen, Bestätigen und Abbrechen), simpler (ein Stick, vier Aktionstasten und Menü; Handy-Controller erfüllen das) oder standard (Steuerkreuz, zwei klickbare Sticks, vier Aktionstasten, zwei Schultertasten, zwei Trigger und Menü).
• party.local listet die genauen Spielerzahlen an einem Bildschirm auf; eine 1 erfordert den Typ solo. Ist die Controller-Unterstützung aktiv, muss jede aufgeführte Zahl mit Controllern spielbar sein.

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

• Rufe enableControllerInput() einmal nach init() auf. Der Aufruf wird mit controller_input_unavailable oder controller_input_timeout abgelehnt, wenn der Host keine Eingabe liefern kann; das Spiel läuft weiter.
• gamepad(playerIndex) liefert einen Snapshot im Standardlayout des Browsers: axes (links x/y, rechts x/y von -1 bis 1), siebzehn buttons, source (physical oder virtual) und id. playerIndex 0 ist Spieler 1.
• Tasten haben Namen nach ihrer Position, etwa south und east. pad.label("south") liefert die Beschriftung, die du anzeigen solltest: „A“, „Cross“ oder „B“, je nach Controller. pad.has("dpad") sagt, ob ein Bedienelement vorhanden ist.
• Menü und Home gehören PlayDrop und gelten immer als losgelassen.
• Rufe niemals navigator.getGamepads() auf: Handy-Controller erreichen Spiele nur über das SDK, und PlayDrop protokolliert eine Warnung.

sdk.device.localPlayers listet die Plätze auf, die Spieler gewählt haben, { playerIndex, gamepadKey }, und onLocalPlayersChange(callback) meldet Änderungen. Ein getrennter Controller behält seinen Platz. Wenn sich die Besetzung ändert oder leer wird, kehre zu einem sinnvollen Menü zurück, statt abzustürzen. Ein einzelner Controller ist eine gewöhnliche Eingabe, keine Party.

Über einen Button öffnet sdk.social.openParty({ mode: "local" }) das Kopplungsfenster von PlayDrop mit dem QR-Code für Handys und den verbundenen Gamepads. Biete nur die Modi an, die du deklariert hast.

Der Host startet ein Spiel entweder als lokale Party oder als Online-Party, nie beides: Lokale Spieler können keinen Online-Räumen beitreten. Für Online-Spiel mit Freunden siehe Online-Partys und Sprachchat.

Zeige die Farbe und die Tastenbeschriftung jedes Spielers, lass jeden per Tastendruck beitreten und halte das HUD vom Sofa aus lesbar. Behalte Touch- und Tastatursteuerung für das Spielen allein bei.