在 Android NDK (C) 上使用 Vulkan 渲染 AR 应用

当 ArTextureUpdateMode 设置为 AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER 时，ARCore 会在调用 ArSession_update() 时提供 Android 硬件缓冲区。此硬件缓冲区可以绑定到 Vulkan VkImage。

查看示例应用

hello_ar_vulkan_c 示例应用演示了对 Vulkan 渲染的支持。

启用硬件缓冲区输出模式

配置的 ArTextureUpdateMode 决定了 ARCore 更新相机纹理的方式。当它设置为 AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER 时，ARCore 将通过 AHardwareBuffer 提供摄像头图像。

将会话配置为使用 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);

注意 ：在不兼容的设备上使用 AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER 时，ArSession_configure() 会失败并返回 AR_ERROR_UNSUPPORTED_CONFIGURATION。

获取硬件缓冲区

启用 AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER 后，使用 ArFrame_getHardwareBuffer() 获取硬件缓冲区：

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;
}

注意 ：此 AHardwareBuffer 只能保证在下一次调用 ArSession_update() 之前有效。如果您想使用除此之外的硬件缓冲区（例如进行渲染），则必须调用 AHardwareBuffer_acquire()，然后在渲染完成后调用 AHardwareBuffer_release()。

在 Vulkan 渲染期间使用硬件缓冲区

如需查看有关如何使用 Vulkan 渲染 AR 应用的示例，请参阅 vulkan_handler.cc。

支持的设备

Vulkan 渲染支持仅适用于 Android API 级别 27 及更高级别。此外，设备必须支持 VK_ANDROID_external_memory_android_hardware_buffer 扩展。

应用清单中要求使用 Vulkan

Google Play 会利用应用清单中声明的 <uses-feature>，从不符合应用硬件和软件功能要求的设备上过滤该应用。从 Android 10（API 级别 29）开始，使用 Vulkan 1.0 的设备可能无法支持所需的扩展，但与 Vulkan 1.1 兼容的设备必须具备所需的扩展。