XR_ANDROID_enumerate_system_extension_properties

Name String

XR_ANDROID_enumerate_system_extension_properties

Uzantı Türü

Örnek uzantısı

Kayıtlı Dahili Numara

725

Düzeltme

1

Onay Durumu

Onaylanmadı

Uzantı ve Sürüm Bağımlılıkları

OpenXR 1.0

Son Değiştirilme Tarihi

2026-02-11

IP Durumu

Bilinen bir fikri mülkiyet hak talebi yok.

Katkıda bulunanlar

Spencer Quin, Google
Nihav Jain, Google
Kenny Vercaemer, Google

Genel Bakış

Bu uzantı, uygulamaların mevcut sistem yapılandırması tarafından hangi uzantıların desteklendiğini belirlemesine olanak tanır. Bir uzantı, çalışma zamanı tarafından desteklense bile mevcut sistem donanımı tarafından desteklenmeyebilir.

XrSystemExtensionPropertiesANDROID yapısı şu şekilde tanımlanır:

typedef struct XrSystemExtensionPropertiesANDROID {
    XrStructureType          type;
    void*                    next;
    XrExtensionProperties    properties;
    XrBool32                 isSupported;
} XrSystemExtensionPropertiesANDROID;

Üye Açıklamaları

  • type, bu yapının XrStructureType değeridir.
  • next, NULL veya bir yapı zincirindeki sonraki yapıya işaret eden bir göstergedir.
  • properties, uzantı adını içeren XrExtensionProperties'dir.
  • isSupported, uzantının şu anda sistem tarafından desteklenip desteklenmediğini belirten bir boole değeridir.

Geçerli Kullanım (Dolaylı)

XrEventDataSystemPropertiesChangedANDROID yapısı şu şekilde tanımlanır:

typedef struct XrEventDataSystemPropertiesChangedANDROID {
    XrStructureType    type;
    const void*        next;
} XrEventDataSystemPropertiesChangedANDROID;

Üye Açıklamaları

  • type, bu yapının XrStructureType değeridir.
  • next, NULL veya bir yapı zincirindeki sonraki yapıya işaret eden bir göstergedir.

Sistem uzantısı özellikleri değiştiğinde çalışma zamanı bu etkinliği sıraya almalıdır. Örneğin, yeni çevre birimleri bağlandığında yeni işlevler etkinleştirilir.

xrEnumerateSystemExtensionPropertiesANDROID için yapılan tüm çağrılar, yeni bir XrEventDataSystemPropertiesChangedANDROID etkinliği sıraya alınana kadar aynı değerleri döndürmelidir.

Bir uygulama bu etkinliği aldığında en son sistem uzantısı özelliklerini belirlemek için xrEnumerateSystemExtensionPropertiesANDROID'i tekrar çağırmalıdır . Bu işlem, gerektiğinde bu uzantılarla ilişkili izleyiciler oluşturabilir veya bunları yok edebilir.

Geçerli Kullanım (Dolaylı)

xrEnumerateSystemExtensionPropertiesANDROID işlevi şu şekilde tanımlanır:

XrResult xrEnumerateSystemExtensionPropertiesANDROID(
    XrInstance                                  instance,
    XrSystemId                                  systemId,
    uint32_t                                    propertyCapacityInput,
    uint32_t*                                   propertyCountOutput,
    XrSystemExtensionPropertiesANDROID*         properties);

Parametre Açıklamaları

  • instance, geçerli bir XrInstance'dır.
  • systemId, uzantı özelliklerinin alınacağı sistemin geçerli bir sliink:XrSystemId değeridir.
  • propertyCapacityInput, properties dizisinin kapasitesidir veya gerekli kapasiteyi alma isteğini belirtmek için 0'dır.
  • propertyCountOutput, istenen uzantı özelliklerinin sayısıdır.
  • properties, XrSystemExtensionPropertiesANDROID yapılarından oluşan bir dizidir. propertyCapacityInput 0 ise NULL olabilir.
  • Gerekli properties boyutunu alma hakkında ayrıntılı açıklama için Arabellek Boyutu Parametreleri bölümüne bakın.

Geçerli Kullanım (Dolaylı)

  • XR_ANDROID_enumerate_system_extension_properties uzantısı, xrEnumerateSystemExtensionPropertiesANDROID çağrılmadan önce etkinleştirilmelidir
  • instance geçerli bir XrInstance herkese açık kullanıcı adı olmalıdır
  • propertyCountOutput, bir uint32_t değerine işaretçi olmalıdır
  • propertyCapacityInput, 0 değilse properties, propertyCapacityInput XrSystemExtensionPropertiesANDROID yapılarından oluşan bir dizinin işaretçisi olmalıdır.

Dönüş Kodları

Başarılı

  • XR_SUCCESS

Hata

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_SYSTEM_INVALID
  • XR_ERROR_VALIDATION_FAILURE

Örnek

XrInstance instance; // XrInstance previously created

XrSystemId systemId; // XrSystemId from a previously created instance

PFN_xrEnumerateSystemExtensionPropertiesANDROID xrEnumerateSystemExtensionPropertiesANDROID;

// Poll events for recommended resolution changes.
XrEventDataBuffer event = {XR_TYPE_EVENT_DATA_BUFFER};
XrResult result = xrPollEvent(instance, &event);

if (result == XR_SUCCESS) {
    switch (event.type) {
        case XR_TYPE_EVENT_DATA_SYSTEM_PROPERTIES_CHANGED_ANDROID:
            // It's possible that the system was lost and a new id will be returned
            XrSystemId newSystemId;
            XrSystemGetInfo getInfo = {XR_TYPE_SYSTEM_GET_INFO};
            getInfo.formFactor = XR_FORM_FACTOR_HEAD_MOUNTED_DISPLAY;
            if(XR_SUCCESS == xrGetSystem(instance, &getInfo, &newSystemId)) {
                if(systemId != newSystemId) {
                    //Do things like recreate the session
                    systemId = newSystemId;
                }
            }

            // Enumerate the extensions to see which ones are now supported based on hardware changes
            uint32_t extensionsCount;
            xrEnumerateSystemExtensionPropertiesANDROID(instance, systemId, 0, &extensionsCount, NULL);

            std::vector<XrSystemExtensionPropertiesANDROID> properties(extensionsCount,
                {.type = XR_TYPE_SYSTEM_EXTENSION_PROPERTIES_ANDROID});

            XrResult result = xrEnumerateSystemExtensionPropertiesANDROID(
                instance,
                systemId,
                extensionsCount,
                &extensionsCount,
                properties.data()
            );

            // Do something based on which extensions are now supported by the system
            break;
    }
}

PFN_xrEnumerateSystemExtensionPropertiesANDROID xrEnumerateSystemExtensionPropertiesANDROID;

XrInstance instance;
XrInstanceCreateInfo createInfo = {XR_TYPE_INSTANCE_CREATE_INFO};
// Initialize the createInfo with appropriate values for the application
CHK_XR(xrCreateInstance(&createInfo, &instance));

// Get the systemId for the system.
XrSystemId systemId;
XrSystemGetInfo getInfo = {XR_TYPE_SYSTEM_GET_INFO};
getInfo.formFactor = XR_FORM_FACTOR_HEAD_MOUNTED_DISPLAY;
CHK_XR(xrGetSystem(instance, &getInfo, &systemId));

// Enumerate the system extension properties.
uint32_t extensionsCount;
xrEnumerateSystemExtensionPropertiesANDROID(instance, systemId, 0, &extensionsCount, NULL);

std::vector<XrSystemExtensionPropertiesANDROID> properties(extensionsCount,
    {.type = XR_TYPE_SYSTEM_EXTENSION_PROPERTIES_ANDROID});

XrResult result = xrEnumerateSystemExtensionPropertiesANDROID(
    instance,
    systemId,
    extensionsCount,
    &extensionsCount,
    properties.data()
);

Sayılar

Sürüm Geçmişi

  • Düzeltme 1, 17.03.2026 (Kenny Vercaemer)

    • İlk uzantı sürümü.