在 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_handler.cc，瞭解如何使用 Vulkan 算繪 AR 應用程式。

支援的裝置

Vulkan 算繪支援功能僅適用於 Android API 級別 27 以上版本。此外，裝置必須支援 VK_ANDROID_external_memory_android_hardware_buffer 擴充功能。

必須在應用程式資訊清單中使用 Vulkan

Google Play 會使用應用程式資訊清單中宣告的 <uses-feature>，篩除不符合應用程式硬體和軟體功能需求的裝置。使用 Vulkan 1.0 的裝置可能「可能」不支援必要的擴充功能，而是裝置 從 Android 10 (API 級別 29) 開始，與 Vulkan 1.1 相容的必須有必要的擴充功能。