Admite el cambio de tamaño de pantallas grandes

Expandir tu juego de teléfonos a diferentes factores de forma de pantalla grande presenta consideraciones sobre cómo tu juego controla la administración de ventanas. En Googlebook, ChromeOS y Google Play Juegos para PC, tu juego se puede ejecutar en modo de ventana sobre una interfaz de escritorio principal. En las nuevas tablets y dispositivos plegables Android que ejecutan Android 12L (nivel de API 32) o versiones posteriores con un ancho de pantalla superior a 600 dp, tu juego puede ejecutarse en paralelo en el modo de pantalla dividida con otras aplicaciones, cambiar de tamaño y, incluso, moverse entre la pantalla interna y externa en dispositivos plegables, lo que genera un cambio de configuración para el tamaño de la ventana y, en algunos dispositivos, la orientación.

Cambio de tamaño en juegos de Unity

Configuración básica de pantallas grandes

Declara si tu juego puede controlar el cambio de tamaño:

<android:resizeableActivity="true" or "false" />

Si no puedes admitir la capacidad de cambio de tamaño, asegúrate de que el manifiesto del juego defina de forma explícita las relaciones de aspecto mínimas y máximas admitidas:

<!-- Render full screen between 3:2 and 21:9 aspect ratio -->
<!-- Let the platform letterbox otherwise -->
<activity android:minAspectRatio="1.5">
<activity android:maxAspectRatio="2.33">

Google Play Juegos para PC

En Google Play Juegos para PC, la plataforma controla el cambio de tamaño de la ventana y, al mismo tiempo, respeta la relación de aspecto especificada. El tamaño de la ventana se bloquea automáticamente en las dimensiones óptimas. Debes admitir, al menos, la relación de aspecto de 16:9 si la orientación principal es horizontal y la de 9:16 si el juego está en modo Retrato. Para obtener la mejor experiencia, admite explícitamente las relaciones de aspecto 21:9, 16:10 y 3:2 en un juego horizontal. Aquí no se requiere la capacidad de cambiar el tamaño de la ventana, pero es bueno tenerla para la compatibilidad con otros factores de forma.

Para obtener más información y conocer las prácticas recomendadas, consulta Cómo configurar gráficos para Google Play Juegos para PC.

Pantallas grandes

Para maximizar el área visible de tu juego en pantalla completa en tablets de pantalla grande, dispositivos plegables, Googlebook, ChromeOS y pantallas conectadas, admite el modo envolvente de pantalla completa y oculta las barras del sistema configurando marcas en decorView, la visibilidad de la IU del sistema o a través de la API de WindowInsetsCompat. También querrás controlar correctamente los eventos de configuración de rotación y cambio de tamaño, o bien evitar que ocurran.

Ten en cuenta que, en los dispositivos Android con pantalla grande, tu juego se puede ejecutar en configuraciones que quizás aún no controles. Si tu juego no admite todas las configuraciones de tamaño de ventana y orientación, la plataforma lo mostrará en formato de pantalla panorámica en el modo de compatibilidad y, si es necesario, le indicará al jugador que cambie a una configuración compatible.

Figura 1: Cuadro de diálogo de compatibilidad de configuración.

En algunos dispositivos, cuando un jugador cambia a una configuración no compatible, es posible que se le solicite que vuelva a cargar el juego y recree la actividad para que se adapte mejor al nuevo diseño de la ventana, lo que interrumpe la experiencia de juego. Prueba tu juego en varias configuraciones del modo multiventana (tamaño de ventana de 2/3, 1/2 y 1/3) y verifica que no se corten ni queden inaccesibles los elementos de la IU o del juego. Además, prueba cómo responde tu juego a la continuidad de plegado cuando se mueve entre la pantalla interior y la exterior en dispositivos plegables. Si ves problemas, controla de forma explícita estos eventos de configuración y agrega compatibilidad avanzada para cambiar el tamaño de la pantalla grande.

Capacidad avanzada de cambio de tamaño de la pantalla grande

Figura 2: Diferentes IU en computadoras de escritorio y dispositivos plegables en posición de mesa.

Para salir del modo de compatibilidad y evitar que se vuelva a crear la actividad, haz lo siguiente:

  1. Declara que se puede cambiar el tamaño de tu actividad principal:

    <android:resizeableActivity="true" />
    
  2. Declara la compatibilidad explícita con "orientation", "screenSize", "smallestScreenSize", "screenLayout" y "density" en el atributo android:configChanges del elemento <activity> del manifiesto de tu juego para recibir todos los eventos de configuración de pantalla grande:

    <android:configChanges="screenSize | smallestScreenSize | screenLayout | orientation | keyboard |
                            keyboardHidden | density" />
    
  3. Anula onConfigurationChanged() y controla el evento de configuración, incluidos la orientación, el tamaño de la ventana, el ancho y la altura actuales:

    Kotlin

    override fun onConfigurationChanged(newConfig: Configuration) {
       super.onConfigurationChanged(newConfig)
       val density: Float = resources.displayMetrics.density
       val newScreenWidthPixels =
    (newConfig.screenWidthDp * density).toInt()
       val newScreenHeightPixels =
    (newConfig.screenHeightDp * density).toInt()
    
       // Configuration.ORIENTATION_PORTRAIT or ORIENTATION_LANDSCAPE
       val newScreenOrientation: Int = newConfig.orientation
    
       // ROTATION_0, ROTATION_90, ROTATION_180, or ROTATION_270
       val newScreenRotation: Int =
    windowManager.defaultDisplay.rotation
    }

    Java

    @Override
    public void onConfigurationChanged(Configuration newConfig) {
       super.onConfigurationChanged(newConfig);
       float density = getResources().getDisplayMetrics().density;
       int newScreenWidthPixels = (int) (newConfig.screenWidthDp * density);
       int newScreenHeightPixels = (int) (newConfig.screenHeightDp * density);
    
       // Configuration.ORIENTATION_PORTRAIT or ORIENTATION_LANDSCAPE
       int newScreenOrientation = newConfig.orientation;
    
       // ROTATION_0, ROTATION_90, ROTATION_180, or ROTATION_270
       int newScreenRotation = getWindowManager().getDefaultDisplay()
               .getRotation();
    }

También puedes consultar WindowManager para verificar la rotación actual del dispositivo. Con estos metadatos, verifica las dimensiones de la ventana nueva y renderiza el tamaño completo de la ventana. Es posible que esto no funcione en todos los casos debido a las diferencias en la relación de aspecto, por lo que, como alternativa, puedes fijar la IU del juego al nuevo tamaño de la ventana y aplicar el formato de pantalla panorámica al contenido principal del juego. Si hay limitaciones técnicas o de diseño que impiden cualquiera de los enfoques, haz tu propio formato letterbox o pillarbox en el motor mientras mantienes resizeableActivity="true" para que el juego se ajuste a la ventana sin ingresar al modo de compatibilidad de la plataforma.

Independientemente del enfoque que adoptes, prueba tu juego en varias configuraciones (plegado y desplegado, diferentes cambios de rotación, modo de pantalla dividida) y asegúrate de que no haya elementos de la IU del juego cortados o superpuestos, problemas con la accesibilidad de los objetivos táctiles o problemas de relación de aspecto que hagan que el juego se estire, se aplaste o se distorsione de alguna otra manera.

Además, las pantallas más grandes suelen tener píxeles más grandes, ya que tienen la misma cantidad de píxeles para un área mucho más grande. Esto puede causar pixelación en los búferes de renderización reducidos o en los recursos de menor resolución. Usa tus recursos de mayor calidad en dispositivos con pantallas grandes y crea un perfil de rendimiento para tu juego para asegurarte de que no haya problemas. Si tu juego admite varios niveles de calidad, asegúrate de que tenga en cuenta los dispositivos de pantalla grande.

Modo multiventana

El modo multiventana permite que varias apps compartan la misma pantalla al mismo tiempo. El modo multiventana no cambia el ciclo de vida de la actividad. Sin embargo, el estado reanudado de las apps en varias ventanas difiere según la versión de Android (consulta Ciclo de vida de la actividad en el modo multiventana en Cómo admitir el modo multiventana).

Cuando el jugador coloca una app o un juego en el modo multiventana, el sistema notifica a la actividad sobre un cambio de configuración, como se especifica en la sección Capacidad de cambio de tamaño avanzada para pantallas grandes. También se produce un cambio de configuración cuando el jugador cambia el tamaño del juego o lo vuelve a poner en modo de pantalla completa.

No se garantiza que la aplicación recupere el foco cuando se establezca en el modo multiventana. Por lo tanto, si usas alguno de los eventos de estado de la app para pausar el juego, no confíes en el evento de adquisición de enfoque (onWindowFocusChanged() con el valor de enfoque como verdadero) para reanudar el juego. En su lugar, usa otros controladores de eventos o de cambio de estado, como onConfigurationChanged() o onResume(). Ten en cuenta que siempre puedes usar el método isInMultiWindowMode() para detectar si la actividad actual se ejecuta en el modo multiventana.

Con el modo de ventanas de escritorio en Googlebook, ChromeOS y tablets y dispositivos plegables de pantalla grande, las dimensiones iniciales de la ventana se convierten en una consideración importante. No es necesario que un juego se ejecute en pantalla completa, y querrás declarar cuál debería ser el tamaño de la ventana en ese caso. Existen dos maneras recomendadas de abordar este problema.

La primera opción funciona con atributos específicos en la etiqueta <layout> del manifiesto de Android. Los atributos defaultHeight y defaultWidth controlan las dimensiones iniciales. También ten en cuenta los atributos minHeight y minWidth para evitar que los jugadores cambien el tamaño de la ventana del juego a dimensiones que no admitas. Por último, está el atributo gravity, que determina en qué parte de la pantalla aparece la ventana cuando se inicia. Este es un ejemplo de una etiqueta de diseño que usa estos atributos:

<layout android:defaultHeight="500dp"
        android:defaultWidth="600dp"
        android:gravity="top|end"
        android:minHeight="450dp"
        android:minWidth="300dp" />

La segunda opción para establecer el tamaño de la ventana consiste en usar límites de inicio dinámicos. Con setLaunchBounds(Rect)⁠⁠, puedes definir las dimensiones de la ventana de inicio. Si se especifica un rectángulo vacío, la actividad se inicia en un estado maximizado.

Además, si usas los motores de juegos Unity o Unreal, asegúrate de usar una versión reciente (Unity 2019.4.40 y Unreal 5.3 o posterior) que proporcione una buena compatibilidad con el modo multiventana.

Compatibilidad con posiciones plegables

Usa la biblioteca de diseño de WindowManager de Jetpack para admitir posiciones de plegado, como el modo de mesa, y aumentar la inmersión y la participación de los jugadores:

Figura 3: Juego en postura de mesa con la vista principal en la parte vertical de la pantalla y los controles en la parte horizontal.

Kotlin

fun isTableTopPosture(foldFeature : FoldingFeature?) : Boolean {
    contract { returns(true) implies (foldFeature != null) }
    return foldFeature?.state == FoldingFeature.State.HALF_OPENED &&
            foldFeature.orientation == FoldingFeature.Orientation.HORIZONTAL
}

Java

boolean isTableTopPosture(FoldingFeature foldFeature) {
    return (foldFeature != null) &&
           (foldFeature.getState() == FoldingFeature.State.HALF_OPENED) &&
           (foldFeature.getOrientation() == FoldingFeature.Orientation.HORIZONTAL);
}