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.
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
Para salir del modo de compatibilidad y evitar que se vuelva a crear la actividad, haz lo siguiente:
Declara que se puede cambiar el tamaño de tu actividad principal:
<android:resizeableActivity="true" />Declara la compatibilidad explícita con "orientation", "screenSize", "smallestScreenSize", "screenLayout" y "density" en el atributo
android:configChangesdel 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" />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:
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); }