Gdy pole ArTextureUpdateMode
ma wartość AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER
, po wywołaniu funkcji ArSession_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ść ArTextureUpdateMode
określa sposób aktualizowania tekstury aparatu przez ARCore. Gdy ustawisz wartość AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER
, ARCore będzie przesyłać obraz z aparatu za pomocą AHardwareBuffer
.
Skonfiguruj sesję do używania AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER
:
ArConfig* ar_config = NULL; ArConfig_create(ar_session, &ar_config); ArConfig_setTextureUpdateMode(ar_session, ar_config, AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER); CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS); ArConfig_destroy(ar_config);
Uzyskiwanie bufora sprzętowego
Gdy AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER
jest włączony, użyj ArFrame_getHardwareBuffer()
, aby pobrać bufor sprzętowy:
void* native_hardware_buffer = NULL; ArFrame_getHardwareBuffer(ar_session, ar_frame, &native_hardware_buffer); if ((int64_t)native_hardware_buffer == 0) { // The hardware buffer isn't ready yet. return; }
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).