SDK Sala giochi di YouTube - Guida introduttiva

L'SDK Sala giochi di YouTube è un SDK web per connettere i browser game all'ambiente YouTube. L'SDK include un'API solida per supportare i giochi in vari modi e creare un'esperienza di gioco eccellente su YouTube.

Aggiungere l'SDK Playables al tuo gioco

Un gioco deve avere un file index.html nella directory principale. Importa l'SDK Sala giochi di YouTube aggiungendo questa riga prima di qualsiasi codice di gioco:

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

Importante: l'SDK DEVE essere caricato prima di qualsiasi codice di gioco. In questo modo viene creato un ambiente riproducibile e in sandbox e alcune funzioni vengono rese immediatamente disponibili per il gioco. Questa operazione viene convalidata durante la pubblicazione e puoi seguire la guida alla suite di test per eseguire la convalida prima di inviare il gioco.

L'SDK viene eseguito come no-op quando il gioco viene pubblicato localmente. Per verificare la correttezza dell'integrazione dell'SDK, utilizza la guida alla suite di test.

Eseguire l'integrazione con l'SDK Playables

Esistono diverse integrazioni obbligatorie e facoltative con l'SDK Playables.

Integrazioni richieste

Esamina i requisiti di pubblicazione generali, con particolare attenzione ai requisiti di integrazione. Per i dettagli dell'implementazione, consulta il riferimento dell'SDK Playables.

Ecco alcuni esempi:

• 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)

Integrazioni consigliate

Oltre alle integrazioni richieste, sono disponibili diverse altre funzioni per creare un'esperienza altamente coinvolgente. Ecco alcuni esempi:

• ytgame.system.getLanguage(): utilizza questo parametro per recuperare l'impostazione della lingua corrente dell'utente. Non utilizzare altre funzioni o memorizzare la lingua nel salvataggio sul cloud, in quanto potrebbe cambiare in qualsiasi momento.
• ytgame.engagement.sendScore({ value: newScore }) - Invia un punteggio migliore a YouTube per la visualizzazione.
• ytgame.engagement.openYTContent({ id: videoID }): apri un video di YouTube.
• ytgame.health.logError() e ytgame.health.logWarning(): registra i problemi su YouTube.

Per dettagli sull'implementazione e funzioni aggiuntive, consulta il riferimento dell'SDK Playables.

Definizioni dei tipi TypeScript

Per i giochi che utilizzano TypeScript, scarica le definizioni dei tipi.

Giochi di esempio

Sono disponibili esempi che mostrano come eseguire l'integrazione con l'SDK YouTube Playables, inclusi JavaScript semplice, Flutter web, Godot e Unity.

Testare il gioco con la suite di test

Quando è tutto pronto, puoi convalidare l'integrazione utilizzando la suite di test. Per scoprire come, segui la guida alla suite di test.