Le SDK Jeux intégrés YouTube est un SDK Web permettant de connecter des jeux sur navigateur à l'environnement YouTube. Le SDK propose une API robuste pour aider les jeux de différentes manières à créer une excellente expérience de jeu sur YouTube.
Ajouter le SDK Playables à votre jeu
Un jeu doit disposer d'un fichier index.html dans le répertoire racine. Importez le SDK Jeux intégrés YouTube en ajoutant cette ligne avant tout code de jeu :
<script src="https://www.youtube.com/game_api/v1"></script>
Le SDK s'exécute en tant qu'opération sans effet lorsque votre jeu est diffusé en local. Pour vérifier que l'intégration du SDK est correcte, consultez le guide de la suite de tests.
Intégrer le SDK Playables
Plusieurs intégrations sont obligatoires et facultatives avec le SDK Playables.
Intégrations requises
Consultez les exigences de publication globales, en vous concentrant sur les exigences d'intégration. Pour en savoir plus sur l'implémentation, consultez la documentation de référence du SDK Playables.
Voici quelques exemples :
ytgame.game.firstFrameReady()ytgame.game.gameReady()ytgame.IN_PLAYABLES_ENVytgame.system.isAudioEnabled()ytgame.system.onAudioEnabledChange((isAudioEnabled) => {})ytgame.system.onPause(() => {})ytgame.system.onResume(() => {})ytgame.game.loadData()ytgame.game.saveData(data)
Intégrations recommandées
En plus des intégrations requises, plusieurs autres fonctions sont disponibles pour créer une expérience très engageante. Voici quelques exemples :
ytgame.system.getLanguage(): utilisez cette option pour récupérer les paramètres régionaux actuels de l'utilisateur. N'utilisez pas d'autres fonctions ni ne stockez la langue dans la sauvegarde cloud, car elle peut changer à tout moment.ytgame.engagement.sendScore({ value: newScore }): envoie un meilleur score à YouTube pour l'afficher.ytgame.engagement.openYTContent({ id: videoID }): ouvre une vidéo YouTube.ytgame.health.logError()etytgame.health.logWarning(): signalez les problèmes à YouTube.
Consultez la documentation de référence du SDK Playables pour en savoir plus sur l'implémentation et les fonctions supplémentaires.
Définitions de type TypeScript
Pour les jeux utilisant TypeScript, téléchargez les définitions de type.
Exemples de jeux
Des exemples sont disponibles pour vous montrer comment intégrer le SDK YouTube Playables, y compris avec JavaScript simple, Flutter Web, Godot et Unity.
Tester votre jeu avec la suite de tests
Lorsque vous êtes prêt, vous pouvez valider votre intégration à l'aide de la suite de tests. Pour en savoir plus, consultez le guide de la suite de tests.