Esegui il rendering della tua app AR utilizzando Vulkan sull'SDK Android (Kotlin/Java)

Se Config.TextureUpdateMode è impostato su TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, ARCore fornisce un buffer hardware Android quando viene chiamato Session.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 Config.TextureUpdateMode configurato determina il modo in cui ARCore aggiornerà la texture della fotocamera. Se è impostato su TextureUpdateMode.EXPOSE_HARDWARE_BUFFER, ARCore fornisce l'immagine della fotocamera tramite un HardwareBuffer.

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

Nota: quando utilizzi TextureUpdateMode.EXPOSE_HARDWARE_BUFFER su dispositivi non compatibili, Session.configure() non riesce e genera UnsupportedConfigurationException.

Ottieni il buffer hardware

Quando TextureUpdateMode.EXPOSE_HARDWARE_BUFFER è abilitato, usa Frame.getHardwareBuffer() per ottenere il buffer hardware:

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

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