在 Android SDK (Kotlin/Java) 上使用 Vulkan 轉譯 AR 應用程式

如果 Config.TextureUpdateMode 設為 TextureUpdateMode.EXPOSE_HARDWARE_BUFFER，ARCore 會在呼叫 Session.update() 時提供 Android 硬體緩衝區。這個硬體緩衝區可繫結至 Vulkan VkImage。

查看範例應用程式

hello_ar_vulkan_c 範例應用程式示範了 Vulkan 算繪支援功能。

啟用硬體緩衝區輸出模式

已設定的 Config.TextureUpdateMode 會決定 ARCore 更新相機紋理的做法。設為 TextureUpdateMode.EXPOSE_HARDWARE_BUFFER 時，ARCore 會透過 HardwareBuffer 提供相機影像。

設定工作階段以使用 TextureUpdateMode.EXPOSE_HARDWARE_BUFFER：

Java

Config config = session.getConfig();
config.setTextureUpdateMode(Config.TextureUpdateMode.EXPOSE_HARDWARE_BUFFER);
session.configure(config);

Kotlin

session.configure(
  session.config.apply { textureUpdateMode = Config.TextureUpdateMode.EXPOSE_HARDWARE_BUFFER }
)

注意：在相容性不佳的裝置上使用 TextureUpdateMode.EXPOSE_HARDWARE_BUFFER 時，Session.configure() 會失敗並擲回 UnsupportedConfigurationException。

取得硬體緩衝區

啟用 TextureUpdateMode.EXPOSE_HARDWARE_BUFFER 時，請使用 Frame.getHardwareBuffer() 取得硬體緩衝區：

Java

try {
  HardwareBuffer buffer = frame.getHardwareBuffer();
  // Use the buffer object in your rendering.
} catch (NotYetAvailableException e) {
  // The hardware buffer is not ready yet.
}

Kotlin

try {
  val buffer = frame.hardwareBuffer
  // Use the buffer object in your rendering.
} catch (e: NotYetAvailableException) {
  // The hardware buffer is not ready yet.
}

在 Vulkan 算繪期間使用硬體緩衝區

如需使用 Vulkan 算繪 AR 應用程式的範例，請參閱 vulkan_handler.cc。

支援的裝置

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 相容的必須有必要的擴充功能。