Effectuer le rendu de votre application de RA à l'aide de Vulkan sur le NDK Android (C)

Lorsque ArTextureUpdateMode est défini sur AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore fournit un tampon matériel Android lorsque ArSession_update() est appelé. Ce tampon matériel peut être lié à un VkImage Vulkan.

Afficher l'application exemple

La prise en charge du rendu Vulkan est illustrée dans l'application exemple hello_ar_vulkan_c.

Activer le mode de sortie de la mémoire tampon matérielle

Le ArTextureUpdateMode configuré détermine comment ARCore met à jour la texture de la caméra. Lorsque cette valeur est définie sur AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore fournit l'image de la caméra via un AHardwareBuffer.

Configurez la session pour qu'elle utilise AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER:

ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);
ArConfig_setTextureUpdateMode(ar_session, ar_config,
                              AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER);
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);
ArConfig_destroy(ar_config);

Remarque :Lorsque vous utilisez AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER sur des appareils incompatibles, ArSession_configure() échoue et renvoie AR_ERROR_UNSUPPORTED_CONFIGURATION.

Obtenir le tampon matériel

Lorsque AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER est activé, utilisez ArFrame_getHardwareBuffer() pour obtenir le tampon matériel:

void* native_hardware_buffer = NULL;
ArFrame_getHardwareBuffer(ar_session, ar_frame, &native_hardware_buffer);

if ((int64_t)native_hardware_buffer == 0) {
  // The hardware buffer isn't ready yet.
  return;
}

Remarque :La validité de cet objet AHardwareBuffer n'est garantie que jusqu'au prochain appel de ArSession_update(). Si vous souhaitez utiliser le tampon matériel au-delà de cette valeur, par exemple pour le rendu, vous devez appeler AHardwareBuffer_acquire(), puis AHardwareBuffer_release() une fois le rendu terminé.

Utiliser le tampon matériel pendant le rendu Vulkan

Consultez vulkan_handler.cc pour obtenir un exemple de rendu d'une application AR à l'aide de Vulkan.

Appareils compatibles

La prise en charge du rendu Vulkan n'est disponible que pour les niveaux d'API Android 27 et supérieurs. De plus, l'appareil doit être compatible avec l'extension VK_ANDROID_external_memory_android_hardware_buffer.

Exiger Vulkan dans le fichier manifeste de votre application

Google Play utilise <uses-feature> déclaré dans le fichier manifeste de votre application pour filtrer celle-ci et l'exclure des appareils non conformes à ses exigences matérielles et logicielles. Les appareils utilisant Vulkan 1.0 peuvent ne pas prendre en charge l'extension requise, mais les appareils compatibles avec Vulkan 1.1 doivent disposer de l'extension requise à partir d'Android 10 (niveau d'API 29).