O SDK da Sala de jogos do YouTube é um SDK da Web para conectar jogos de navegador ao ambiente do YouTube. Ele apresenta 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 jogo
Um jogo precisa ter um arquivo index.html no diretório raiz. Importe o SDK da Sala de jogos do YouTube 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 a correção da integração do SDK, use o guia do pacote de testes.
Integrar com o SDK do Playables
Há várias integrações obrigatórias e opcionais com o SDK do Playables.
Integrações necessárias
Analise os requisitos de publicação em geral, com foco nos requisitos de integração. Consulte a referência do SDK do Playables para detalhes de implementação.
Por exemplo:
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)
Integrações recomendadas
Além das integrações necessárias, várias outras funções estão disponíveis para criar uma experiência altamente envolvente. Por exemplo:
ytgame.system.getLanguage(): use essa função para extrair a configuração de localidade atual do usuário. Não use outras funções nem armazene o idioma no Salvar na nuvem, porque ele pode mudar a qualquer momento.ytgame.engagement.sendScore({ value: newScore }): envie uma pontuação máxima para o YouTube exibir.ytgame.engagement.openYTContent({ id: videoID }): abra um vídeo do YouTube.ytgame.health.logError()eytgame.health.logWarning(): registre problemas no YouTube.
Consulte a referência do SDK do Playables para detalhes de implementação e outras funções.
Definições de tipo do TypeScript
Para jogos que usam o TypeScript, faça o download das definições de tipo.
Exemplos de jogos
Há exemplos disponíveis que demonstram 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, você poderá validar a integração usando o pacote de testes. Para saber como, siga o guia do pacote de testes.