Motores nativos y propios

Cómo empezar a usar Vulkan en Android

Vulkan es la principal API de gráficos de bajo nivel de Android. Vulkan proporciona un rendimiento óptimo para los juegos que implementan su propio motor y procesador.

Para implementar Vulkan, de forma correcta, en tu motor de juego, debes hacer lo siguiente:

• Identificar qué dispositivos Android usar con Vulkan
• Comprender las ventajas y desventajas de admitir dispositivos Android más antiguos
• Agregar Vulkan a tu destino de compilación de Android
• Seleccionar un compilador de sombreadores para crear SPIR-V para Vulkan
• Determinar la versión disponible de la API de Vulkan durante el tiempo de ejecución
• Aprender a optimizar tus operaciones de renderización de Vulkan con el ritmo de fotogramas, la rotación previa y los perfiles de Vulkan
• Seleccionar herramientas gráficas para depurar y analizar el rendimiento

Nota: Si deseas obtener información para usar Vulkan en Android con los motores de juegos Unity o Unreal, consulta lo siguiente:
• Vulkan en Unity
• Vulkan en Unreal

Cómo elegir especificaciones mínimas de dispositivos para Vulkan

Vulkan está disponible en Android a partir de Android 7.0 (nivel de API 24). No todos los dispositivos Android que ejecutan Android 7.0 o versiones posteriores son compatibles con Vulkan. Debes determinar qué dispositivos Android compatibles con Vulkan admite tu juego.

Recomendaciones

Usa las siguientes especificaciones como requisitos mínimos para la compatibilidad con Vulkan:

• El dispositivo ejecuta Android 10.0 (nivel de API 29) o una versión posterior.
• El dispositivo es compatible con la versión 1.1 o una posterior de la API de Vulkan.
• El dispositivo tiene capacidades de hardware y funciones compatibles con el perfil de Baseline de Android de 2022.

Nota: La compatibilidad con Vulkan 1.1 es un requisito para dispositivos Android nuevos de 64 bits a partir de Android 10.0. El perfil de Baseline de Android de 2022 también establece la versión 1.1 como la versión mínima de la API de Vulkan. La mayoría de los dispositivos compatibles con Vulkan 1.1, aunque no todos, son compatibles con el perfil de Baseline de Android de 2022. Para obtener estadísticas de compatibilidad, consulta el panel de distribución.

Compatibilidad con dispositivos más antiguos

Si tu juego está diseñado para ejecutarse en una amplia variedad de dispositivos con niveles diferentes de gráficos, quizás debas admitir dispositivos más antiguos que se recomiendan en Cómo elegir especificaciones mínimas de dispositivos para Vulkan. Antes de compilar compatibilidad con dispositivos más antiguos, evalúa si Vulkan proporciona beneficios para tu juego. Juegos que tienen muchas llamadas de dibujo y que usan OpenGL ES pueden percibir una sobrecarga significativa de los conductores debido al alto costo de realizar llamadas de dibujo dentro de OpenGL ES. Estos juegos pueden depender de la CPU debido a que gastan porciones grandes de su latencia de fotogramas en el controlador gráfico. Los juegos también pueden tener reducciones en el uso de energía y CPU gracias al cambio de OpenGL ES a Vulkan Este es se pueden aplicar, en especial, si el juego tiene escenas complejas que no se pueden usar la instancia para reducir las llamadas de dibujo. Cuando tu app se oriente a dispositivos más antiguos, incluye OpenGL ES la compatibilidad de representación como resguardo, ya que algunos dispositivos de tu lista tienen implementaciones de Vulkan que no pueden ejecutar tu juego de manera confiable.

Es posible que no quieras admitir dispositivos más antiguos compatibles con Vulkan porque carecen de rendimiento y funciones o tienen problemas de estabilidad.

Rendimiento y funciones

Es posible que los dispositivos Android más antiguos compatibles con Vulkan no tengan el rendimiento de renderización ni la compatibilidad de hardware con las funciones necesarias para ejecutar tu juego. Esto es muy probable si tu juego tiene gráficos de alta fidelidad y Vulkan es la única API a la que te orientas en Android. Muchos dispositivos más antiguos se limitan a la versión 1.0.3 de la API de Vulkan y, con frecuencia, les faltan extensiones de Vulkan muy usadas que están disponibles en hardware más moderno.

Estabilidad

Es posible que los dispositivos Android más antiguos usen controladores de Vulkan desactualizados. Estas versiones del controlador podrían incluir errores que pueden afectar la estabilidad del juego. Para solucionar los errores del controlador, es posible que se deba dedicar tiempo significativo de ingeniería y pruebas.

Cómo agregar Vulkan a tu proyecto

Para agregar Vulkan a tu proyecto, debes hacer lo siguiente:

• Incluir encabezados de la API de Vulkan
• Compila el código del sombreador en SPIR-V
• Llamar a la API de Vulkan durante el tiempo de ejecución

Incluye encabezados de la API de Vulkan

Tu juego debe incluir los archivos de encabezado de la API de Vulkan para compilar código que use Vulkan. Puedes encontrar una copia de los encabezados de Vulkan en el NDK de Android o empaquetados en las versiones del SDK de Vulkan. Cualquier versión particular del NDK solo incluye encabezados de Vulkan disponibles en el momento de la versión del NDK. Si usas encabezados de Vulkan desde el NDK, usa la versión 25 del NDK o una posterior, que incluye archivos de encabezados compatibles con la versión 1.3 de Vulkan. El SDK de Vulkan tiene la versión más reciente de los encabezados.

Compila el código del sombreador en SPIR-V

La API de Vulkan espera que los programas sombreadores se proporcionen en el formato intermedio binario SPIR-V. Esta convención es diferente de OpenGL ES, en el que puedes enviar el código fuente escrito en OpenGL Shading Language (GLSL) como cadenas de texto. Usa un compilador de sombreadores para convertir el código escrito en un lenguaje de sombreadores, como GLSL o High-level Shader Language (HLSL), y compílalo en módulos SPIR-V para usar con Vulkan.

El compilador shaderc se puede usar para compilar programas sombreadores escritos en GLSL, en SPIR-V. Si tu juego usa HLSL, DirectXShaderCompiler admite una salida de SPIR-V. Por lo general, compilarás programas sombreadores sin conexión como parte del proceso de compilación de los recursos del juego y, además, incluirás los módulos SPIR-V en los recursos del tiempo de ejecución.

Llama a la API de Vulkan durante el tiempo de ejecución

Para llamar a la API de Vulkan, tu juego debe obtener punteros a la función para las llamadas a la API de Vulkan. La manera más directa de hacerlo es vincular la biblioteca compartida libvulkan.so, que se incluye en el NDK de Android. Vincular la biblioteca tiene dos deficiencias: la sobrecarga adicional del despacho de funciones y las limitaciones con las que los punteros a la función de la API de Vulkan se resuelven automáticamente.

Cuando llamas a una función de la API de Vulkan, el control pasa por una tabla de despacho que administra una construcción denominada el cargador de Vulkan. Android usa su propia implementación del cargador de Vulkan en lugar del cargador de LunarG. Este sistema del cargador forma parte de la arquitectura de capas de la API de Vulkan. Vincular la biblioteca del sistema en el tiempo de compilación genera un nivel de despacho adicional para una llamada determinada a la API. Si bien la sobrecarga es pequeña, puede ser notoria para los juegos que realizan grandes volúmenes de llamadas de Vulkan.

Por lo general, la biblioteca del sistema solo resuelve punteros a funciones de Vulkan que se consideran parte de la API principal. Vulkan tiene una gran cantidad de extensiones, que definen funciones adicionales de Vulkan, muchas de las cuales la biblioteca del sistema no resuelve automáticamente. Debes resolver, de forma manual, los punteros a estas funciones de Vulkan antes de usarlas.

Para mitigar estos problemas, resuelve, de forma dinámica, los punteros a todas las funciones de Vulkan que deseas usar en el tiempo de ejecución. Una forma de lograrlo es con una biblioteca de metacargador de código abierto, como volk. El juego de muestra AGDKTunnel integra volk con este fin. Si usas una biblioteca de metacargador, no vincules la biblioteca compartida libvulkan.so en tus secuencias de comandos de compilación.

Determina la versión disponible de la API de Vulkan

Android admite las siguientes versiones de la API de Vulkan:

• 1.0.3
• 1.1
• 1.3

El número más alto de la versión de la API de Vulkan disponible en un dispositivo determinado se determina según la versión de Android y la compatibilidad con el controlador de Vulkan.

Versión de Android

La compatibilidad de la plataforma con una versión de la API de Vulkan depende de una versión mínima de Android (nivel de API):

• 1.3: Android 13.0 (nivel de API 33) y versiones posteriores
• 1.1: Android 10.0 (nivel de API 29) y versiones posteriores
• 1.0.3: Android 7.0 (nivel de API 24) y versiones posteriores

Compatibilidad con controladores de Vulkan

La compatibilidad de la plataforma de Android con una versión de la API de Vulkan no garantiza que la versión de la API sea compatible con el controlador de Vulkan del dispositivo. Es posible que un dispositivo con Android 13 solo admita la versión 1.1 de la API de Vulkan.

Cuando inicialices Vulkan, no solicites una API posterior a cualquiera de las siguientes versiones:

• La versión máxima de la API de Vulkan para la versión de Android que se ejecuta en el dispositivo
• La versión de la API de Vulkan informada por vkEnumerateInstanceVersion
• La versión de la API de Vulkan informada por la propiedad apiVersion de la estructura VkPhysicalDeviceProperties

A continuación, se muestra un ejemplo para determinar la versión posterior compatible de la API de Vulkan:

// Minimum Android API levels for Vulkan 1.3/1.1 version support
static constexpr int kMinimum_vk13_api_level = 33;
static constexpr int kMinimum_vk11_api_level = 29;

uint32_t GetHighestSupportedVulkanVersion(VkPhysicalDevice physical_device) {
  uint32_t instance_api_version = 0;
  vkEnumerateInstanceVersion(&instance_api_version);

  VkPhysicalDeviceProperties device_properties;
  vkGetPhysicalDeviceProperties(physical_device, &device_properties);

  // Instance and device versions don't have to match, use the lowest version
  // number for API support if they don't.
  const uint32_t driver_api_version =
      (instance_api_version < device_properties.apiVersion) ?
      instance_api_version : device_properties.apiVersion;

  const int device_api_level = android_get_device_api_level();
  if (device_api_level >= kMinimum_vk13_api_level &&
      driver_api_version >= VK_API_VERSION_1_3) {
    return VK_API_VERSION_1_3;
  } else if (device_api_level >= kMinimum_vk11_api_level &&
             driver_api_version >= VK_API_VERSION_1_1) {
    return VK_API_VERSION_1_1;
  }
  return VK_API_VERSION_1_0;
}

Determina la compatibilidad con perfiles de Vulkan

Los perfiles de Vulkan son archivos JSON que definen un conjunto de funciones, extensiones, capacidades y límites de parámetros mínimos obligatorios que un dispositivo Vulkan debe admitir para ser compatible con el perfil. Para determinar si un dispositivo es compatible con un perfil de Vulkan específico, como el perfil de Baseline de Android de 2022, usa la biblioteca de la API de Vulkan Profiles de código abierto. También puedes analizar el archivo JSON de perfil por tu cuenta y consultar las capacidades del dispositivo con las APIs relevantes de Vulkan para determinar la compatibilidad del perfil.

Perfiles de Vulkan

Android usa perfiles de Vulkan. que define las funciones y extensiones disponibles para cada uno de los dispositivos con Android.

El perfil de Baseline de Android (ABP) es el primer intento para compilar un perfil de Vulkan. ABP2021 y ABP2022 son perfiles retrospectivos destinados a cubrir > el 85% de los dispositivos activos tiempo. No habrá un ACP nuevo en el futuro.

Los perfiles de Vulkan para Android (VPA) son el nuevo perfil de vanguardia destinado a reflejan las necesidades de los desarrolladores de software e impulsan funciones coherentes tan pronto cómo los desarrolladores de hardware pueden ofrecerlos. VPA15_minimums es el primer perfil para Android 15 y cada año habrá un nuevo VPA para para abordar las versiones importantes de Android.

Implementa el ritmo de fotogramas

Un ritmo de fotogramas adecuado es fundamental para ofrecer una experiencia de juego de alta calidad. Android Game Development Kit incluye la biblioteca de Frame Pacing para ayudar a tu juego a lograr un ritmo de fotogramas óptimo. Para obtener más detalles sobre la implementación, consulta Integra Android Frame Pacing a tu procesador de Vulkan.

Implementa la rotación previa

Los dispositivos Android pueden mostrarse en varias orientaciones. La orientación del dispositivo puede ser diferente a la de la superficie de renderización. A diferencia de OpenGL ES en Android, Vulkan no controla las discrepancias entre ambas. Para comprender cómo funciona el proceso de orientación y cuál es el método óptimo para manejar las diferencias de orientación cuando se usa Vulkan, consulta Cómo controlar la orientación del dispositivo con la rotación previa de Vulkan.

Soluciona problemas y genera perfiles de renderización de Vulkan

Existen varias herramientas disponibles para ayudarte a diagnosticar problemas de renderización y de rendimiento con el código de renderización de Vulkan.

Para obtener más información sobre las herramientas de depuración y generación de perfiles de Vulkan, consulta la Herramientas y funciones avanzadas sección.

Capas de validación de Vulkan

Las capas de validación de Vulkan son bibliotecas de tiempo de ejecución que se pueden habilitar para inspeccionar tus llamadas a la API de Vulkan y mostrar advertencias o errores sobre usos incorrectos o no óptimos. Estas capas de validación no están activas de forma predeterminada, ya que el proceso de validación agrega sobrecarga del tiempo de ejecución y afecta el rendimiento del juego. Para obtener información sobre cómo usar capas de validación con tu juego, consulta Realiza depuraciones con la capa de validación.

Nota: Algunos proveedores de GPU ofrecen bibliotecas de capas de validación específicas para sus GPUs, además de las capas de validación estándar de Vulkan. Usa las capas de validación específicas para la GPU para recibir comentarios orientados sobre GPUs en particular. Estas capas se pueden descargar desde el sitio web del desarrollador del proveedor de la GPU.

Herramientas de captura de fotogramas

Usa herramientas de captura de fotogramas para grabar y volver a reproducir las llamadas a la API de Vulkan que se realizan durante un fotograma del juego. Estas herramientas te permiten hacer lo siguiente:

• Consultar información sobre los recursos gráficos activos y ver visualizaciones de estos
• Consultar la secuencia de llamadas a la API que realiza tu juego y ver los parámetros de la API
• Explorar el estado de la canalización de los gráficos en el momento de una llamada de dibujo
• Visualizar los resultados de la renderización hasta una llamada de dibujo específica en el fotograma

Usa la herramienta de código abierto RenderDoc para capturar fotogramas de los juegos que se ejecutan en Android. RenderDoc admite la captura de fotogramas de Vulkan y OpenGL ES.

También se puede usar el Inspector de GPU de Android (AGI) para capturar fotogramas de Vulkan.

Herramientas de análisis del rendimiento

Usa las herramientas de análisis de rendimiento para investigar los problemas de renderización de tu juego que causan velocidades de fotogramas deficientes. Los proveedores individuales de las GPUs proporcionan herramientas diseñadas para generar perfiles de tu juego y brindar datos de rendimiento específicos a las arquitecturas de sus GPUs. Las características de rendimiento y los cuellos de botella de tu juego pueden variar de forma considerable cuando se renderiza en GPUs de distintos proveedores o incluso en diferentes generaciones de GPUs del mismo proveedor.

También puedes usar el Inspector de GPU de Android para recopilar y analizar los datos de rendimiento. A diferencia de las herramientas de los proveedores, el Inspector de GPU de Android es compatible con varias GPUs de distintos proveedores. Sin embargo, el Inspector de GPU de Android no es compatible con dispositivos Android más antiguos, y es posible que tampoco sea compatible con todos los dispositivos nuevos.

Cómo mejorar las pruebas de Vulkan con CTS-D

Los fabricantes de dispositivos con Android usan el Conjunto de pruebas de compatibilidad (CTS) como ayuda y asegurarse de que sus dispositivos sean compatibles. Los CTS con tecnología de desarrollador (CTS-D) son los pruebas enviadas por desarrolladores de aplicaciones de Android para garantizar que el futuro Los dispositivos Android satisfacen sus casos de uso y pueden ejecutar sus aplicaciones. sin problemas y sin errores.

Si logras activar un nuevo error con tu aplicación de Vulkan que afecta a dispositivo específico con tecnología Android, puedes enviar una nueva propuesta de prueba que describa tu problema y las formas de solucionarlo. Esto garantiza que el problema se solucione una actualización futura del dispositivo y garantiza que no se produzca el mismo error a cualquier otro dispositivo.

Consulte el proceso de envío de CTS para obtener instrucciones paso a paso sobre cómo enviar la propuesta de prueba.