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 associé à un VkImage Vulkan.
Afficher l'exemple d'application
La compatibilité du rendu avec Vulkan est expliquée dans l'application exemple hello_ar_vulkan_c.
Activer le mode de sortie de la mémoire tampon physique
Le ArTextureUpdateMode configuré détermine la manière dont ARCore mettra à jour la texture de la caméra. Lorsqu'il est défini sur AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore fournit l'image de la caméra via un AHardwareBuffer.
Configurez la session pour utiliser 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);
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;
}
Utiliser le tampon matériel lors du rendu Vulkan
Consultez vulkan_handler.cc pour découvrir comment effectuer le rendu d'une application de RA à l'aide de Vulkan.
Appareils compatibles
Le rendu Vulkan n'est disponible qu'au niveau d'API Android 27 ou supérieur. 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 les <uses-feature> déclarés dans le fichier manifeste de votre application pour la filtrer dans les appareils qui ne répondent pas à ses exigences de fonctionnalités matérielles et logicielles.
Les appareils qui utilisent 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).