Publicar um jogo no YouTube Playables não é o mesmo que carregá-lo noutros portais web. O YouTube tem o seu próprio processo de certificação, uma revisão técnica obrigatória que todas as compilações têm de passar antes de entrarem no ar. Se a compilação reprovar, volta ao programador para correções, nova submissão e outra ronda de revisão. Cada ciclo custa tempo e esforço.
Na Mediacube, fazemos testes de pré-certificação a cada compilação antes de chegar ao YouTube. A nossa equipa de QA já reviu centenas de compilações em Unity, Cocos, Phaser, Construct e outros motores. Os erros listados neste artigo são os que vemos com mais consistência em estúdios de todas as dimensões, motores e géneros de jogo.
A maioria corrige-se depressa depois de saberes o que procurar. Lê isto antes de compilar, não depois.
Erro n.º 1: a pausa não pausa o jogo
Como se manifesta
Quando um jogador muda para outro separador, minimiza a aplicação ou o sistema pede uma pausa, o YouTube Playables envia um sinal de pausa ao jogo através do SDK. Muitos jogos respondem a este sinal mostrando o seu menu de pausa interno, mas o ciclo de jogo subjacente continua a correr. A física avança, os temporizadores continuam a contar decrescentemente, as animações prosseguem. Alguns elementos interativos continuam clicáveis no estado de pausa.
Outra variante: o jogo congela visualmente, mas guarda em fila as entradas durante o congelamento. Quando o jogo retoma, executa todas essas ações acumuladas de uma só vez — e uma personagem salta de repente três vezes seguidas, ou dispara uma arma que foi premida durante o ecrã de pausa.
Terceira variante (reportada com bastante frequência no nosso fluxo de QA): o jogo mostra corretamente o menu de pausa interno, mas os botões desse menu são totalmente clicáveis. A pausa oficial do Playables está ativa e o jogador pode aproveitar esse tempo para navegar nos menus, alterar definições ou até reiniciar o jogo.
Porque reprova na certificação
O contrato de pausa do SDK do Playables é rigoroso: quando ytgame.system.onPause() é acionado, o jogo tem de parar por completo e não executar animações, física, processamento de entradas nem temporizadores. Qualquer desvio é assinalado durante o processo de certificação do YouTube.
Como corrigir: regista o callback onPause e garante que para o ciclo de jogo, interrompe todas as animações, desativa o processamento de entradas e limpa quaisquer filas de ações pendentes. Em onResume, restaura o estado do ponto onde foi congelado: não repitas as entradas acumuladas. Testa isto de forma explícita acionando a pausa através do Playables Test Suite, e não apenas com o teu próprio botão de pausa do jogo.
Erro comum: tratar a pausa do SDK do YouTube como equivalente a premir o botão de pausa do teu jogo. Não são a mesma coisa. A pausa do SDK tem de parar tudo dentro do ciclo do motor do jogo.
Publica o teu jogo no YouTube
Publica jogos mais depressa, gere a monetização, recebe pagamentos rápidos e seguros em todo o mundo e conta com suporte técnico premium de uma equipa que ajuda os programadores a crescer globalmente.
Candidata-te agoraErro n.º 2: o estado de silêncio não é persistente
Como se manifesta
O YouTube pode silenciar o áudio de um jogo a qualquer momento através do SDK, por exemplo, quando o jogador está a ver um anúncio, muda de contexto ou tem o dispositivo em silencioso. O jogo deve respeitar este estado de silêncio e manter o áudio desligado até o YouTube o reativar explicitamente.
As falhas que vemos com mais frequência:
O silêncio repõe-se com eventos internos. O jogo silencia corretamente em resposta ao sinal do SDK, mas se o jogador abrir o menu de definições do jogo, clicar num botão de reinício ou passar para um novo nível, o silêncio é levantado. O áudio volta, mesmo que o YouTube ainda tenha o silêncio ativo.
O silêncio não sobrevive a um recarregamento da página. Se a página for atualizada enquanto o jogo está silenciado (via SDK), o jogo reinicia com o áudio ligado. O estado de silêncio foi guardado em memória, não persistido, por isso o recarregamento apaga-o.
O botão de silêncio interno anula o silêncio do SDK. O SDK silencia o jogo, mas o jogador pode premir o interruptor de áudio do jogo para recuperar o som. É o controlo do jogo que está a contornar o comando externo do SDK.
Porque reprova na certificação
O SDK do Playables disponibiliza ytgame.system.isAudioEnabled() para verificar o estado atual do áudio e ytgame.system.onAudioEnabledChange() para ouvir as alterações. Os jogos têm de recorrer a estes métodos em vez de gerirem o seu próprio estado de áudio paralelo, que pode ficar dessincronizado.
Como corrigir: inicializa o estado do áudio com ytgame.system.isAudioEnabled() no arranque do jogo, antes de reproduzir qualquer som. Regista onAudioEnabledChange e aplica o novo estado de imediato e globalmente quando for acionado. Persiste o estado de silêncio do SDK para que sobreviva aos recarregamentos: escreve-o em ytgame.game.saveData() para que o jogo o leia no arranque seguinte. Não permitas que os interruptores de áudio do jogo anulem o estado do SDK; o teu botão interno só deve funcionar quando o SDK tiver o áudio ativado.
Testa isto especificamente: silencia através do Test Suite, aciona todos os eventos do jogo que tiveres (menus, transições de nível, reinícios, mortes) e confirma que o áudio se mantém desligado do princípio ao fim. Depois atualiza a página e confirma que continua desligado após o recarregamento.
Erro n.º 3: o progresso não é guardado entre sessões
Como se manifesta
O jogador completa os níveis de 1 a 5, fecha o navegador, volta a abrir o jogo — e recomeça no nível 1 ou, pior, no tutorial. Nenhum progresso foi guardado. O jogo guardava o estado em localStorage ou numa variável de sessão, que são ambos apagados ao fechar ou não estão disponíveis no ambiente do Playables.
Porque reprova na certificação
O YouTube Playables não permite que os jogos usem o localStorage do navegador nem servidores de gravação externos. Todos os dados persistentes do jogo têm de passar pelo SDK do Playables: ytgame.game.saveData() e ytgame.game.loadData(). Os jogos que não o implementarem perdem o progresso do jogador em cada sessão, o que é motivo de rejeição imediata.
Como corrigir: substitui quaisquer chamadas a localStorage.setItem() / getItem() por ytgame.game.saveData() e ytgame.game.loadData(). Estas aceitam uma cadeia serializada até 3 MB — serializa o estado de gravação como JSON, carrega-o no arranque e escreve-o sempre que houver progresso relevante (nível concluído, ponto de controlo, conquista importante). Não esperes pelo fim da sessão para guardar e usa onPause como gatilho adicional de gravação, já que o jogo pode ser fechado a partir da pausa.
Se o teu jogo foi originalmente criado para telemóvel ou computador com um sistema de gravação na nuvem ou armazenamento do dispositivo, dedica tempo a refatorizar isto. É uma das fontes de atraso mais comuns na certificação de uma adaptação móvel no Playables.
Pronto para lançar no YouTube Playables?
Cria a tua conta e obtém tudo o que precisas para publicar, monetizar e fazer crescer o teu jogo globalmente.
ComeçarErro n.º 4: o jogo tenta carregar recursos a partir de URL externos
Como se manifesta
O jogo não carrega ou carrega parcialmente, com música em falta, recursos visuais em falta ou áudio silencioso, quando executado no ambiente do Playables. Na consola do navegador, vês erros de rede: pedidos a CDN externos, servidores de recursos, APIs de música em streaming ou fornecedores de tipos de letra de terceiros que estão a ser bloqueados.
Por vezes é óbvio (o jogo foi criado para transmitir a banda sonora a partir de um serviço externo) e por vezes é subtil (um tipo de letra web carregado do Google Fonts, um pixel de análise, um único atlas de sprites alojado num CDN que nunca foi incluído na compilação).
Porque reprova na certificação
O YouTube Playables funciona num ambiente isolado (sandbox). Não são permitidas chamadas a APIs externas nem pedidos a domínios exteriores. Tudo o que o jogo precisa para funcionar tem de estar incluído na própria compilação. Isto abrange: ficheiros de áudio, atlas de texturas, tipos de letra, cadeias de localização, ficheiros de configuração e quaisquer scripts de terceiros.
Como corrigir: antes de submeter, abre o separador Rede (Network) do navegador e percorre o jogo por completo: ecrã de carregamento, menu principal, jogabilidade, morte/fim de jogo, transições de nível. Filtra quaisquer pedidos dirigidos a domínios externos. Inclui esses recursos localmente ou, se forem serviços de terceiros (análise, anúncios que não sejam do SDK do YouTube), remove-os por completo. Repete a mesma verificação após qualquer atualização da compilação.
O SDK do YouTube Playables é a única dependência externa permitida. Tudo o resto tem de ser autónomo. Isto inclui a música. Se o teu jogo usa uma biblioteca de música em streaming, terás de incluir os ficheiros de áudio diretamente na compilação.
Erro n.º 5: os botões de anúncios com recompensa estão mal ligados
Como se manifesta
O programador adicionou um botão de anúncio com recompensa, muitas vezes como acrescento de última hora específico para o Playables, porque o jogo original não tinha mecânica de recompensa. O botão aparece na interface, parece correto, mas ao premi-lo não acontece nada. Nenhum anúncio é pedido e nenhuma recompensa é atribuída. Por vezes o botão aciona visualmente (uma animação de toque), mas a chamada a requestRewardedAd() está em falta, colocada num ponto errado do ciclo de vida ou a promessa não é tratada.
Uma falha relacionada: o anúncio com recompensa dispara, o utilizador vê o anúncio, mas a recompensa nunca chega a ser entregue — o valor devolvido isRewardEarned não é verificado, ou o código de entrega da recompensa está escrito mas nunca foi ligado ao manipulador do botão.
Porque reprova na certificação
A suite de testes de certificação do Playables verifica explicitamente que os pedidos de anúncios com recompensa completam o ciclo inteiro: o anúncio é pedido, mostrado, e a recompensa é atribuída condicionalmente com base no valor devolvido. Um botão que não produz um anúncio quando premido é uma falha de certificação.
Como corrigir: se os anúncios com recompensa são novos nas mecânicas do teu jogo, não os adiciones como elemento cosmético da interface e submetas. Primeiro constrói e testa o fluxo completo. Usa o Playables Test Suite em modo sandbox para verificar que o pedido de anúncio dispara, a promessa é resolvida e o ramo da recompensa é executado. Se o teu jogo realmente não tem nenhuma mecânica que suporte uma recompensa (sem moeda consumível, sem sistema de vidas, sem um momento que se possa saltar), pondera omitir os anúncios com recompensa em vez de implementares um esboço que não funciona.
Os anúncios com recompensa acrescentados à última hora especificamente para o Playables são a fonte mais comum de integrações de anúncios avariadas que vemos. Se estás a incorporar esta funcionalidade a posteriori, dá-lhe a mesma atenção de testes que darias à jogabilidade principal.
Erro n.º 6: as mudanças de orientação quebram o layout
Como se manifesta: duas variantes
Variante A: o conteúdo fica cortado. O jogo roda corretamente quando o dispositivo alterna entre vertical e horizontal, mas os elementos junto às margens ficam cortados. A tela (canvas) do jogo ajusta-se, mas a camada de interface não se reposiciona, por isso os botões ficam atrás da área segura, o texto fica parcialmente oculto ou a janela do jogo corta conteúdo que estava dentro dos limites antes da rotação.
Variante B: a tela roda, a interface não. O jogo adapta corretamente a tela à nova orientação, mas os ícones, os elementos do HUD e os botões ficam nas posições originais em píxeis, que agora estão erradas para as novas dimensões do ecrã. Num ecrã de telemóvel pequeno a passar para o modo vertical, um botão que tinha um tamanho confortável na horizontal torna-se uma área tátil minúscula que não responde.
Porque é importante
O YouTube Playables funciona numa grande variedade de dispositivos e proporções de ecrã. Os jogadores alternam entre orientações com fluidez. Um jogo que quebra ao mudar de orientação cria uma experiência frustrante e recebe uma pontuação de envolvimento mais baixa do algoritmo, o que afeta diretamente a descoberta.
Como corrigir: usa padrões de layout responsivo: ancora os elementos da interface às margens do ecrã com posicionamento relativo (percentagens ou flexbox), não com valores absolutos em píxeis. Testa ambas as orientações de forma explícita com a emulação de dispositivos das ferramentas de programador do navegador. Presta atenção às margens da área segura no telemóvel: o notch e a barra inferior podem alterar o espaço disponível entre orientações. Se o teu jogo foi concebido para uma só orientação, bloqueia-a explicitamente e comunica-o na submissão da compilação.
A gestão da orientação é fácil de esquecer durante o desenvolvimento, quando testas sobretudo num navegador de computador. Inclui-a na tua lista de testes habitual.
Erro n.º 7: o jogo continua a correr durante os anúncios intersticiais
Como se manifesta
Dispara um anúncio intersticial, a camada do anúncio aparece no ecrã, mas o jogo continua a correr em segundo plano. O jogador não consegue ver o que se passa, mas o ciclo de jogo continua ativo. Num jogo de puzzles, isto é ligeiramente irritante (o temporizador corre enquanto o jogador vê um anúncio). Num jogo de ação ou de sobrevivência, é um erro que acaba a sessão: a personagem sofre dano, os inimigos avançam e, quando o anúncio termina, o jogador está morto sem ter podido reagir.
Porque é importante
Os anúncios intersticiais exigem que a atenção do jogador esteja no anúncio, não no jogo. Um jogo que não pausa durante um anúncio penaliza o jogador pelo evento de monetização, o que é exatamente o oposto de uma boa experiência de jogador. O YouTube espera que os jogos pausem durante todos os eventos de anúncios.
Como corrigir: trata um pedido de anúncio intersticial da mesma forma que um sinal de pausa. Antes de chamares requestInterstitialAd(), guarda o estado do jogo e suspende o ciclo de jogo. Depois de a promessa ser resolvida (tenha sido ou não mostrado um anúncio), retoma. Trata os erros com a mesma lógica de retoma — o jogo nunca deve ficar num estado suspenso por causa de um erro de anúncio.
O padrão de implementação:
pauseGame(); // para o ciclo de jogo e as entradas try { await ytgame.ads.requestInterstitialAd(); } catch (e) { / tratar com elegância / } resumeGame(); // retoma sempre, independentemente do resultado
Isto é especialmente crítico para jogos de sobrevivência, endless runner, tower defense e qualquer género em tempo real em que o estado do jogo muda por si só ao longo do tempo. Se o teu tipo de jogo se enquadra nesta descrição, testa o fluxo do intersticial de forma explícita em condições de jogo reais.
Erro n.º 8: o jogo só funciona em ecrã inteiro
Como se manifesta
O jogo apresenta um ecrã preto, um ciclo de carregamento que nunca termina ou um layout distorcido quando é iniciado no leitor incorporado padrão do Playables. Ao abrir a mesma compilação em ecrã inteiro, tudo funciona corretamente. O jogo foi criado partindo do princípio de que o ecrã inteiro estaria disponível, e o leitor do Playables não o garante.
Isto é comum em compilações adaptadas de aplicações móveis que forçavam o arranque em ecrã inteiro, ou de jogos de computador em que o programador testava sempre com a janela do navegador maximizada.
Porque reprova na certificação
O YouTube Playables executa os jogos num contentor incorporado na interface do YouTube. O jogo tem de ser apresentado corretamente com as dimensões e a proporção que o contentor fornecer. O modo de ecrã inteiro pode estar ou não disponível consoante o dispositivo, a plataforma e o contexto do utilizador. Um jogo que precisa do ecrã inteiro para funcionar não pode passar na certificação.
Como corrigir: remove qualquer requisito de ecrã inteiro da inicialização do teu jogo. Desenha o layout para funcionar nas dimensões fornecidas pelo contentor. Usa os eventos de redimensionamento da tela e de mudança de orientação para te adaptares dinamicamente. Testa o teu jogo numa janela de navegador redimensionável com vários tamanhos. Se queres oferecer o ecrã inteiro como funcionalidade (como opção, não como requisito), implementa-o como um elemento opcional da interface, não como uma dependência de arranque.
Lista de verificação pré-submissão
Antes de nos enviares a tua compilação para a pré-certificação, percorre esta lista:
Pausa: aciona a pausa através do Playables Test Suite. Confirma que o ciclo de jogo para, as animações congelam, as entradas são bloqueadas e nenhuma ação em fila dispara ao retomar.
Silêncio: silencia através do Test Suite. Abre todos os ecrãs e aciona todos os eventos do jogo com o áudio silenciado. Atualiza a página enquanto está silenciado. Confirma que o áudio se mantém desligado do princípio ao fim.
Gravações: completa vários níveis, fecha o navegador por completo, volta a abrir e confirma que o progresso foi restaurado através de ytgame.game.loadData().
Rede: abre o separador Rede do navegador e percorre o jogo completo. Zero pedidos a domínios externos (exceto o SDK do YouTube). Inclui tudo localmente.
Anúncios com recompensa: se os implementaste, prime cada botão de anúncio com recompensa e confirma o ciclo completo: anúncio pedido, anúncio mostrado (no sandbox do Test Suite), recompensa entregue.
Orientação: testa na vertical e na horizontal com a emulação de dispositivos móveis. Todos os elementos da interface têm de estar visíveis, com o tamanho correto e totalmente tocáveis em ambas as orientações.
Intersticiais: aciona um intersticial durante o jogo ativo. Confirma que o jogo pausa antes do anúncio e retoma corretamente depois.
Tamanho do contentor: testa numa janela de navegador que não esteja em ecrã inteiro com vários tamanhos. O jogo tem de ser apresentado corretamente sem exigir o modo de ecrã inteiro.
Como te ajudamos a passar a certificação mais depressa
Quando publicas através da Mediacube, fazemos uma revisão completa de pré-certificação com a nossa plataforma interna MC Play antes de a tua compilação chegar ao YouTube. A nossa equipa de QA verifica todos os pontos da lista acima e apanha os problemas antes de se tornarem ciclos de rejeição.
O nosso prazo mais rápido da compilação ao lançamento é de 3 dias úteis. Uma compilação bem preparada e sem problemas de QA costuma entrar no ar em uma semana. Se forem encontrados problemas durante a pré-certificação, entregamos-te um relatório detalhado (erros concretos, passos para os reproduzir e correções recomendadas) para que a tua equipa saiba exatamente o que tratar.
Somos parceiro oficial do YouTube desde 2015 e publicamos no Playables desde setembro de 2025. Todos os jogos do nosso portefólio passaram por este processo. Sabemos o que a equipa de certificação do YouTube procura e sabemos como fazer as compilações passar.
Começa a conversa e candidata-te aqui.




