PlayDrop-Client-SDK für Browserspiele
Optionales Browser-SDK für jedes PlayDrop-Spiel: Host-Lebenszyklus, Anmeldung, Spielstände, Bestenlisten, Käufe, Werbung, Freunde, Multiplayer und gemeinsam genutzte Bibliotheken – mit einem einzigen Script-Tag.
Das PlayDrop-SDK ist optional: Auch Spiele ohne SDK laufen auf PlayDrop. Binden Sie es für Plattformfunktionen ein, etwa Spieleranmeldung, Spielstände, Erfolge und Bestenlisten, Käufe mit Credits, Werbung, Freunde und Spielkarten in PlayDrop Chat, Links zum Teilen, vom Host gesteuerte Pause und Audiowiedergabe, gehosteten Multiplayer und KI-Generierung. PlayDrop Cloud integriert es für Sie; mit PlayDrop Connector fügt Ihr Agent ein einziges Script-Tag hinzu.
SDK einbinden und den Host-Lebenszyklus beachten
<script src="https://assets.playdrop.ai/sdk/playdrop.js"></script>
<script type="module">
const sdk = await playdrop.init();
// Render the game and prepare input, then:
sdk.host.ready();
sdk.host.onPause(() => pauseGame());
sdk.host.onResume(() => resumeGame());
sdk.host.onAudioPolicyChange(({ enabled }) => setAudioEnabled(enabled));
</script>Laden Sie das SDK vom CDN von PlayDrop; eine Paketinstallation ist nicht nötig. Rendern Sie den ersten spielbaren Frame und bereiten Sie die Eingabe vor, bevor Sie sdk.host.ready() aufrufen. Pausieren Sie die Simulation, wenn der Host pausiert, setzen Sie sie ohne doppelte Schleifen fort und befolgen Sie die Audiorichtlinie des Hosts.
Identität, Spielstände und Sprache
sdk.me stellt die Spieleridentität bereit und sdk.me.appData speichert private Spielstände; sdk.achievements und sdk.leaderboards verwalten Erfolge und Punktestände. Spielstände, Erfolge und Bestenlisten funktionieren ohne vorherige Anmeldeprüfung. Verwenden Sie sdk.me.isLoggedIn für Funktionen, die ein echtes Konto erfordern, etwa Käufe oder Multiplayer. In Vorschau- und Aufnahmemodi darf kein Spielerfortschritt gespeichert werden. sdk.host.locale liefert die Sprache des Spielers: Bieten Sie Ihr Spiel auf Englisch an und zusätzlich in Ihrer eigenen Sprache, falls diese abweicht. Das Übersetzen eines Spieleintrags übersetzt keine Spielinhalte.
Bibliotheken, Assets und Multiplayer
sdk.libs lädt unterstützte Versionen von Three.js, Phaser, Rapier, nipplejs und Colyseus. sdk.assets stellt Katalog-, Pack- und Asset-Referenzen bereit; sdk.social bietet Freunde, Spielkarten und Aktionen zum Teilen. Für gehosteten Multiplayer liefert sdk.multiplayer.getConnection() die Serveradresse und das Token des angemeldeten Spielers; verbinden Sie sich damit über den Colyseus-Client. Die Seite zum Server-SDK behandelt gehostete Server; ein Server, den Sie selbst betreiben, braucht nichts vom SDK. Die alten Relay-Room-APIs wurden eingestellt.
Vor der Veröffentlichung mit dem SDK testen
Starten Sie Ihren gewohnten Dev-Server und öffnen Sie https://www.playdrop.ai/creators/<username>/apps/game/<slug>/dev?url=http://localhost:5173/ in Chrome, um das Spiel im echten PlayDrop-Rahmen mit dem SDK-Host zu spielen. Jeder localhost-Port und jede https-URL funktioniert. Funktionen, die ein Konto erfordern, etwa Spielstände und Käufe, funktionieren, sobald das Spiel einmal hochgeladen wurde; ein privater Upload genügt. Die Mediengenerierung im Browser läuft als asynchrone Aufgaben mit vom Host bestätigten Credit-Kosten. Die Metadaten des Spieleintrags finden Sie unter catalogue.json.