SDK da Sala de jogos do YouTube: primeiros passos

O SDK do YouTube Playables é um SDK da Web para conectar jogos da Web ao ambiente do YouTube. O SDK tem uma API robusta para oferecer suporte a jogos de várias maneiras e criar uma excelente experiência de jogo no YouTube.

Adicionar o SDK do Playables ao seu jogo

Um jogo precisa ter um arquivo index.html no diretório raiz. Importe o SDK do YouTube Playables adicionando esta linha antes de qualquer código do jogo:

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

O SDK é executado como uma operação nula quando o jogo é veiculado localmente. Para verificar se a integração do SDK está correta, use o guia do pacote de testes.

Integrar com o SDK Playables

Há várias integrações obrigatórias e opcionais com o SDK Playables.

Integrações necessárias

Revise os requisitos de publicação gerais, com foco nos requisitos de integração. Consulte a referência do SDK Playables para detalhes de implementação.

Por exemplo:

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

Além das integrações obrigatórias, várias outras funções estão disponíveis para criar uma experiência altamente envolvente. Por exemplo:

  • ytgame.system.getLanguage(): use para recuperar a configuração de localidade atual do usuário. Não use outras funções nem armazene o idioma no salvamento em nuvem, porque ele pode mudar a qualquer momento.
  • ytgame.engagement.sendScore({ value: newScore }) - Envie uma pontuação máxima para o YouTube para que ela seja exibida.
  • ytgame.engagement.openYTContent({ id: videoID }): abra um vídeo do YouTube.
  • ytgame.health.logError() e ytgame.health.logWarning(): registre problemas no YouTube.
  • ytgame.ads.requestInterstitialAd() e requestRewardedAd(rewardId: string): integre recursos de anúncios ao seu jogo.

Consulte a referência do SDK Playables para detalhes da implementação e outras funções.

Definições de tipo do TypeScript

Para jogos que usam TypeScript, faça o download das definições de tipo.

Exemplos de jogos

Há exemplos disponíveis que mostram como fazer a integração com o SDK do YouTube Playables, incluindo JavaScript simples, Flutter Web, Godot e Unity.

Testar o jogo com o pacote de testes

Quando estiver tudo pronto, valide sua integração usando o pacote de testes. Para saber como, siga o guia do pacote de testes.