# Ce que PlayDrop apporte à votre jeu

Ce qu’apportent SDK, catalogue.json et hébergement PlayDrop, où chaque fonctionnalité est disponible, et les guides : sauvegardes, groupes, serveurs, gains.

Source: https://www.playdrop.ai/fr/create/learn/playdrop-games

Un jeu PlayDrop est un jeu web que PlayDrop héberge, répertorie et fait tourner sur son site web et dans les apps PlayDrop pour iOS, Android, Windows et macOS. Dans les apps, un jeu s’affiche en plein écran, sans barre de navigateur autour ; c’est le même jeu web, exécuté dans la vue de jeu de l’app, et non une version native distincte. Cette page liste ce que PlayDrop peut ajouter et où chaque élément est documenté.

## Deux voies d’accès

| | HTML simple | Paquet |
|---|---|---|
| Ce que vous envoyez | Un seul fichier HTML autonome, jusqu’à 10 MiB | Un dossier compilé, un ZIP ou un .play avec catalogue.json |
| SDK PlayDrop | Non | Oui, toutes les fonctionnalités ci-dessous |
| Images et vidéo de fiche | Non | Oui |
| Serveur de jeu hébergé | Non | Oui |
| Guide | [Jeux HTML simples](https://www.playdrop.ai/fr/create/learn/html-games) | [Paquets](https://www.playdrop.ai/fr/create/learn/packaging) |

Tout jeu peut commencer simple et devenir un paquet plus tard, sous le même nom et avec le même lien.

## Ce que reçoivent les joueurs

| Fonctionnalité | Ce qu’elle apporte aux joueurs | Guide |
|---|---|---|
| Cycle de vie de l’hôte | Pause et reprise propres, audio qui suit la sourdine du joueur, première image rapide | [Chargement, pause et audio](https://www.playdrop.ai/fr/create/learn/lifecycle) |
| Mise en page plein écran | Jeu bord à bord, avec une interface à l’écart des encoches et des commandes de PlayDrop | [Plein écran et zones sûres](https://www.playdrop.ai/fr/create/learn/viewport) |
| Sauvegardes cloud | Une progression qui suit le joueur d’un appareil à l’autre | [Sauvegardes cloud](https://www.playdrop.ai/fr/create/learn/cloud-saves) |
| Classements | Meilleurs scores et rang du joueur | [Classements](https://www.playdrop.ai/fr/create/learn/leaderboards) |
| Succès | Objectifs avec icônes et progression | [Succès](https://www.playdrop.ai/fr/create/learn/achievements) |
| Partage et invitations | Feuilles de partage avec image ou extrait vidéo, invitations d’amis et cartes de jeu dans le chat | [Partage, amis et invitations](https://www.playdrop.ai/fr/create/learn/social) |
| Groupes en ligne et voix | Les amis rejoignent ensemble la même salle, avec voix de salle facultative | [Groupes en ligne et voix](https://www.playdrop.ai/fr/create/learn/online-party) |
| Groupes locaux et manettes | Manettes physiques et téléphones servant de manettes sur un même écran | [Groupes locaux et manettes](https://www.playdrop.ai/fr/create/learn/local-party) |
| Serveurs temps réel | Salles Colyseus avec une base de données MongoDB par jeu | [Serveurs de jeu temps réel](https://www.playdrop.ai/fr/create/learn/game-servers) |
| Avis, pourboires, achats et publicités | Des moyens pour les joueurs de soutenir le jeu ; des Crédits pour le créateur | [Monétisation](https://www.playdrop.ai/fr/create/learn/monetization) |
| Ressources et génération par IA | Ressources partagées, médias générés et créations des joueurs | [Ressources de jeu](https://www.playdrop.ai/fr/create/learn/game-assets), [Ressources IA](https://www.playdrop.ai/fr/create/learn/ai-assets), [Formats personnalisés](https://www.playdrop.ai/fr/create/learn/custom-assets) |

## Ce que reçoit la fiche

catalogue.json donne au jeu sa page : titre, description, genre et [tags](https://www.playdrop.ai/fr/create/learn/tags), [icône, illustrations, captures d’écran et vidéo](https://www.playdrop.ai/fr/create/learn/listing-assets), [traductions](https://www.playdrop.ai/fr/create/learn/localization) et admissibilité à [Instantané](https://www.playdrop.ai/fr/create/learn/instant-games). La [visibilité](https://www.playdrop.ai/fr/create/learn/distribution) détermine qui peut l’ouvrir : privé pour les tests, non répertorié pour toute personne qui a le lien, public pour être découvert sur PlayDrop et ouvert aux moteurs de recherche. Une fiche publique crée des occasions d’être découvert ; elle ne garantit pas de joueurs.

## Où fonctionne chaque fonctionnalité

Le site web et les apps exécutent le même jeu avec le même SDK, mais certaines fonctionnalités de l’hôte dépendent de l’appareil :

- Les retours haptiques ne fonctionnent que dans les apps natives ; `sdk.haptics.supported` vous l’indique.
- Le partage d’un extrait vidéo dépend de l’hôte ; les hôtes qui ne le prennent pas en charge rejettent l’appel au lieu de partager un simple lien.
- Le jeu hors ligne et le préchargement des fichiers ont lieu dans les apps natives, pour les jeux qui les déclarent ; le site web charge les jeux en ligne.
- La voix de salle et les groupes dépendent de la version de l’hôte, de la connexion et du déploiement de la plateforme.
- Les publicités dépendent de l’hôte et de l’inventaire disponible ; `load()` signale quand aucune n’est prête.

Concevez le jeu pour qu’il reste jouable quand un service facultatif manque.

## Commencez avec le SDK

Chargez le SDK, lisez l’état de l’hôte, puis signalez que le jeu est prêt quand la première image prévue est à l’écran :

```html
<script src="https://assets.playdrop.ai/sdk/playdrop.js"></script>
<script type="module">
  const sdk = await playdrop.init();
  // Set up pause, audio and HUD from sdk.host, then render the first frame.
  sdk.host.ready();
</script>
```

Poursuivez avec [chargement, pause et audio](https://www.playdrop.ai/fr/create/learn/lifecycle). La [référence du SDK client](https://www.playdrop.ai/fr/create/learn/sdk) liste tous les espaces de noms.

## Ce que le connecteur ne peut pas faire

Votre app d’IA publie des jeux compilés et lit votre compte. Elle ne peut pas ouvrir ni modifier les jeux créés dans PlayDrop Studio, restituer le code source ni envoyer du code de modèle 3D exécutable. Ces limites sont propres au connecteur, pas à la plateforme : Studio et les outils de PlayDrop peuvent toujours le faire.

## Guides associés

- [Jeux HTML simples](https://www.playdrop.ai/fr/create/learn/html-games): Publiez un fichier HTML autonome de 10 MiB maximum avec upload_game : ce qui convient, le mini catalogue, la visibilité, les mises à jour et quand passer au paquet.
- [Paquets et .play](https://www.playdrop.ai/fr/create/learn/packaging): Organisez un dossier, ZIP ou .play compilé avec catalogue.json à la racine, déclarez médias de fiche et serveurs, puis envoyez avec prepare_catalogue_upload.
- [Chargement, pause et audio](https://www.playdrop.ai/fr/create/learn/lifecycle): Initialisez le SDK, signalez ready dès la première image jouable, gérez pause, reprise et audio de l’hôte, et préchargez pour les apps et le jeu hors ligne.
- [SDK client](https://www.playdrop.ai/fr/create/learn/sdk): SDK navigateur de PlayDrop : init, hôte, joueur et sauvegardes, manettes, social, multijoueur, boutique, publicités, classements, succès, ressources et IA.