SDK Sala giochi di YouTube - Guida introduttiva

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

Aggiungere l'SDK Playables al 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 del gioco:

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

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

Integrare l'SDK Playables

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

Integrazioni richieste

Esamina i requisiti di pubblicazione generali, con un'attenzione particolare ai requisiti di integrazione. Per i dettagli sull'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)

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

  • ytgame.system.getLanguage() : utilizza questa funzione per recuperare l'impostazione delle impostazioni internazionali corrente dell'utente. Non utilizzare altre funzioni o archiviare la lingua nel salvataggio nel cloud, in quanto potrebbe cambiare in qualsiasi momento.
  • ytgame.engagement.sendScore({ value: newScore }) : invia un punteggio migliore a YouTube da visualizzare.
  • ytgame.engagement.openYTContent({ id: videoID }) : apri un video di YouTube.
  • ytgame.health.logError() e ytgame.health.logWarning() : registra i problemi su YouTube.
  • ytgame.ads.requestInterstitialAd() e requestRewardedAd(rewardId: string) : integra le funzionalità degli annunci nel gioco.

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

Definizioni dei tipi di 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, tra cui 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 fare, consulta la guida alla suite di test.