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
:
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 } )
Uzyskiwanie bufora sprzętowego
Gdy TextureUpdateMode.EXPOSE_HARDWARE_BUFFER
jest włączony, 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
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).