Renderuj aplikację AR za pomocą interfejsu Vulkan na Androidzie SDK (Kotlin/Java)

Gdy wartość Config.TextureUpdateMode to TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, ARCore udostępnia bufor sprzętowy Androida, gdy wywołana zostanie funkcja Session.update(). Ten bufor sprzętowy może być powiązany z Vulkanem VkImage.

Wyświetlanie przykładowej aplikacji

Obsługa renderowania Vulkan jest demonstrowana w aplikacji hello_ar_vulkan_c.

Włączanie trybu wyjścia bufora sprzętowego

Skonfigurowana wartość Config.TextureUpdateMode określa, jak ARCore będzie aktualizować teksturę kamery. Gdy to ustawienie jest ustawione na TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, ARCore będzie przekazywać obraz z kamery za pomocą HardwareBuffer.

Aby skonfigurować sesję do korzystania z TextureUpdateMode.EXPOSE_HARDWARE_BUFFER:

JavaKotlin

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

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

Pobieranie bufora sprzętowego

Gdy włączona jest opcja TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, użyj opcji Frame.getHardwareBuffer(), aby uzyskać bufor sprzętowy:

JavaKotlin

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

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

Używanie bufora sprzętowego podczas renderowania Vulkan

Przykład renderowania aplikacji AR za pomocą Vulkana znajdziesz w artykule vulkan_handler.cc.

Obsługiwane urządzenia

Obsługa renderowania Vulkan jest dostępna tylko na poziomie interfejsu API Androida 27 i wyższym. Dodatkowo urządzenie musi obsługiwać rozszerzenie VK_ANDROID_external_memory_android_hardware_buffer.

Wymagaj Vulkana w pliku manifestu aplikacji

Google Play używa <uses-feature> zadeklarowanego w pliku manifestu aplikacji, aby odfiltrowywać aplikacje na urządzeniach, które nie spełniają wymagań dotyczących sprzętu i oprogramowania. Urządzenia korzystające z Vulkana 1.0 mogą nie obsługiwać wymaganego rozszerzenia, ale urządzenia zgodne z Vulkanem 1.1 muszą mieć wymagane rozszerzenie, począwszy od Androida 10 (poziom interfejsu API 29).