Rendering dell'app AR utilizzando Vulkan su Android NDK (C)

Se ArTextureUpdateMode è impostato su AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore fornisce un buffer hardware Android quando viene chiamato ArSession_update(). Questo buffer hardware può essere associato a un VkImage Vulkan.

Visualizza l'applicazione di esempio

Il supporto del rendering di Vulkan è dimostrato nell'app di esempio hello_ar_vulkan_c.

Abilita la modalità di output buffer hardware

Il valore ArTextureUpdateMode configurato determina il modo in cui ARCore aggiornerà la texture della fotocamera. Se è impostato su AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER, ARCore fornisce l'immagine della fotocamera tramite un AHardwareBuffer.

Configura la sessione per l'utilizzo di 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);

Nota: quando utilizzi AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER su dispositivi non compatibili, ArSession_configure() non riuscirà e restituirà AR_ERROR_UNSUPPORTED_CONFIGURATION.

Ottieni il buffer hardware

Quando AR_TEXTURE_UPDATE_MODE_EXPOSE_HARDWARE_BUFFER è abilitato, usa ArFrame_getHardwareBuffer() per ottenere il buffer hardware:

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

Nota: la validità di questa AHardwareBuffer è garantita solo fino alla prossima chiamata al numero ArSession_update(). Se vuoi utilizzare il buffer hardware oltre questo limite, ad esempio per il rendering, devi chiamare AHardwareBuffer_acquire() e poi chiamare AHardwareBuffer_release() una volta completato il rendering.

Usa il buffer hardware durante il rendering Vulkan

Visita la pagina vulkan_handler.cc per un esempio di come eseguire il rendering di un'applicazione AR utilizzando Vulkan.

Dispositivi supportati

Il supporto del rendering Vulkan è disponibile solo per i livelli API Android 27 e successivi. Inoltre, il dispositivo deve supportare l'estensione VK_ANDROID_external_memory_android_hardware_buffer.

Richiedere Vulkan nel file manifest dell'app

Google Play utilizza i valori <uses-feature> dichiarati nel file manifest dell'app per filtrare l'app dai dispositivi che non soddisfano i requisiti relativi alle funzionalità hardware e software. I dispositivi che utilizzano Vulkan 1.0 potrebbero non supportare l'estensione richiesta, ma i dispositivi compatibili con Vulkan 1.1 devono avere l'estensione richiesta a partire da Android 10 (livello API 29).