Requisitos da integração

Esta seção aborda a integração entre a Sala de jogos e o YouTube SDK da Sala de jogos.

1 Carregar o SDK da Sala de jogos

2 Notificação de jogo pronto

  • O jogo PRECISA chamar firstFrameReady quando estiver renderizando um tela de carregamento ou de apresentação que se comunica explicitamente com o usuário que o processo de carregamento está em andamento.
  • O jogo PRECISA chamar gameReady e PRECISA chamar gameReady somente quando o jogo está pronto para a interação do usuário (exemplo: o menu principal ou o jogo está pronto para reproduzir).
  • O jogo NÃO PODE chamar gameReady enquanto ainda houver sem interagir elementos exibidos para o usuário (exemplo: telas de apresentação ou carregamento telas).

O YouTube não remove o "ícone de carregamento" até que a API seja chamada.

3 Pontuações do usuário

  • O jogo POD usar sendScore para enviar a pontuação do usuário.
  • Se o jogo usar o sendScore para enviar pontuações, ele PRECISA seguir as diretrizes. a especificação do sendScore e PRECISA garantir que a melhor pontuação seja enviada corresponde à melhor pontuação no defesa de jogo.

4 ações de salvar na nuvem

  • O jogo PRECISA chamar saveData para salvar o progresso quando os usuários terminarem Progresso do jogo (por exemplo, mudança de nível) em que o jogo levam o usuário a acreditar que o progresso foi salvo.
  • O jogo NÃO PODE usar nenhum outro mecanismo para salvar o progresso do usuário. Isso permite que os jogadores retomem o jogo em um momento posterior.
  • O jogo PRECISA aguardar loadData antes de chamar saveData. Se saveData é chamado antes da conclusão do loadData, o será rejeitada. Isso evita que o jogo substitua dados salvos anteriormente.
  • O jogo PRECISA usar dados salvos na nuvem de versões anteriores do jogo sem erros ou falhas.
  • O jogo DEVE usar os dados salvos na nuvem para manter o progresso do usuário em todos versões de jogos em que o usuário espera que os dados sejam usados.
  • Os jogos DEVEM salvar automaticamente o progresso do usuário em jogos importantes e marcos, para evitar a perda de dados. Um salvamento final é realizado quando um usuário sai do jogo, mas é o melhor esforço possível e só pode economizar até 64 KiB de conteúdo de tamanho.

5 Botão ativar som

  • O jogo PRECISA respeitar a configuração de áudio do sistema e o botão de desativar o som.
  • O jogo PRECISA respeitar a configuração de áudio do YouTube e o botão de desativar microfone usando o isAudioEnabled e onAudioEnabledChange.
  • O jogo PRECISA respeitar o controle de volume do dispositivo.
  • O som do jogo NÃO PODE tocar inesperadamente.
  • Quando o som do YouTube está configurado, o áudio NÃO PODE ser emitido e o do jogo controles NÃO PODEM afetar a saída de áudio.
  • Quando o som do YouTube não está configurado, os controles de áudio do jogo PODEM afetar o áudio saída.
  • O jogo NÃO DEVE mostrar um botão geral de desativação do som dentro do próprio jogo. os usuários podem contar com os recursos do YouTube para isso.
  • O jogo PODEM ter controles de áudio granulares separados, como para músicas e efeitos sonoros, mas eles PRECISAM seguir todos os outros controles de áudio e cumprimento de requisitos regulatórios.

Configurações de áudio diferentes para plano de fundo, efeito caixas de diálogo

6 Pausar e retomar

O SDK da Sala de jogos fornece callbacks que fornecem pausa e recursos de currículo.

  • O jogo PRECISA pausar toda a execução depois que onPause for chamado e PRECISA retomar a execução somente quando onResume for chamado. A execução inclui todas as Recursos jogáveis, como loop de jogo, música, interações e rede chamadas e renderização.
  • O jogo NÃO PODE usar a API Page Visibility da Web ou APIs da Web semelhantes, e PRECISA usar somente o SDK da Sala de jogos onPause e onResume.
  • O jogo DEVE salvar o progresso do usuário quando onPause ocorrer.