Este tópico responde a perguntas comuns sobre o desenvolvimento para o Google Play Games.
P: Posso manter os anúncios do SDK de anúncios no meu jogo desde que não os exiba no PC?
R: Sim. Para ver mais informações, consulte o guia de Experiência do jogador.
P: Existe um limite de tamanho para um upload do Google Play Games?
R: Para o formato de pacote de apps, o limite é de 150 MB da base + 2 GB com o Play Asset Delivery. Se isso não for suficiente, fale com seu ponto de contato do Google Play.
P: E se o jogo for projetado no modo retrato e não puder ser adaptado para uma proporção de paisagem?
R: Se você não fizer nada, barras pretas serão exibidas nos dois lados da tela do jogo. Recomendamos que você adicione uma imagem de plano de fundo para preencher a área vazia. Veja um exemplo:
P: E se o HPE não for iniciado?
R: Veja a seguir algumas etapas rápidas de depuração que você pode testar.
- Confira se o Windows foi atualizado com o patch de maio de 2020 ou mais recente.
- Confira se você não moveu o HPE. Ele precisa estar na unidade "C:".
- Fale com seu ponto de contato do Google Play. Também é necessário enviar todos os arquivos de registros disponíveis para garantir uma correção rápida.
P: Como faço para configurar minha faixa de testadores corretamente?
R: Consulte o guia de desenvolvimento no Android.
P: Meu jogo só oferece suporte a builds x86 em vez de x86-64. Ainda posso cumprir os requisitos de 64 bits do Google Play?
R: No Google Play Games, é possível enviar um executável x86 de 32 bits.
P: Como faço para coletar os arquivos de registro?
R: Os arquivos de registro são armazenados em %LocalAppData%\Google\HPE_Dev
e todos terminam com
a extensão de arquivo .log
. Normalmente, esse caminho é aberto em
C:\Users\<username>\AppData\Local\Google\HPE_Dev
, embora possa variar no seu
sistema. Se quiser coletar rapidamente todos os arquivos de registros e arquivá-los para
enviar ao seu ponto de contato do Google Play, use este comando do PowerShell:
Compress-Archive -Path $env:LocalAppData\Google\HPE_Dev\*.log -DestinationPath
HpeLogs.zip
P: Como posso me reconectar ao emulador se ele desaparecer de adb devices
?
R: O emulador se conecta pela porta 6520 do localhost. Execute este comando para se reconectar:
adb connect localhost:6520
P: O que é a filtragem de visibilidade de pacotes e por que preciso adicionar uma tag <queries>
?
A visibilidade de pacotes se aplica a qualquer jogo ou aplicativo destinado ao Android 11 (nível 30 da API). Em muitos casos, as versões do Google Play Games são a primeira experiência de interação dos desenvolvedores com as regras de visibilidade de pacotes. Com o novo sistema, os desenvolvedores precisam declarar explicitamente os pacotes com que pretendem interagir, a menos que se trate de um pacote automaticamente visível.
P: Como soluciono o erro requires the Google Play Store, but it is missing ou por que recursos como o faturamento funcionam quando instalo o jogo pela Play Store, mas não quando transfiro o jogo por sideload?
As novas regras de visibilidade de pacotes poderão impedir que seu jogo
acesse o Google Play Services se ele não for instalado pela Play Store. Para resolver isso,
adicione uma consulta ao pacote "com.android.vending"
no
arquivo AndroidManifest.xml
:
<manifest>
<queries>
<package android:name="com.android.vending" />
</queries>
</manifest>
P: Preciso implementar o redimensionamento de janela no Google Play Games?
Não.
P: Posso alternar o modo do mouse entre a entrada bruta e a emulação da tela touchscreen no emulador do Google Play Games?
R: Para alternar entre o modo de tela touchscreen simulada e as entradas "brutas" do mouse, use o menu de contexto no ícone da barra de tarefas HPE_Dev:
Clique com o botão direito do mouse, selecione "Opções do desenvolvedor" e escolha o modo de entrada que você quer simular em "Modo de entrada do mouse".
Na experiência do jogador, declarar que seu jogo usa o recurso android.hardware.type.pc
vai mudar o modo automaticamente, da mesma forma que acontece no Chrome OS.
<uses-feature
android:name="android.hardware.type.pc"
android:required="false" />
P: Por que o login automático dos serviços relacionados a jogos do Google Play v2 falha em um dispositivo móvel?
R: No momento, há duas dependências para que o login nos Serviços relacionados a jogos do Google Play v2 funcione em um dispositivo: GMS Core e app Play Games.
A versão do GMS Core precisa ser posterior à 21.30.xx. Para verificar a versão, use o seguinte comando:
$ adb shell dumpsys package com.google.android.gms | grep -i -e "versionCode" -e "versionName" versionCode=213016046 minSdk=30 targetSdk=31 versionName=21.30.16 (150400-391784508) versionCode=202117048 minSdk=30 targetSdk=30 versionName=20.21.17 (150408-316502805)
O primeiro
versionName
é a versão a ser verificada. A atualização do GMS Core precisa ser enviada automaticamente para o dispositivo Android. Caso contrário, informe nossa equipe.A versão do app Google Play Games precisa ser 2021.08.29094 ou mais recente. Para verificar a versão, acesse Configurações > Apps, selecione o app Play Games e veja o número da versão na parte inferior da página de detalhes.
Não é mais necessário transferir o app Play Games por sideload para testar os Serviços relacionados a jogos do Google Play v2. A versão necessária já está disponível nos dispositivos dos usuários.
P: Posso usar a Frame Pacing no Google Play Games ou por que meu jogo do Unity falha ao iniciar?
R: O Google Play Games oferece suporte à biblioteca Frame Pacing, mas a versão incluída no jogo Unity causa uma falha ao iniciar. Caso você use o mecanismo de jogos do Unity, procure a opção de build "Optimize Frame Pacing" e verifique se ela está desativada.
P: É possível permitir que os jogadores façam upload de imagens armazenadas localmente no Google Play Games?
R: No momento, o emulador não tem uma abstração significativa do sistema de arquivos local
para permitir a escolha ou agregação de imagens armazenadas no computador de um jogador. Se você usa a
Intent.ACTION_PICK
com a
MediaStore.Images.Media
,
remova esse código em builds do Google Play Games por enquanto.