YouTube Playables SDK – Erste Schritte

Das YouTube Playables SDK ist ein Web-SDK, mit dem Webspiele mit der YouTube-Umgebung verbunden werden können. Das SDK bietet eine robuste API, mit der Spiele auf vielfältige Weise unterstützt werden können, um ein hervorragendes Spielerlebnis auf YouTube zu schaffen.

Playables SDK zu Ihrem Spiel hinzufügen

Ein Spiel sollte eine index.html-Datei im Stammverzeichnis haben. Importieren Sie das YouTube Playables SDK, indem Sie diese Zeile vor Ihrem Spielcode hinzufügen:

<script src="https://www.youtube.com/game_api/v1"></script>

Wichtig: Das SDK MUSS vor dem Spielcode geladen werden. Dadurch wird eine reproduzierbare Sandbox-Umgebung erstellt und bestimmte Funktionen werden dem Spiel sofort zur Verfügung gestellt. Dies wird bei der Veröffentlichung überprüft. Sie können die Testsuite-Anleitung verwenden, um die Überprüfung vor dem Einreichen Ihres Spiels durchzuführen.

Das SDK wird als No-Op ausgeführt, wenn Ihr Spiel lokal bereitgestellt wird. Verwenden Sie die Testsuite-Anleitung, um die Korrektheit der SDK Integration zu überprüfen.

Mit dem Playables SDK einbinden

Es gibt mehrere erforderliche und optionale Integrationen mit dem Playables SDK.

Erforderliche Integrationen

Lesen Sie die Veröffentlichungsanforderungen insgesamt, mit Schwerpunkt auf den Integrations anforderungen. Details zur Implementierung finden Sie in der Playables SDK-Referenz.

Beispiele:

• ytgame.game.firstFrameReady()
• ytgame.game.gameReady()
• ytgame.IN_PLAYABLES_ENV
• ytgame.system.isAudioEnabled()
• ytgame.system.onAudioEnabledChange((isAudioEnabled) => {})
• ytgame.system.onPause(() => {})
• ytgame.system.onResume(() => {})
• ytgame.game.loadData()
• ytgame.game.saveData(data)

Empfohlene Integrationen

Neben den erforderlichen Integrationen stehen mehrere andere Funktionen zur Verfügung, um ein ansprechendes Spielerlebnis zu schaffen. Beispiele:

• ytgame.system.getLanguage() : Mit dieser Funktion können Sie die aktuelle Gebietsschemaeinstellung des Nutzers abrufen. Verwenden Sie keine anderen Funktionen und speichern Sie die Sprache nicht in der Cloud-Speicherung, da sie sich jederzeit ändern kann.
• ytgame.engagement.sendScore({ value: newScore }) : Senden Sie eine Bestpunktzahl an YouTube, um sie anzuzeigen.
• ytgame.engagement.openYTContent({ id: videoID }) : Öffnen Sie ein YouTube-Video.
• ytgame.health.logError() und ytgame.health.logWarning() : Melden Sie Probleme an YouTube.
• ytgame.ads.requestInterstitialAd() und requestRewardedAd(rewardId: string) : Binden Sie Anzeigenfunktionen in Ihr Spiel ein.

Details zur Implementierung und weitere Funktionen finden Sie in der Playables SDK-Referenz.

TypeScript-Typdefinitionen

Laden Sie für Spiele, die TypeScript verwenden, Typdefinitionen herunter.

Beispielspiele

Es sind Beispiele verfügbar, die zeigen, wie Sie das YouTube Playables SDK einbinden können, darunter reines JavaScript, Flutter Web, Godot und Unity.

Spiel mit der Testsuite testen

Wenn Sie bereit sind, können Sie Ihre Integration mit der Testsuite überprüfen. Eine Anleitung dazu finden Sie in der Testsuite-Anleitung.