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

Gdy pole Config.TextureUpdateMode ma wartość TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, po wywołaniu funkcji Session.update() ARCore udostępnia bufor sprzętowy Androida. Ten bufor sprzętowy można powiązać z interfejsem Vulkan VkImage.

Wyświetl przykładową aplikację

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 sposób aktualizowania tekstury aparatu przez ARCore. Gdy ustawisz wartość TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, ARCore będzie przesyłać obraz z aparatu za pomocą HardwareBuffer.

Skonfiguruj sesję do używania TextureUpdateMode.EXPOSE_HARDWARE_BUFFER:

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

Uzyskiwanie bufora sprzętowego

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

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ż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

Renderowanie interfejsu Vulkan jest dostępne tylko na poziomach interfejsu API Androida 27 i powyżej. Dodatkowo urządzenie musi obsługiwać rozszerzenie VK_ANDROID_external_memory_android_hardware_buffer.

Wymagaj interfejsu Vulkan 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 Vulkan 1.0 mogą nie obsługiwać wymaganego rozszerzenia, ale zgodne z Vulkan 1.1 muszą mieć wymagane rozszerzenie na Androidzie 10 (poziom interfejsu API 29).