Crea con le estensioni OpenXR supportate

Dispositivi XR applicabili

Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.

Scopri di più sui tipi di dispositivi XR →

Visori XR

Occhiali XR con cavo

Scopri di più sui tipi di dispositivi XR →

Android XR supporta OpenXR tramite la specifica OpenXR 1.1 e un lungo elenco di estensioni di fornitori di terze parti. L'utilizzo di queste estensioni ti offre un'esperienza familiare durante lo sviluppo per XR. Alcune di queste funzionalità richiedono autorizzazioni di runtime Android. Se vuoi creare direttamente sulle API OpenXR, puoi trovare i file di intestazione richiesti nel repository jetpack-xr-natives.

Nota: la colonna Versione API Spatial indica la versione di release dell'API Spatial in cui è stato introdotto il supporto per un'estensione. Ti consigliamo di verificare se una funzionalità è disponibile sul dispositivo di destinazione utilizzando le estensioni OpenXR abilitate per le funzionalità (ad esempio XR_ANDROID_enumerate_system_extension_properties).

Estensioni del fornitore Android XR

Nome estensione	Descrizione	Versione dell'API Spatial
XR_ANDROID_anchor_sharing_export	Le ancora create da un'applicazione tramite XR_ANDROID_trackables, XR_EXT_spatial_anchor e XR_ANDROID_spatial_anchor_space sono collegate a una sessione specifica e non sono quindi visibili ad altre applicazioni. Questa estensione consente alle applicazioni di condividere gli ancoraggi con altre applicazioni in esecuzione. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_body_tracking	Utilizza la cinematica inversa per determinare la posizione del corpo in base alla posizione della testa e delle mani. Autorizzazioni: BODY_TRACKING	v2
XR_ANDROID_composition_layer_passthrough_mesh	Per i dispositivi che supportano più modalità di fusione dell'ambiente. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_depth_texture	Questa estensione consente all'applicazione di richiedere mappe di profondità dell'ambiente reale intorno al visore ed eseguire query sulle risoluzioni di profondità supportate al momento della creazione. Autorizzazioni: SCENE_UNDERSTANDING_FINE	v1
XR_ANDROID_device_anchor_persistence	Questa estensione consente all'applicazione di persistere. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_enumerate_system_extension_properties	Questa estensione consente alle applicazioni di determinare quali estensioni sono supportate dalla configurazione di sistema corrente.	v3
XR_ANDROID_eye_tracking	Questa estensione consente alle applicazioni di ottenere la posizione e l'orientamento degli occhi dell'utente, nonché lo stato del tracciamento oculare. Autorizzazioni: EYE_TRACKING_FINE	v1
XR_ANDROID_face_tracking	Questa estensione consente alle applicazioni di ottenere i pesi delle forme di fusione e di eseguire il rendering delle espressioni facciali nelle esperienze XR. Autorizzazioni: FACE_TRACKING	v1
XR_ANDROID_face_tracking_data_source	Questa estensione consente alle applicazioni di ottenere dati di tracciamento facciale da più origini dati. Autorizzazioni: FACE_TRACKING, RECORD_AUDIO	v3
XR_ANDROID_geospatial	Questa estensione fornisce il monitoraggio geospaziale per l'API Geospatial di Google. Autorizzazioni: ACCESS_FINE_LOCATION	v4
XR_ANDROID_geospatial_anchor	Questa estensione fornisce ancoraggi geospaziali e ancoraggi di superficie posizionati nello spazio rispetto alla Terra a una determinata latitudine, longitudine e altitudine. Autorizzazioni: ACCESS_FINE_LOCATION	v4
XR_ANDROID_global_passthrough_dimming	Questa estensione consente alle applicazioni di impostare ed eseguire query sul livello di oscuramento passthrough globale e di ricevere eventi quando il livello di oscuramento cambia.	v4
XR_ANDROID_google_cloud_auth	Questa estensione consente l'utilizzo di estensioni basate su Google Cloud consentendo all'applicazione di fornire credenziali di autenticazione per le API Google Cloud.	v4
XR_ANDROID_hand_mesh	Questa estensione abilita gli input di tracciamento delle mani rappresentati come una mesh dinamica delle mani. Autorizzazioni: HAND_TRACKING	v1
XR_ANDROID_light_estimation	Questa estensione consente all'applicazione di richiedere dati che rappresentano l'illuminazione dell'ambiente reale intorno al visore. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_light_estimation_cubemap	Questa estensione si basa sull'estensione di base XR_ANDROID_light_estimation. Autorizzazioni: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_mouse_interaction	Questa estensione fornisce un XrPath per l'acquisizione dell'input del mouse e definisce una posa d'azione di uso comune per i profili del mouse dell'utente, inclusi sia i dispositivi mouse che i trackpad.	v1
XR_ANDROID_passthrough_camera_state	La videocamera passthrough può richiedere del tempo per avviarsi e potrebbe non essere immediatamente disponibile.	v1
XR_ANDROID_performance_metrics	Questa estensione fornisce API per enumerare ed eseguire query su vari contatori delle metriche sul rendimento del dispositivo XR corrente.	v1
XR_ANDROID_raycast	Questa estensione consente all'applicazione di eseguire raycast sugli elementi tracciabili nell'ambiente. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_recommended_resolution	Questa estensione consente al runtime di notificare all'applicazione quando la risoluzione consigliata cambia.	v1
XR_ANDROID_recommended_settings	L'ambiente predefinito dell'utente può trovarsi in vari stati utilizzando una combinazione di modalità di fusione e modalità di input.	v1
XR_ANDROID_scene_meshing	Questa estensione ha lo scopo di fornire mesh che rappresentano approssimativamente gli oggetti fisici nell'ambiente dell'utente. Autorizzazioni: SCENE_UNDERSTANDING_FINE	v1
XR_ANDROID_spatial_anchor_space	La funzione xrCreateSpatialAnchorEXT definita nell'estensione XR_EXT_spatial_anchor consente alle applicazioni di creare ancoraggi spaziali con un handle XrSpatialEntityEXT per rappresentarli. Al contrario, questa estensione crea un ancoraggio spaziale rappresentato da un handle XrSpace. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_annotation_tracking	Questa estensione fornisce la funzionalità di monitoraggio delle annotazioni per l'estensione XR_EXT_spatial_entity per monitorare varie annotazioni nella scena. Consente alle applicazioni di inserire overlay su oggetti fisici o virtuali definiti da riferimenti di runtime. Autorizzazioni: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_spatial_component_subsumed_by	Questa estensione si basa su XR_EXT_spatial_entity e fornisce un nuovo componente per XR_SPATIAL_CAPABILITY_PLANE_TRACKING_EXT per esporre XrSpatialEntityIdEXT che include l'entità corrente. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_discovery_bounds	Questa estensione aggiunge definizioni per i limiti spaziali che consentono alle applicazioni di filtrare le entità spaziali rilevate. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v4
XR_ANDROID_spatial_discovery_raycast	Questa estensione si basa su XR_EXT_spatial_entity e fornisce funzionalità di raycast per le funzionalità spaziali esistenti. Autorizzazioni: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_spatial_entity_bound_anchor	Questa estensione consente alle applicazioni di creare e collegare ancoraggi a entità spaziali. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_object_tracking	Questa estensione si basa su XR_EXT_spatial_entity e definisce una funzionalità spaziale per il monitoraggio di un insieme di oggetti fisici predefiniti senza richiedere un set di dati di input dall'applicazione. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_trackables	Questa estensione consente all'applicazione di accedere agli elementi tracciabili dell'ambiente fisico. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_image	Questa estensione consente di monitorare le immagini planari come specificato da insiemi di immagini di riferimento di input. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_trackables_marker	Questa estensione consente il monitoraggio dei marker fisici. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_object	Questa estensione consente il tracciamento degli oggetti fisici. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_qr_code	Questa estensione consente il monitoraggio dei codici QR fisici e la decodifica dei dati dei codici QR. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_unbounded_reference_space	Questa estensione consente alle applicazioni di creare uno spazio di riferimento XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID.	v1
XR_ANDROID_viewport_feathering	Questa estensione espone l'area sfumata applicata dal runtime in modo che un'applicazione possa disporre gli elementi UI all'interno dell'area sicura.	v4

Estensioni di terze parti

Nome estensione	Descrizione	Versione dell'API Spatial
XR_MND_headless	Alcune applicazioni potrebbero dover accedere ai dispositivi di interazione XR senza presentare contenuti di immagini sul display o sui display.	v1
XR_KHR_binding_modification	Questa estensione aggiunge una struttura facoltativa che può essere inclusa nella catena XrInteractionProfileSuggestedBinding::next passata a xrSuggestInteractionProfileBindings per specificare informazioni aggiuntive per modificare il comportamento di associazione predefinito.	v1
XR_EXT_debug_utils	A causa della natura dell'interfaccia OpenXR, le informazioni sugli errori disponibili per lo sviluppatore e l'applicazione sono molto limitate.	v1
XR_EXT_hand_tracking	Questa estensione consente alle applicazioni di individuare le singole articolazioni degli input di tracciamento delle mani. Autorizzazioni: HAND_TRACKING	v1
XR_EXT_performance_settings	Questa estensione definisce un'API per l'applicazione per fornire suggerimenti sulle prestazioni al runtime e per il runtime per inviare notifiche relative alle prestazioni all'applicazione. In questo modo, entrambe le parti possono trovare un compromesso adeguato tra le prestazioni della CPU e della GPU necessarie, la sostenibilità termica e un'esperienza utente costantemente positiva per tutta la sessione.	v1
XR_FB_display_refresh_rate	Su piattaforme che supportano la regolazione dinamica della frequenza di aggiornamento del display.	v1
XR_FB_swapchain_update_state	Questa estensione consente all'applicazione di modificare ed eseguire query su uno stato mutabile specifico associato a una swapchain.	v1
XR_FB_foveation	La foveazione nel contesto della realtà estesa è una tecnica di rendering che consente di visualizzare l'area di un'immagine vicino al punto focale o alla fovea dell'occhio con una risoluzione superiore rispetto alle aree periferiche.	v1
XR_FB_foveation_configuration	Sui visori Facebook, gli sviluppatori possono creare profili di foveazione generati dal runtime per le proprietà ottiche e le prestazioni.	v1
XR_FB_foveation_vulkan	L'API grafica Vulkan richiede l'applicazione di un'immagine alla catena di scambio per applicare un pattern di foveazione.	v1
XR_FB_space_warp	Questa estensione fornisce il supporto per attivare la tecnologia Space Warp nell'applicazione.	v1
XR_KHR_opengl_es_enable	Questa estensione deve essere fornita dai runtime che supportano le applicazioni che utilizzano le API OpenGL ES per il rendering.	v1
XR_KHR_android_create_instance	Quando l'applicazione crea un oggetto XrInstance sui sistemi Android.	v1
XR_KHR_android_surface_swapchain	Un'attività comune in XR è la visualizzazione di uno stream di immagini.	v1
XR_KHR_android_thread_settings	Per un'esperienza XR confortevole, è importante che le applicazioni forniscano i frame in modo rapido e coerente.	v1
XR_KHR_composition_layer_color_scale_bias	La scala e la distorsione del colore vengono applicate a un colore del livello durante la composizione, dopo la sua conversione in rappresentazione alfa premoltiplicata.	v1
XR_KHR_composition_layer_cube	Questa estensione aggiunge un tipo di livello aggiuntivo che consente il campionamento diretto dalle mappe cubiche.	v1
XR_KHR_composition_layer_cylinder	Questa estensione aggiunge un tipo di livello aggiuntivo in cui il runtime XR deve mappare una texture proveniente da una swapchain all'interno di una sezione cilindrica. Può essere immaginato in modo molto simile a come appare uno schermo televisivo curvo a uno spettatore.	v1
XR_KHR_composition_layer_depth	Questa estensione definisce un tipo di livello aggiuntivo che consente alle applicazioni di inviare immagini di profondità insieme alle immagini a colori nei livelli di proiezione.	v1
XR_KHR_composition_layer_equirect	Questa estensione aggiunge un ulteriore tipo di livello in cui il runtime XR deve mappare un'immagine codificata equirettangolare proveniente da una catena di scambio all'interno di una sfera.	v1
XR_KHR_composition_layer_equirect2	Questa estensione aggiunge un ulteriore tipo di livello in cui il runtime XR deve mappare un'immagine codificata equirettangolare proveniente da una catena di scambio all'interno di una sfera. Questa estensione utilizza una parametrizzazione diversa, più in linea con la formulazione di XR_KHR_composition_layer_cylinder, ma è funzionalmente equivalente a XR_KHR_composition_layer_equirect.	v1
XR_KHR_convert_timespec_time	Questa estensione fornisce due funzioni per la conversione tra il tempo monotonico timespec e XrTime.	v1
XR_KHR_vulkan_enable	Questa estensione consente l'utilizzo dell'API grafica Vulkan in un runtime OpenXR.	v1
XR_KHR_vulkan_enable2	Questa estensione consente l'utilizzo dell'API grafica Vulkan in un runtime OpenXR.	v1
XR_KHR_loader_init	Su alcune piattaforme, prima che possa avvenire il caricamento, il caricatore deve essere inizializzato con parametri specifici della piattaforma.	v1
XR_KHR_loader_init_android	Su Android, alcune implementazioni del caricatore richiedono che l'applicazione fornisca informazioni aggiuntive sull'inizializzazione.	v1
XR_KHR_swapchain_usage_input_attachment_bit	Questa estensione consente a un'applicazione di specificare che le immagini della catena di scambio devono essere create in modo da poter essere utilizzate come allegati di input. Al momento della stesura di questo documento, questo bit influisce solo sulle catene di scambio Vulkan.	v1
XR_EXT_dpad_binding	Questa estensione consente all'applicazione di associare una o più azioni digitali a un trackpad o a una levetta analogica come se fosse un dpad, definendo percorsi di componenti aggiuntivi per cui suggerire le associazioni.	v1
XR_EXT_uuid	Questa estensione definisce un identificatore univoco universale che segue lo standard RFC 4122.	v1
XR_FB_composition_layer_depth_test	Questa estensione consente la composizione di livelli con test di profondità.	v1
XR_EXT_eye_gaze_interaction	Questa estensione fornisce un XrPath per ottenere l'input del tracciamento oculare da un eye tracker per consentire le interazioni con lo sguardo. Autorizzazioni: EYE_TRACKING_FINE	v1
XR_EXT_hand_interaction	Questa estensione definisce quattro pose di azione di uso comune per tutti i profili di interazione con le mani dell'utente, inclusi i dispositivi di tracciamento delle mani e i dispositivi di controllo del movimento.	v1
XR_KHR_visibility_mask	Questa estensione supporta la fornitura di una maschera di disegno per visualizzazione per le applicazioni.	v1
XR_META_foveation_eye_tracked	Il rendering foveated con tracciamento oculare esegue il rendering di una densità di pixel inferiore nella periferia dello sguardo dell'utente. Autorizzazioni: EYE_TRACKING_FINE	v1
XR_FB_hand_tracking_aim	L'estensione XR_EXT_hand_tracking fornisce un elenco di posizioni delle articolazioni della mano che rappresentano la configurazione corrente delle mani monitorate. Questa estensione aggiunge un livello di riconoscimento dei gesti utilizzato dal sistema. Autorizzazioni: HAND_TRACKING	v1
XR_EXT_palm_pose	Questa estensione definisce un nuovo "identificatore di posa standard" per i profili di interazione, denominato "palm_ext".	v1
XR_VARJO_foveated_rendering	I visori Varjo offrono display con una densità di pixel estremamente elevata nell'area centrale del display. Autorizzazioni: EYE_TRACKING_FINE	v1
XR_VARJO_quad_views	Questa estensione aggiunge un nuovo tipo di configurazione della visualizzazione, XR_VIEW_CONFIGURATION_TYPE_PRIMARY_QUAD_VARJO, a XrViewConfigurationType, che può essere restituito da xrEnumerateViewConfigurations per indicare che il runtime supporta 4 viewport.	v1
XR_META_vulkan_swapchain_create_info	Utilizzando questa estensione, un'applicazione basata su Vulkan può trasmettere VkImageCreateFlags o VkImageUsageFlags aggiuntivi concatenando una struttura XrVulkanSwapchainCreateInfoMETA a XrSwapchainCreateInfo quando chiama xrCreateSwapchain.	v1
XR_FB_hand_tracking_mesh	L'estensione XR_EXT_hand_tracking fornisce un elenco di pose delle articolazioni della mano, ma non un meccanismo per eseguire il rendering di una mesh della mano con skin. Autorizzazioni: HAND_TRACKING	v1
XR_FB_composition_layer_image_layout	Questa estensione non definisce un nuovo tipo di livello di composizione.	v1
XR_KHR_maintenance1	XR_KHR_maintenance1 aggiunge una raccolta di funzionalità minori che sono state intenzionalmente tralasciate o trascurate nella release originale di OpenXR 1.0.	v1
XR_FB_composition_layer_settings	Questa estensione consente alle applicazioni di richiedere l'utilizzo di opzioni di elaborazione come la nitidezza o il super-sampling su un livello di composizione.	v1
XR_KHR_locate_spaces	Questa estensione introduce la funzione xrLocateSpacesKHR.	v1
XR_EXT_local_floor	La specifica OpenXR di base contiene due tipi di spazi di riferimento bloccati nel mondo XrSpace in XrReferenceSpaceType.	v1
XR_EXT_spatial_marker_tracking	Questa estensione si basa su XR_EXT_spatial_entity e consente alle applicazioni di rilevare e monitorare i marker nel loro ambiente. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_persistence	Questa estensione consente alle applicazioni di rilevare e correlare le entità spaziali tra le sessioni dell'applicazione. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_anchor	Questa estensione si basa su XR_EXT_spatial_entity e consente alle applicazioni di creare ancoraggi spaziali. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_plane_tracking	Questa estensione si basa su XR_EXT_spatial_entity e definisce la funzionalità spaziale di tracciamento dei piani per il framework delle entità spaziali. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_entity	Questa estensione introduce i concetti e i fondamenti per la comprensione delle scene e il ragionamento spaziale in OpenXR.	v1
XR_EXT_future	Nei sistemi XR esistono alcune operazioni che richiedono molto tempo e non vengono completate ragionevolmente entro un normale ciclo di frame.	v1
XR_FB_color_space	I dispositivi XR potrebbero utilizzare uno spazio dei colori diverso da quello di molti monitor utilizzati nello sviluppo.	v1
XR_EXT_composition_layer_inverted_alpha	Questa estensione fornisce un flag che, se applicato a un livello di composizione, inverte l'interpretazione del valore alfa nelle immagini della catena di scambio del livello.	v1
XR_EXT_spatial_entity_archetypes	La funzione xrQuerySpatialComponentDataEXT offre alle applicazioni un modo per eseguire query su entità e dati dei componenti utilizzando un filtro dei tipi di componenti che devono essere presenti in un'entità. Questa estensione introduce il concetto di archetipi (combinazioni di componenti uniche) in modo che le applicazioni possano leggere tutti i dati dei componenti per tutte le entità senza duplicazioni.	v4
XR_EXT_frame_synthesis	Questa estensione fornisce il supporto per attivare la sintesi dei frame nelle applicazioni in base ai dati aggiuntivi forniti dall'applicazione.	v3
XR_QCOM_trackables_image_operations	Fornisce operazioni di tracciamento delle immagini Qualcomm per gli elementi tracciabili.	v3
XR_QCOM_trackables_qr_code_operations	Fornisce operazioni di monitoraggio dei codici QR Qualcomm per i tracker.	v3
XR_EXT_user_presence	Questa estensione introduce un nuovo evento per notificare quando il sistema ha rilevato la modifica della presenza dell'utente.	v3
XR_KHR_extended_struct_name_lengths	Questa estensione aumenta le dimensioni massime dei nomi delle strutture e fornisce una nuova funzione per accedere a questi nuovi nomi estesi.	v3
XR_EXT_hand_tracking_data_source	Questa estensione migliora l'estensione XR_EXT_hand_tracking.	v4
XR_EXT_spatial_container_self_rendering	Questa estensione descrive il "self rendering" nel contesto dei container spaziali.	v4
XR_EXT_spatial_container	Questa estensione definisce una nuova classe di entità visualizzabili.	v4
XR_EXT_spatial_persistence_operations	Questa estensione consente alle applicazioni di rendere persistenti e non persistenti le entità spaziali tra le sessioni. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_mesh_tracking	Questa estensione si basa su XR_EXT_spatial_entity e definisce le funzionalità spaziali per il monitoraggio della mesh triangolare dell'ambiente. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v4
XR_EXT_spatial_object_tracking	Questa estensione si basa su XR_EXT_spatial_entity e definisce una funzionalità spaziale per il monitoraggio di un insieme di oggetti predefiniti senza richiedere un set di dati di input dall'applicazione. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v4
XR_EXT_spatial_image_tracking	Questa estensione fornisce la funzionalità di monitoraggio delle immagini per l'estensione XR_EXT_spatial_entity. Autorizzazioni: SCENE_UNDERSTANDING_COARSE	v4
XR_EXT_interaction_profile_battery_state_display	XR_EXT_interaction_profile_battery_state_display fornisce un meccanismo per consentire alle applicazioni di eseguire query sul runtime per ottenere informazioni sullo stato della batteria dei dispositivi utilizzati con i profili di interazione.	v3
XR_FB_composition_layer_secure_content	Questa estensione non definisce un nuovo tipo di livello di composizione.	v4

---

OpenXR™ e il logo OpenXR sono marchi di proprietà di The Khronos Group Inc. e sono registrati come marchi in Cina, nell'Unione Europea, in Giappone e nel Regno Unito.