Renderuj aplikację AR za pomocą Vulkana na Androidzie NDK (C)

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

Uwaga: jeśli używasz AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER na niezgodnych urządzeniach, ArSession_configure() zwraca błąd AR_ERROR_UNSUPPORTED_CONFIGURATION.

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

Uwaga: ten element AHardwareBuffer będzie ważny tylko do następnego wywołania metody ArSession_update(). Jeśli chcesz używać bufora sprzętowego poza nim, na przykład do renderowania, musisz wywołać metodę AHardwareBuffer_acquire(), a następnie wywołać funkcję AHardwareBuffer_release() po zakończeniu renderowania.

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