Este documento descreve como oferecer suporte a vários formatos e tamanhos de tela ao usar o Godot para o desenvolvimento de jogos Android.
Os dispositivos Android têm vários formatos e tamanhos de tela. Estas são algumas das categorias comuns:
- Smartphones
- Dispositivos dobráveis
- Tablets
- Televisores e conversores
- Laptops com Android Runtime para Chrome
Essa variedade significa que seu jogo encontrará diversas resoluções de tela diferentes. Essas resoluções da tela geralmente têm proporções diferentes. Por exemplo:
- Um smartphone na orientação paisagem com uma proporção de 19:9 (2.280 x 1.080)
- Um smartphone diferente na orientação paisagem com proporção de 20:9 (3.200 x 1.400).
- Uma tela interna desdobrada com proporção de 1:1 (2106 x 2106) ou 4:3 (2688 x 2016)
- Uma televisão de alta definição de 1.080p com proporção de 16:9 (1.920 x 1.080)
- Um tablet com proporção 4:3 (2.048 x 1.536)
O design do jogo precisa considerar essas diferenças para garantir uma apresentação correta, independentemente da resolução da tela, da proporção do dispositivo e do método de entrada do usuário.
Resolução da tela
O Godot define o tamanho e a resolução da tela usando pixels. Recomendamos que você defina uma resolução básica padrão para os projetos do Godot. O Godot tem configurações para controlar o comportamento quando as resoluções de tela são diferentes da resolução base do projeto.
Como definir a resolução básica
Para definir uma resolução básica em um projeto aberto no editor do Godot, execute as seguintes etapas:
- Selecione Project > Configurações do projeto na barra de menus do Godot.
- Na janela Configurações do projeto, encontre a lista Display na guia Category e selecione o item Window.
- Na categoria Size, defina os campos Width e Height como a resolução de base que você quer, medida em pixels.
Quando o editor do Godot é definido como visualização em 2D, ele exibe um retângulo de guia correspondente à resolução básica. A resolução básica é usada como dimensões padrão da janela do projeto durante a execução de um projeto ou uma cena do editor.
Configurações de alongamento
Duas configurações controlam como a resolução base é ajustada quando ela é diferente da resolução da tela: Modo de alongamento e Aspecto de alongamento. Essas configurações estão na janela Project Settings, na seção Display > Window.
O Stretch Mode tem três configurações: disabled, 2d e viewport. A próxima
seção inclui exemplos visuais de diferentes configurações de Proporção de alongamento e Modo de
alongamento. Todos os exemplos usam uma resolução básica de projeto de 320 x 180 pixels.
A configuração disabled não redimensiona nem ajusta a resolução de base. O valor
de Aspecto de alongamento é sempre ignorado se o Modo de alongamento estiver definido como
disabled.
disabled com uma resolução de tela de 320 x 180Se a resolução da tela for menor que a resolução base, as bordas inferior, direita ou ambas serão cortadas.
disabled com uma resolução de tela de 256 x 128Se a resolução de tela for maior que a resolução básica, a região extra será deixada em branco.
disabled com uma resolução de tela de 512 x 256A configuração 2d dimensiona a resolução básica para a resolução da tela. Para
projetos que usam arte 2D, isso resulta em artefatos de dimensionamento, porque não
há mais uma proporção de pixel de 1:1 entre a resolução de base e de exibição. Essa
configuração pode ser adequada para determinados estilos de arte de alta resolução em
projetos em que a renderização perfeita de pixels não é necessária.
A configuração Stretch Aspect especifica as restrições aplicadas ao escalonamento para
manter a proporção da resolução básica. As opções de configuração de Proporção de alongamento
são descritas na seção "Proporção". Confira abaixo exemplos da configuração
2d Modo de alongamento usando um Aspecto de alongamento de ignore, que
é dimensionado para a resolução da tela sem restrições:
2d com uma resolução de tela de 256 x 128
2d com uma resolução de tela de 512 x 256A configuração viewport define o Viewport da cena raiz como a resolução base.
A saída renderizada do Viewport raiz é dimensionada para a resolução
da tela. Os objetos Viewport do Godot são usados para criar visualizações na tela
ou subvisualizações dentro de outro Viewport. Ao contrário da configuração 2d, a
viewport não aplica filtragem ao dimensionar para a resolução
da tela. A configuração viewport também usa o valor de Stretch Aspect para
determinar se as restrições são aplicadas ao dimensionamento para preservar a proporção. A configuração viewport é uma opção melhor do que 2d quando
é necessária uma precisão perfeita de pixels, já que a renderização principal ainda ocorre na
resolução de base. Confira abaixo exemplos da configuração viewport do Modo de alongamento
usando um Aspecto de alongamento de ignore:
viewport com uma resolução de tela de 256 x 128
viewport com uma resolução de tela de 512 x 256Proporção
O Stretch Aspect tem várias opções para restringir o escalonamento de proporção. Se
Stretch Aspect estiver definido como ignore, nenhuma restrição será aplicada. Quando
Stretch Aspect é definido como keep, a resolução base é dimensionada para as
maiores dimensões possíveis que se ajustam à resolução da tela, mantendo
a proporção original. As regiões da tela que não são cobertas pela
imagem dimensionada são preenchidas com barras pretas. Dependendo da dimensão dominante da
diferença de proporção, as barras serão horizontais, isto é, com efeito letterbox, ou verticais, com efeito pillarbox.
viewport, proporção de alongamento keep, com uma resolução de tela de 384 x 256
viewport, proporção de alongamento keep, com uma resolução de tela de 512 x 200O Stretch Aspect inclui duas variantes da configuração keep: keep_width e
keep_height. Quando keep_width é definido, o efeito pillarbox é adicionado se a resolução da tela
tem uma proporção maior que a resolução de base. No entanto, se a
resolução da tela tiver uma proporção mais alta do que a básica, a área extra
ficará vazia. A região vazia preenche a parte inferior da tela.
viewport, Aspecto de alongamento keep_width, com uma resolução de tela de 512 x 384A configuração keep_height funciona na direção horizontal em vez da
direção vertical. A região vazia preenche o lado direito da tela.
viewport, proporção de alongamento keep_height, com uma resolução de tela de 512 x 200A configuração final de Stretch Aspect é expand. A configuração expand mantém
a proporção da resolução de base, mas deixa a região excedente vazia em vez de
usar letterbox ou pillarbox.
viewport, proporção de alongamento expand, com uma resolução de tela de 384 x 256
viewport, Aspecto de alongamento expand, com uma resolução de tela de 512 x 256Âncoras
O posicionamento dos elementos da interface exige considerações adicionais ao oferecer suporte
a várias resoluções de tela. Por exemplo, o uso de coordenadas absolutas de pixel para
colocar um controle no canto superior direito resulta em um posicionamento inconsistente em
dispositivos com diferentes resoluções horizontais. O sistema de interface do Godot é compatível com
o posicionamento relativo com as propriedades Anchor e Margin. As propriedades Anchor
de um elemento da interface especificam um ponto de fixação no objeto de controle pai
ou na janela de visualização. Os valores das propriedades Margin são usados para deslocar o controle em relação ao ponto de fixação.
Um objeto precisará derivar do objeto Godot Control se for incluir as
propriedades Anchor e Margin. Todos os elementos da interface padrão do Godot derivam de
Control. Os campos de propriedade de Anchor e Margin aparecem na guia Inspector
quando um objeto derivado de Control é selecionado no editor do Godot.
Button selecionado, com as propriedades Anchor e Margin visíveis no inspetorO Godot tem uma ferramenta Layout que pode definir rapidamente as propriedades Anchor, Margin e Size
para os valores predefinidos comumente usados. Quando um objeto derivado de Control é
selecionado no editor, o menu suspenso Layout fica disponível na
barra de ferramentas acima da visualização de cena. As predefinições da ferramenta Layout incluem posicionamento
e posicionamento combinado com tamanho. As predefinições de posicionamento são compatíveis com casos de uso
como: centralizado, ancoragem no canto superior direito, ancoragem na parte central esquerda. As
predefinições de posicionamento mais tamanho incluem casos de uso como ancoragem na parte inferior e, ao mesmo tempo, toda a extensão da largura do pai.
Âncoras são adequadas para casos de uso comuns, como avisos na tela, solicitações na tela ou caixas de diálogo básicas. O sistema de contêineres do Godot é destinado a layouts de interface mais sofisticados, como ao exibir janelas ou caixas de diálogo com um grande número de controles ou ao redimensionar conteúdo de forma dinâmica.
Campo de visão
O Godot tem configurações de campo de visão que controlam a apresentação de uma cena 3D em
diferentes proporções. Os ajustes de campo de visão são controlados pela propriedade Keep
Aspect de um objeto Camera. O valor padrão de Keep Height é
destinado a projetos executados em orientação paisagem. Keep Height se ajusta
a um campo de visão mais amplo ou mais estreito quando as proporções da resolução
base e da resolução da tela são diferentes. A configuração Keep Width é
melhor para projetos executados na orientação retrato. Keep Width
se ajusta a um campo de visão mais alto ou mais baixo com base na diferença na proporção.
Controle da janela de visualização
Os objetos Viewport fornecem controle detalhado sobre a proporção e o escalonamento.
Os projetos podem usar janelas de visualização para realizar operações como:
- renderizar uma cena na proporção de resolução básica com uma borda independente de resolução;
- renderizar uma cena 3D com resolução reduzida para melhorar o desempenho e exibi-la na resolução nativa de alta qualidade;
- renderizar visualizações esquerda e direita de uma cena para aplicativos de RV;
- gerar texturas dinâmicas.
Para ver exemplos que demonstram como usar o objeto Viewport, consulte os exemplos de Viewport do Godot (link em inglês).
Entrada do usuário
Alguns designs de jogos não são compatíveis com todos os modos de entrada aceitos pelo Android. Os jogos compatíveis com gestos multitoque costumam ter problemas para adicionar compatibilidade com a entrada de controles de jogos e de mouse. Os jogos projetados para entrada de controles de jogos podem ter dificuldades em implementar controles por toque eficazes. O Godot é compatível com todas essas formas de entrada. No entanto, você precisa decidir no início do desenvolvimento quais métodos de entrada pretende usar no projeto e fazer o design adequado.
Para projetos em que a entrada de toque e a entrada do mouse são intercambiáveis, o Godot inclui opções de proxy que geram eventos de toque emulados de eventos de mouse ou eventos de mouse emulados de eventos de toque. Essas opções eliminam a necessidade de escrever um código de processamento de entrada separado para eventos de mouse e toque. Há duas opções disponíveis: Emulate Touch from Mouse e Emulate Mouse from Touch. As duas opções estão localizadas em Project Settings, em Input Devices > Pointing.
Outros recursos
- Documentação do Godot: tamanho e âncoras
- Documentação do Godot: janelas de visualização
- Perguntas frequentes sobre o Godot: várias resoluções
- Exemplo do Godot: escalonamento da janela de visualização em 3D
- Tutorial do Godot: contêineres
- Tutorial do Godot: várias resoluções