Como Configurar para Jogos Mobile Godot 4

Como Configurar para Jogos Mobile Godot 4

Para um jogo 2D no Godot 4, normalmente você vai querer usar a opção CanvasItem. Vamos configurar corretamente para evitar as barras pretas e manter a proporção.

    Vá para Project Settings e depois em Display > Window:
        Stretch Mode: Selecione CanvasItem.
        Stretch Aspect: Escolha Expand ou Keep Height.

Explicação das Opções:

    Expand:
        Essa opção ajusta o conteúdo para preencher a tela completamente, sem deixar bordas pretas.
        O conteúdo pode ser cortado nos lados esquerdo e direito ou superior e inferior, dependendo da proporção da tela.

    Keep Height ou Keep Width:
        Mantém a altura ou a largura do jogo em proporção, adicionando bordas (barras pretas) se necessário para evitar distorção.
        Se estiver vendo barras pretas, é porque o Stretch Aspect está em Keep Width ou Keep Height. Nesse caso, experimente Expand.

Código para Adaptação Dinâmica

Caso você queira adaptar a resolução dinamicamente e garantir que o jogo sempre preencha a tela, você pode usar um script para ajustar a escala no _ready():

gdscript

# Ajuste o tamanho do root viewport para preencher a tela
get_tree().root.set_size(DisplayServer.window_get_size())

# Defina a escala do conteúdo para preencher a tela, se necessário
get_window().content_scale_size = DisplayServer.window_get_size()

Recomendação para Evitar Bordas Pretas:

    Use Stretch Aspect = Expand:
        Essa configuração fará com que o conteúdo do jogo preencha toda a tela do dispositivo, evitando as barras pretas.

    Ajuste content_scale_size apenas se você precisa manter uma resolução fixa durante o desenvolvimento. Em dispositivos móveis, o ideal é que o jogo se adapte à resolução da tela sem ajustes manuais, para garantir a melhor performance e clareza visual.

    Certifique-se de que não haja configuração adicional no seu código ou nas Viewport Settings que esteja aplicando bordas ou alterando o comportamento de escalamento.

Configuração Final Sugerida:

    Project Settings > Display > Window:
        Stretch Mode: CanvasItem
        Stretch Aspect: Expand

Com isso, o jogo deve preencher a tela do dispositivo completamente e evitar as barras pretas. Se ainda estiver vendo bordas ou esticamento, me avise para que possamos ajustar mais a configuração ou script!