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żna powiązać z interfejsem Vulkan VkImage.

Wyświetlanie przykładowej aplikacji

Obsługę renderowania Vulkan pokazano w przykładowej aplikacji hello_ar_vulkan_c.

Włącz tryb wyjściowy bufora sprzętowego

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

Aby skonfigurować sesję do korzystania z 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 }
)

Uwaga: gdy używasz TextureUpdateMode.EXPOSE_HARDWARE_BUFFER na urządzeniach niezgodnych z tym formatem, funkcja Session.configure() nie zadziała i wyrzuci błąd UnsupportedConfigurationException.

Uzyskiwanie bufora sprzętowego

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

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

Używaj bufora sprzętowego podczas renderowania pod kątem interfejsu Vulkan

Przykład renderowania aplikacji AR za pomocą interfejsu Vulkan znajdziesz w vulkan_handler.cc.

Obsługiwane urządzenia

Obsługa renderowania Vulkan jest dostępna tylko na poziomie interfejsu API 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 manifeście aplikacji do filtrowania 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).