Le SDK Jeux intégrés YouTube est un SDK Web permettant de connecter des jeux sur navigateur à l'environnement YouTube. Il comprend une API robuste qui permet aux jeux de fonctionner de différentes manières afin de créer une excellente expérience de jeu sur YouTube.
Ajouter le SDK Playables à votre jeu
Un jeu doit comporter un fichier index.html dans le répertoire racine. Importez le SDK Jeux intégrés YouTube en ajoutant cette ligne avant le code de votre 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
Il existe plusieurs intégrations requises et facultatives avec le SDK Playables.
Intégrations requises
Consultez les exigences de publication générales, en vous concentrant sur les exigences d'intégration. Consultez la référence du SDK Playables pour en savoir plus sur l'implémentation.
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 attrayante. Voici quelques exemples :
ytgame.system.getLanguage(): utilisez cette fonction pour récupérer le paramètre régional actuel de l'utilisateur. N'utilisez pas d'autres fonctions ni ne stockez la langue dans l'enregistrement cloud, car elle peut changer à tout moment.ytgame.engagement.sendScore({ value: newScore }): envoyez un meilleur score à YouTube pour l'afficher.ytgame.engagement.openYTContent({ id: videoID }): ouvrez une vidéo YouTube.ytgame.health.logError()etytgame.health.logWarning(): enregistrez les problèmes sur YouTube.ytgame.ads.requestInterstitialAd()etrequestRewardedAd(rewardId: string): intégrez des fonctionnalités publicitaires à votre jeu.
Consultez la référence du SDK Playables pour en savoir plus sur l'implémentation et découvrir d'autres fonctions.
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 montrer comment effectuer une intégration avec le SDK YouTube Playables, y compris en 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.