SDK client PlayDrop pour les jeux sur navigateur
SDK navigateur facultatif pour tout jeu PlayDrop : cycle de vie de l’hôte, connexion, sauvegardes, classements, achats, publicités, amis, multijoueur et bibliothèques partagées, avec une seule balise script.
Le SDK PlayDrop est facultatif : les jeux qui ne l’utilisent pas fonctionnent aussi sur PlayDrop. Ajoutez-le pour profiter des fonctionnalités de la plateforme, comme la connexion des joueurs, les sauvegardes, les succès et les classements, les achats en crédits, les publicités, les amis et les cartes de jeu dans PlayDrop Chat, les liens de partage, la pause et l’audio gérés par l’hôte, le multijoueur hébergé et la génération par IA. PlayDrop Cloud l’intègre pour vous ; avec PlayDrop Connector, votre agent ajoute une seule balise script.
Ajoutez le SDK et respectez le cycle de vie de l’hôte
<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>Chargez le SDK depuis le CDN de PlayDrop ; aucune installation de paquet n’est nécessaire. Affichez la première image jouable et préparez la gestion des entrées avant d’appeler sdk.host.ready(). Suspendez la simulation lors d’une pause de l’hôte, reprenez sans créer de boucles en double et respectez la politique audio de l’hôte.
Identité, sauvegardes et langue
sdk.me expose l’identité du joueur et sdk.me.appData stocke ses sauvegardes privées ; sdk.achievements et sdk.leaderboards gèrent les succès et les scores. Les sauvegardes, les succès et les classements fonctionnent sans vérification préalable de la connexion. Utilisez sdk.me.isLoggedIn pour les fonctionnalités qui nécessitent un véritable compte, comme les achats ou le multijoueur. Les modes aperçu et capture ne doivent pas enregistrer la progression du joueur. sdk.host.locale indique la langue du joueur : proposez votre jeu en anglais, et aussi dans votre langue si elle est différente. Traduire une fiche ne traduit pas le contenu du jeu.
Bibliothèques, ressources et multijoueur
sdk.libs charge les versions prises en charge de Three.js, Phaser, Rapier, nipplejs et Colyseus. sdk.assets fournit des références de catalogue, de pack et de ressource ; sdk.social fournit les amis, les cartes de jeu et les actions de partage. Pour le multijoueur hébergé, sdk.multiplayer.getConnection() renvoie l’adresse du serveur et le jeton du joueur connecté ; rejoignez la partie avec le client Colyseus. La page SDK serveur couvre les serveurs hébergés ; un serveur que vous gérez vous-même n’a besoin de rien du SDK. Les anciennes API de salles relais ont été retirées.
Testez avec le SDK avant de publier
Lancez votre serveur de développement habituel et ouvrez https://www.playdrop.ai/creators/<username>/apps/game/<slug>/dev?url=http://localhost:5173/ dans Chrome pour jouer dans le véritable cadre PlayDrop, avec l’hôte du SDK. N’importe quel port localhost ou URL https fonctionne. Les fonctionnalités qui nécessitent un compte, comme les sauvegardes et les achats, fonctionnent dès que le jeu a été envoyé une première fois ; un envoi privé suffit. Dans le navigateur, la génération de médias s’exécute sous forme de tâches asynchrones, avec un coût en crédits confirmé par l’hôte. Consultez catalogue.json pour les métadonnées de la fiche.