Android XR for OpenXR | Android Developers

Android Dev Summit फिर से शुरू हो गया है. इसमें Android XR के लिए खास तौर पर बनाया गया ट्रैक शामिल है. इन सुविधाओं को आज़माएं और हमें अपने सुझाव/राय दें या शिकायत करें!

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

XR_ANDROID_geospatial

Name String

XR_ANDROID_geospatial

एक्सटेंशन का टाइप

इंस्टेंस एक्सटेंशन

रजिस्टर किया गया एक्सटेंशन नंबर

790

बदलाव

पुष्टि की स्थिति

मंज़ूरी नहीं मिली

एक्सटेंशन और वर्शन डिपेंडेंसी

XR_EXT_future

पिछली बार बदलाव किए जाने की तारीख

2025-12-18

आईपी स्टेटस

बौद्धिक संपत्ति से जुड़े किसी दावे की जानकारी नहीं है.

योगदान देने वाले

जॉन उलमैन, Google
बेन किंग, Google
निहाव जैन, Google
जैरेड फ़ाइंडर, Google

खास जानकारी

यह एक्सटेंशन, Google के जियोस्पेशल एपीआई के लिए जियोस्पेशल ट्रैकिंग की सुविधा देता है. इससे जगह की सटीक जानकारी और ओरिएंटेशन मिलता है. साथ ही, ऐप्लिकेशन को पृथ्वी के हिसाब से कॉन्टेंट दिखाने की अनुमति मिलती है. इसके लिए, यह मोशन ट्रैकिंग, जीपीएस, और अन्य सेंसर के साथ-साथ Google के विज़ुअल पोज़िशनिंग सिस्टम (वीपीएस) का इस्तेमाल करता है. वीपीएस, डिवाइस के कैमरे से ली गई इमेज की तुलना Street View की तस्वीरों से करता है, ताकि जगह की सटीक जानकारी और ओरिएंटेशन का पता लगाया जा सके. जियोस्पेशल एपीआई, अक्सर एक मीटर से कम की पोज़िशनल सटीक जानकारी (जीपीएस से बेहतर) और एक डिग्री से कम की ओरिएंटेशन की सटीक जानकारी देता है.

इस एक्सटेंशन में एपीआई का इस्तेमाल करने के लिए (एक्सटेंशन के काम करने की जांच करने के अलावा), ऐप्लिकेशन को किसी तरीके से पुष्टि करने वाले क्रेडेंशियल सेट करने होंगे. जैसे, XR_ANDROID_google_cloud_auth . सेटअप और गड़बड़ी के नतीजों के बारे में ज़्यादा जानने के लिए, पुष्टि करने वाले एक्सटेंशन का दस्तावेज़ देखें.

अनुमतियां

इस एक्सटेंशन का इस्तेमाल करने के लिए, Android ऐप्लिकेशन के मेनिफ़ेस्ट में android.permission.ACCESS_FINE_LOCATION अनुमति शामिल होनी चाहिए. android.permission.ACCESS_FINE_LOCATION अनुमति को खतरनाक अनुमति माना जाता है. इन फ़ंक्शन का इस्तेमाल करने के लिए, ऐप्लिकेशन को रनटाइम के दौरान अनुमति का अनुरोध करना होगा:

xrCreateGeospatialTrackerANDROID

(सुरक्षा का लेवल: खतरनाक)

सिस्टम की क्षमता की जांच करना

XrSystemGeospatialPropertiesANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

typedef struct XrSystemGeospatialPropertiesANDROID {
    XrStructureType    type;
    void*              next;
    XrBool32           supportsGeospatial;
} XrSystemGeospatialPropertiesANDROID;

सदस्यों की जानकारी

type, इस स्ट्रक्चर का XrStructureType है.
next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर के बारे में नहीं बताया गया है.
supportsGeospatial एक XrBool32 है. इससे पता चलता है कि मौजूदा सिस्टम, जियोस्पेशल सुविधाओं के साथ काम करता है या नहीं.

कोई ऐप्लिकेशन यह जांच कर सकता है कि सिस्टम में जियोस्पेशल सुविधाएं काम करती हैं या नहीं. इसके लिए, xrGetSystemProperties को कॉल करते समय, XrSystemGeospatialPropertiesANDROID स्ट्रक्चर को XrSystemProperties से जोड़ना होगा.

अगर रनटाइम, supportsGeospatial के लिए XR_FALSE दिखाता है, तो इसका मतलब है कि सिस्टम में जियोस्पेशल सुविधाएं काम नहीं करती हैं. इसलिए, xrCreateGeospatialTrackerANDROID से XR_ERROR_FEATURE_UNSUPPORTED दिखाना ज़रूरी है. supportsGeospatial के XR_FALSE होने पर, ऐप्लिकेशन को जियोस्पेशल फ़ंक्शन का इस्तेमाल नहीं करना चाहिए.

सही इस्तेमाल (इंप्लिसिट)

XrSystemGeospatialPropertiesANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन चालू करना ज़रूरी है
type की वैल्यू XR_TYPE_SYSTEM_GEOSPATIAL_PROPERTIES_ANDROID होनी चाहिए
next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए

Geospatial Tracker हैंडल बनाना

XR_DEFINE_HANDLE(XrGeospatialTrackerANDROID)

xrCreateGeospatialTrackerANDROID फ़ंक्शन को इस तरह से तय किया गया है:

XrResult xrCreateGeospatialTrackerANDROID(
    XrSession                                   session,
    const XrGeospatialTrackerCreateInfoANDROID* createInfo,
    XrGeospatialTrackerANDROID*                 geospatialTrackerOutput);

पैरामीटर की जानकारी

session एक XrSession है, जिसमें जियोस्पेशल ट्रैकर चालू रहेगा.
createInfo, XrGeospatialTrackerCreateInfoANDROID स्ट्रक्चर का पॉइंटर है. यह शुरुआती जियोस्पेशल ट्रैकर पैरामीटर के बारे में बताता है.
geospatialTrackerOutput, एक हैंडल का पॉइंटर है. इसमें बनाया गया XrGeospatialTrackerANDROID दिखाया जाता है.

कोई ऐप्लिकेशन, xrCreateGeospatialTrackerANDROID को कॉल करके, XrGeospatialTrackerANDROID हैंडल बना सकता है. इसके बाद, एपीआई कॉल में XrGeospatialTrackerANDROID हैंडल का इस्तेमाल किया जा सकता है. अगर ऐप्लिकेशन को ज़रूरी अनुमतियां नहीं मिली हैं, तो रनटाइम को XR_ERROR_PERMISSION_INSUFFICIENT दिखाना चाहिए . किसी XrSession के लिए, एक समय में सिर्फ़ एक XrGeospatialTrackerANDROID हो सकता है . ऐप्लिकेशन को यह पक्का करना चाहिए कि इस फ़ंक्शन को फिर से कॉल करने से पहले, पिछले सभी XrGeospatialTrackerANDROID ऑब्जेक्ट मिटा दिए गए हों. ऐसा न होने पर, रनटाइम को XR_ERROR_LIMIT_REACHED दिखाना चाहिए . अगर ट्रैकर बन जाता है, तो वह शुरुआत में XR_GEOSPATIAL_TRACKER_STATE_STOPPED_ANDROID स्थिति में होगा. साथ ही, ट्रैकर का इस्तेमाल करने से पहले, ऐप्लिकेशन को स्थिति के XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID में बदलने तक इंतज़ार करना होगा. XrEventDataGeospatialTrackerStateChangedANDROID देखें. अगर ऐप्लिकेशन किसी ऐसे फ़ंक्शन को XrGeospatialTrackerANDROID पास करता है जो XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID स्थिति में नहीं है, तो रनटाइम को XR_ERROR_GEOSPATIAL_TRACKER_NOT_RUNNING_ANDROID दिखाना चाहिए.

XrGeospatialTrackerANDROID हैंडल को ज़रूर xrDestroyGeospatialTrackerANDROID फ़ंक्शन के ज़रिए खाली किया जाना चाहिए.

सही इस्तेमाल (इंप्लिसिट)

xrCreateGeospatialTrackerANDROID को कॉल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन चालू होना ज़रूरी है
session एक मान्य XrSession हैंडल होना चाहिए
createInfo को मान्य XrGeospatialTrackerCreateInfoANDROID स्ट्रक्चर का पॉइंटर होना चाहिए
geospatialTrackerOutput को XrGeospatialTrackerANDROID हैंडल का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

XR_SUCCESS
XR_SESSION_LOSS_PENDING

Failure

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_LIMIT_REACHED
XR_ERROR_OUT_OF_MEMORY
XR_ERROR_PERMISSION_INSUFFICIENT
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_SESSION_LOST
XR_ERROR_VALIDATION_FAILURE

XrGeospatialTrackerCreateInfoANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

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

सदस्यों की जानकारी

type, इस स्ट्रक्चर का XrStructureType है.
next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है.

सही इस्तेमाल (इंप्लिसिट)

XrGeospatialTrackerCreateInfoANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन को चालू करना ज़रूरी है
type की वैल्यू XR_TYPE_GEOSPATIAL_TRACKER_CREATE_INFO_ANDROID होनी चाहिए
next को NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए. यह भी देखें: XrGeospatialTrackerAnchorTrackingInfoANDROID

xrDestroyGeospatialTrackerANDROID फ़ंक्शन को इस तरह से तय किया गया है:

XrResult xrDestroyGeospatialTrackerANDROID(
    XrGeospatialTrackerANDROID                  geospatialTracker);

पैरामीटर की जानकारी

geospatialTracker, XrGeospatialTrackerANDROID है, जिसे मिटाना है.

कोई ऐप्लिकेशन, जियोस्पेशल ट्रैकर और उससे जुड़े संसाधनों को रिलीज़ करने के लिए, xrDestroyGeospatialTrackerANDROID फ़ंक्शन का इस्तेमाल कर सकता है.

सही इस्तेमाल (इंप्लिसिट)

xrDestroyGeospatialTrackerANDROID को कॉल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन चालू होना ज़रूरी है
geospatialTracker एक मान्य XrGeospatialTrackerANDROID हैंडल होना चाहिए

Thread की सुरक्षा

geospatialTracker और किसी भी चाइल्ड हैंडल का ऐक्सेस, बाहरी तौर पर सिंक किया जाना ज़रूरी है

रिटर्न कोड

सफलता

XR_SUCCESS

Failure

XR_ERROR_CALL_ORDER_INVALID
XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_HANDLE_INVALID
XR_ERROR_RUNTIME_FAILURE

जियोस्पेशल ट्रैकर स्टेट

XrGeospatialTrackerStateANDROID एन्यूमरेशन को इस तरह से तय किया गया है:

typedef enum XrGeospatialTrackerStateANDROID {
    XR_GEOSPATIAL_TRACKER_STATE_STOPPED_ANDROID = 0,
    XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID = 1,
    XR_GEOSPATIAL_TRACKER_STATE_INITIALIZATION_FAILED_ANDROID = 2,
    XR_GEOSPATIAL_TRACKER_STATE_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrGeospatialTrackerStateANDROID;

XrGeospatialTrackerStateANDROID एन्यूमरेशन, जियोस्पेशल ट्रैकर की अलग-अलग स्थितियों की पहचान करता है.

इन्यूमरेंट की ये वैल्यू होती हैं:

Enum की जानकारी

XR_GEOSPATIAL_TRACKER_STATE_STOPPED_ANDROID

जियोस्पेशल ट्रैकर काम नहीं कर रहा है.

XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID

जियोस्पेशियल ट्रैकर चालू है और इस्तेमाल किया जा सकता है.

XR_GEOSPATIAL_TRACKER_STATE_INITIALIZATION_FAILED_ANDROID

जियोस्पेशल ट्रैकर को शुरू नहीं किया जा सका. इसलिए, इसका इस्तेमाल कभी नहीं किया जा सकेगा.

XrEventDataGeospatialTrackerStateChangedANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

typedef struct XrEventDataGeospatialTrackerStateChangedANDROID {
    XrStructureType                    type;
    const void*                        next;
    XrGeospatialTrackerANDROID         geospatialTracker;
    XrGeospatialTrackerStateANDROID    state;
    XrResult                           initializationResult;
    XrTime                             time;
} XrEventDataGeospatialTrackerStateChangedANDROID;

सदस्यों की जानकारी

type, इस स्ट्रक्चर का XrStructureType है.
next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है.
geospatialTracker, XrGeospatialTrackerANDROID है, जिसकी स्थिति बदल गई है.
state, नया XrGeospatialTrackerStateANDROID है.
अगर state की वैल्यू XR_GEOSPATIAL_TRACKER_STATE_INITIALIZATION_FAILED_ANDROID है, तो गड़बड़ी का नतीजा initializationResult होगा. अगर ऐसा नहीं है, तो गड़बड़ी का नतीजा XR_SUCCESS होगा.
time वह XrTime है जब स्थिति में बदलाव हुआ.

जियोस्पेशल ट्रैकर की स्थिति बदलने पर, XrEventDataGeospatialTrackerStateChangedANDROID स्ट्रक्चर भेजा जाता है. अगर ऐप्लिकेशन में मान्य XrGeospatialTrackerANDROID है, तो उसे इस इवेंट के लिए पोल करना चाहिए. ट्रैकर के लिए मिले पहले इवेंट में state XR_GEOSPATIAL_TRACKER_STATE_STOPPED_ANDROID होगा. रनटाइम के हिसाब से तय की गई समयावधि के बाद, स्थिति ज़रूर XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID या XR_GEOSPATIAL_TRACKER_STATE_INITIALIZATION_FAILED_ANDROID में बदलनी चाहिए. इस ट्रांज़िशन में कितना समय लगेगा, यह तय नहीं है. अगर state बदलकर XR_GEOSPATIAL_TRACKER_STATE_INITIALIZATION_FAILED_ANDROID हो जाता है, तो यह इस ट्रैकर के लिए मिला आखिरी इवेंट होना चाहिए. साथ ही, initializationResult फ़ील्ड में गड़बड़ी का कोड होगा. गड़बड़ी होने में कुछ सेकंड लग सकते हैं. इस मामले में, ऐप्लिकेशन को ट्रैकर को बंद कर देना चाहिए. अगर state बदलकर XR_GEOSPATIAL_TRACKER_STATE_STOPPED_ANDROID हो जाता है, तो पहले से बनाए गए सभी जियोस्पेशल ऐंकर को ट्रैक करना हमेशा के लिए बंद करना होगा. साथ ही, ऐप्लिकेशन को उन्हें मिटा देना चाहिए. स्टेटस XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID और XR_GEOSPATIAL_TRACKER_STATE_STOPPED_ANDROID के बीच कई बार बदल सकता है.

सही इस्तेमाल (इंप्लिसिट)

XrEventDataGeospatialTrackerStateChangedANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन चालू करना ज़रूरी है
type की वैल्यू XR_TYPE_EVENT_DATA_GEOSPATIAL_TRACKER_STATE_CHANGED_ANDROID होनी चाहिए
next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए

जियोस्पेशल पोज़

XrGeospatialPoseANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

typedef struct XrGeospatialPoseANDROID {
    XrQuaternionf    eastUpSouthOrientation;
    double           latitude;
    double           longitude;
    double           altitude;
} XrGeospatialPoseANDROID;

सदस्यों की जानकारी

eastUpSouthOrientation एक XrQuaternionf है, जो कोऑर्डिनेट सिस्टम के हिसाब से ओरिएंटेशन तय करता है. इसमें +X=पूर्व, +Y=ऊपर, और +Z=दक्षिण होता है.
latitude, डिग्री में अक्षांश है. यह -90 और +90 के बीच होना चाहिए.
longitude, -180 और +180 के बीच डिग्री में देशांतर है.
altitude, WGS84 एलिप्सॉइड से ऊपर मीटर में ऊंचाई है.

XrGeospatialPoseANDROID स्ट्रक्चर, WGS84 एलिप्सॉइड का इस्तेमाल करके, पृथ्वी के हिसाब से पोज़िशन और ओरिएंटेशन को दिखाता है.

सही इस्तेमाल (इंप्लिसिट)

XrGeospatialPoseANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन चालू करना ज़रूरी है
latitude की वैल्यू, double की मान्य वैल्यू होनी चाहिए
longitude की वैल्यू, double की मान्य वैल्यू होनी चाहिए
altitude की वैल्यू, double की मान्य वैल्यू होनी चाहिए

XrGeospatialPoseFlagBitsANDROID एन्यूमरेशन को इस तरह से तय किया गया है:

// Flag bits for XrGeospatialPoseFlagsANDROID
static const XrGeospatialPoseFlagsANDROID XR_GEOSPATIAL_POSE_ORIENTATION_VALID_BIT_ANDROID = 0x00000001;
static const XrGeospatialPoseFlagsANDROID XR_GEOSPATIAL_POSE_POSITION_VALID_BIT_ANDROID = 0x00000002;

XrGeospatialPoseFlagBitsANDROID एन्यूमरेशन, जियोस्पेशल पोज़ के लिए फ़्लैग तय करता है.

फ़्लैग बिट के ये मतलब होते हैं:

फ़्लैग की जानकारी

XR_GEOSPATIAL_POSE_ORIENTATION_VALID_BIT_ANDROID — इससे पता चलता है कि ओरिएंटेशन मेंबर में मान्य डेटा मौजूद है
XR_GEOSPATIAL_POSE_POSITION_VALID_BIT_ANDROID — इससे पता चलता है कि पोज़िशन मेंबर में मान्य डेटा है

XrGeospatialPoseFlagsANDROID टाइप, XrGeospatialPoseFlagBitsANDROID का बिटमास्क है.

typedef XrFlags64 XrGeospatialPoseFlagsANDROID;

XrPosef को जियोस्पेशल पोज़ में बदलना

xrLocateGeospatialPoseFromPoseANDROID फ़ंक्शन को इस तरह से तय किया गया है:

XrResult xrLocateGeospatialPoseFromPoseANDROID(
    XrGeospatialTrackerANDROID                  geospatialTracker,
    const XrGeospatialPoseFromPoseLocateInfoANDROID* locateInfo,
    XrGeospatialPoseResultANDROID*              geospatialPoseResult);

पैरामीटर की जानकारी

geospatialTracker, XrGeospatialTrackerANDROID है. इसका इस्तेमाल, कन्वर्ज़न के लिए किया जाता है.
locateInfo, XrGeospatialPoseFromPoseLocateInfoANDROID का पॉइंटर है. इसमें क्वेरी पैरामीटर शामिल हैं.
geospatialPoseResult, XrGeospatialPoseResultANDROID का पॉइंटर है, जिसे नतीजा मिलता है.

xrLocateGeospatialPoseFromPoseANDROID फ़ंक्शन, XrGeospatialPoseFromPoseLocateInfoANDROID :: space में मौजूद पोज़ को जियोस्पेशियल पोज़ में बदलता है. अगर geospatialTracker की स्थिति XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID नहीं है, तो रनटाइम को XR_ERROR_GEOSPATIAL_TRACKER_NOT_RUNNING_ANDROID दिखाना चाहिए . अगर फ़ंक्शन XR_SUCCESS दिखाता है, तो geospatialPoseResult का XrGeospatialPoseResultANDROID :: poseFlags फ़ील्ड तय करता है कि कौनसे आउटपुट फ़ील्ड मान्य हैं. अगर XR_GEOSPATIAL_POSE_POSITION_VALID_BIT_ANDROID को XrGeospatialPoseResultANDROID :: poseFlags में सेट नहीं किया गया है, तो ऐप्लिकेशन को XrGeospatialPoseResultANDROID में मौजूद XrGeospatialPoseANDROID :: latitude , XrGeospatialPoseANDROID :: longitude , XrGeospatialPoseANDROID :: altitude , XrGeospatialPoseResultANDROID :: horizontalAccuracy या XrGeospatialPoseResultANDROID :: verticalAccuracy फ़ील्ड को नहीं पढ़ना चाहिए. अगर XrGeospatialPoseResultANDROID :: poseFlags में XR_GEOSPATIAL_POSE_ORIENTATION_VALID_BIT_ANDROID सेट नहीं है, तो ऐप्लिकेशन को XrGeospatialPoseANDROID :: eastUpSouthOrientation या XrGeospatialPoseResultANDROID :: orientationYawAccuracy को नहीं पढ़ना चाहिए. अगर XR_GEOSPATIAL_POSE_POSITION_VALID_BIT_ANDROID सेट नहीं है, तो XR_GEOSPATIAL_POSE_ORIENTATION_VALID_BIT_ANDROID भी सेट नहीं होना चाहिए.

अगर जगह की जानकारी उम्मीद के मुताबिक सटीक नहीं है, तो हो सकता है कि डिवाइस, वीपीएस लोकलाइज़ेशन का इस्तेमाल न कर रहा हो. ऐप्लिकेशन, उपयोगकर्ता को अपने डिवाइस को साइनबोर्ड और इमारतों की तरफ़ पॉइंट करने के लिए कह सकता है, ताकि जगह की जानकारी को बेहतर बनाया जा सके.

सही इस्तेमाल (इंप्लिसिट)

xrLocateGeospatialPoseFromPoseANDROID को कॉल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन को चालू करना ज़रूरी है
geospatialTracker एक मान्य XrGeospatialTrackerANDROID हैंडल होना चाहिए
locateInfo को मान्य XrGeospatialPoseFromPoseLocateInfoANDROID स्ट्रक्चर का पॉइंटर होना ज़रूरी है
geospatialPoseResult को XrGeospatialPoseResultANDROID स्ट्रक्चर का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

XR_SUCCESS
XR_SESSION_LOSS_PENDING

Failure

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_GEOSPATIAL_TRACKER_NOT_RUNNING_ANDROID
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_POSE_INVALID
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_SESSION_LOST
XR_ERROR_TIME_INVALID
XR_ERROR_VALIDATION_FAILURE

XrGeospatialPoseFromPoseLocateInfoANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

typedef struct XrGeospatialPoseFromPoseLocateInfoANDROID {
    XrStructureType    type;
    const void*        next;
    XrSpace            space;
    XrTime             time;
    XrPosef            pose;
} XrGeospatialPoseFromPoseLocateInfoANDROID;

सदस्यों की जानकारी

type, इस स्ट्रक्चर का XrStructureType है.
next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है.
space वह XrSpace है जिसमें pose को तय किया गया है.
time वह XrTime है जिस पर pose का आकलन करना है.
pose, space में XrPosef है, ताकि इसे जियोस्पेशियल पोज़ में बदला जा सके.

सही इस्तेमाल (इंप्लिसिट)

XrGeospatialPoseFromPoseLocateInfoANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन चालू करना ज़रूरी है
type की वैल्यू XR_TYPE_GEOSPATIAL_POSE_FROM_POSE_LOCATE_INFO_ANDROID होनी चाहिए
next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए
space XrSpace हैंडल मान्य होना चाहिए

XrGeospatialPoseResultANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

typedef struct XrGeospatialPoseResultANDROID {
    XrStructureType                 type;
    void*                           next;
    XrGeospatialPoseFlagsANDROID    poseFlags;
    XrGeospatialPoseANDROID         geospatialPose;
    double                          horizontalAccuracy;
    double                          verticalAccuracy;
    double                          orientationYawAccuracy;
} XrGeospatialPoseResultANDROID;

सदस्यों की जानकारी

type, इस स्ट्रक्चर का XrStructureType है.
next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है.
poseFlags, XrGeospatialPoseFlagsANDROID का बिटमास्क है. इससे पोज़ कॉम्पोनेंट की वैधता का पता चलता है.
geospatialPose, XrGeospatialPoseANDROID का नतीजा है.
horizontalAccuracy, जियोस्पेशल पोज़ की पोज़िशन की हॉरिज़ॉन्टल सटीक जानकारी का अनुमान है. इसे दिए गए अक्षांश और देशांतर के आस-पास 68% कॉन्फ़िडेंस लेवल के सर्कल के दायरे (मीटर में) के तौर पर तय किया जाता है.
verticalAccuracy, जियोस्पेशल पोज़ की पोज़िशन की अनुमानित वर्टिकल सटीक जानकारी है. इसे दी गई ऊंचाई के आस-पास 68% कॉन्फ़िडेंस लेवल की दूरी (मीटर में) के तौर पर तय किया जाता है. दूसरे शब्दों में, इस बात की 68% संभावना है कि सही ऊंचाई [ XrGeospatialPoseANDROID :: altitude - verticalAccuracy , XrGeospatialPoseANDROID :: altitude \+ verticalAccuracy ] रेंज में हो.
orientationYawAccuracy, जियोस्पेशल पोज़ ओरिएंटेशन के अनुमानित यॉ की सटीक जानकारी है. इसे दिए गए ओरिएंटेशन के आस-पास, 68% कॉन्फ़िडेंस लेवल की डिग्री में रेडियस के तौर पर तय किया जाता है.

सही इस्तेमाल (इंप्लिसिट)

XrGeospatialPoseResultANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन चालू करना ज़रूरी है
type की वैल्यू XR_TYPE_GEOSPATIAL_POSE_RESULT_ANDROID होनी चाहिए
next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए

जियोस्पेशल पोज़ को XrPosef में बदलना

xrLocateGeospatialPoseANDROID फ़ंक्शन को इस तरह से तय किया गया है:

XrResult xrLocateGeospatialPoseANDROID(
    XrGeospatialTrackerANDROID                  geospatialTracker,
    const XrGeospatialPoseLocateInfoANDROID*    locateInfo,
    XrSpaceLocation*                            location);

पैरामीटर की जानकारी

geospatialTracker, XrGeospatialTrackerANDROID है. इसका इस्तेमाल, कन्वर्ज़न के लिए किया जाता है.
locateInfo, XrGeospatialPoseLocateInfoANDROID का पॉइंटर है. इसमें क्वेरी पैरामीटर शामिल होते हैं.
location, XrSpaceLocation का एक पॉइंटर है, जो नतीजे के तौर पर पोज़ की जानकारी पाता है.

xrLocateGeospatialPoseANDROID फ़ंक्शन, जियोस्पेशल पोज़ को XrSpaceLocation में बदलता है. अगर XrGeospatialTrackerANDROID नहीं चल रहा है, तो रनटाइम को XR_ERROR_GEOSPATIAL_TRACKER_NOT_RUNNING_ANDROID दिखाना चाहिए . अगर फ़ंक्शन XR_SUCCESS दिखाता है, तो location का XrSpaceLocation :: locationFlags फ़ील्ड यह तय करता है कि कौनसे आउटपुट फ़ील्ड मान्य हैं.

सही इस्तेमाल (इंप्लिसिट)

xrLocateGeospatialPoseANDROID को कॉल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन को चालू करना ज़रूरी है
geospatialTracker एक मान्य XrGeospatialTrackerANDROID हैंडल होना चाहिए
locateInfo को किसी मान्य XrGeospatialPoseLocateInfoANDROID स्ट्रक्चर का पॉइंटर होना चाहिए
location को XrSpaceLocation स्ट्रक्चर का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

XR_SUCCESS
XR_SESSION_LOSS_PENDING

Failure

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_GEOSPATIAL_COORDINATES_INVALID_ANDROID
XR_ERROR_GEOSPATIAL_TRACKER_NOT_RUNNING_ANDROID
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_POSE_INVALID
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_SESSION_LOST
XR_ERROR_TIME_INVALID
XR_ERROR_VALIDATION_FAILURE

XrGeospatialPoseLocateInfoANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

typedef struct XrGeospatialPoseLocateInfoANDROID {
    XrStructureType            type;
    const void*                next;
    XrSpace                    space;
    XrTime                     time;
    XrGeospatialPoseANDROID    geospatialPose;
} XrGeospatialPoseLocateInfoANDROID;

सदस्यों की जानकारी

type, इस स्ट्रक्चर का XrStructureType है.
next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है.
space, XrSpace है. इसमें नतीजे के तौर पर मिलने वाले पोज़ को दिखाया जाएगा.
time वह XrTime है जिस पर पोज़ का पता लगाना है.
geospatialPose, वह XrGeospatialPoseANDROID है जिसे बदलना है.

सही इस्तेमाल (इंप्लिसिट)

XrGeospatialPoseLocateInfoANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन को चालू करना ज़रूरी है
type की वैल्यू XR_TYPE_GEOSPATIAL_POSE_LOCATE_INFO_ANDROID होनी चाहिए
next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए
space XrSpace हैंडल मान्य होना चाहिए
geospatialPose XrGeospatialPoseANDROID स्ट्रक्चर मान्य होना चाहिए

वीपीएन की उपलब्धता

XrVPSAvailabilityANDROID एन्यूमरेशन को इस तरह से तय किया गया है:

typedef enum XrVPSAvailabilityANDROID {
    XR_VPS_AVAILABILITY_UNAVAILABLE_ANDROID = 1,
    XR_VPS_AVAILABILITY_AVAILABLE_ANDROID = 2,
    XR_VPSAVAILABILITY_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrVPSAvailabilityANDROID;

XrVPSAvailabilityANDROID एन्यूमरेशन से वीपीएस की उपलब्धता का पता चलता है.

इन्यूमरेंट की ये वैल्यू होती हैं:

Enum की जानकारी

XR_VPS_AVAILABILITY_UNAVAILABLE_ANDROID

दी गई जगह के आस-पास वीपीएस की सुविधा उपलब्ध नहीं है.

XR_VPS_AVAILABILITY_AVAILABLE_ANDROID

दी गई जगह के आस-पास वीपीएस की सुविधा उपलब्ध है.

xrCheckVpsAvailabilityAsyncANDROID फ़ंक्शन को इस तरह से तय किया गया है:

XrResult xrCheckVpsAvailabilityAsyncANDROID(
    XrSession                                   session,
    double                                      latitude,
    double                                      longitude,
    XrFutureEXT*                                future);

पैरामीटर की जानकारी

session, XrSession है, जिसका इस्तेमाल जांच के लिए किया जाता है.
latitude, डिग्री में अक्षांश है.
longitude, डिग्री में देशांतर है.
future, XrFutureEXT का एक पॉइंटर है. इसमें एसिंक्रोनस ऑपरेशन का नतीजा सेव होगा.

विज़ुअल पोज़िशनिंग सर्विस (वीपीएस) की उपलब्धता से पता चलता है कि किसी जगह पर जियोस्पेशल डेटा को ज़्यादा सटीक बनाने के लिए, वीपीएस का इस्तेमाल किया जा सकता है या नहीं.

xrCheckVpsAvailabilityAsyncANDROID फ़ंक्शन, किसी जगह पर वीपीएस की उपलब्धता की एसिंक्रोनस जांच शुरू करता है. इस फ़ंक्शन को कॉल करने के लिए, ऐप्लिकेशन को XrGeospatialTrackerANDROID की ज़रूरत नहीं होती. साथ ही, इस कार्रवाई के नतीजे का इस्तेमाल करके, यह तय किया जा सकता है कि इसे बनाना है या नहीं. अगर ऐप्लिकेशन को ज़रूरी अनुमतियां नहीं मिली हैं, तो रनटाइम को XR_ERROR_PERMISSION_INSUFFICIENT दिखाना चाहिए .

सही इस्तेमाल (इंप्लिसिट)

xrCheckVpsAvailabilityAsyncANDROID को कॉल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन को चालू करना ज़रूरी है
session एक मान्य XrSession हैंडल होना चाहिए
latitude की वैल्यू, double की मान्य वैल्यू होनी चाहिए
longitude की वैल्यू, double की मान्य वैल्यू होनी चाहिए
future को XrFutureEXT वैल्यू का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

XR_SUCCESS
XR_SESSION_LOSS_PENDING

Failure

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_GEOSPATIAL_COORDINATES_INVALID_ANDROID
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_SESSION_LOST
XR_ERROR_VALIDATION_FAILURE

xrCheckVpsAvailabilityCompleteANDROID फ़ंक्शन को इस तरह से तय किया गया है:

XrResult xrCheckVpsAvailabilityCompleteANDROID(
    XrSession                                   session,
    XrFutureEXT                                 future,
    XrVPSAvailabilityCheckCompletionANDROID*    completion);

पैरामीटर की जानकारी

session, जांच के लिए इस्तेमाल किया जाने वाला XrSession है.
future, xrCheckVpsAvailabilityAsyncANDROID से मिला XrFutureEXT है.
completion, XrVPSAvailabilityCheckCompletionANDROID का एक पॉइंटर है, जिसे नतीजा मिलता है.

सही इस्तेमाल (इंप्लिसिट)

xrCheckVpsAvailabilityCompleteANDROID को कॉल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन को चालू करना ज़रूरी है
session एक मान्य XrSession हैंडल होना चाहिए
completion को XrVPSAvailabilityCheckCompletionANDROID स्ट्रक्चर का पॉइंटर होना चाहिए

रिटर्न कोड

सफलता

XR_SUCCESS
XR_SESSION_LOSS_PENDING

Failure

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_FUTURE_INVALID_EXT
XR_ERROR_FUTURE_PENDING_EXT
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_SESSION_LOST
XR_ERROR_VALIDATION_FAILURE

XrVPSAvailabilityCheckCompletionANDROID स्ट्रक्चर को इस तरह से तय किया गया है:

typedef struct XrVPSAvailabilityCheckCompletionANDROID {
    XrStructureType             type;
    void*                       next;
    XrResult                    futureResult;
    XrVPSAvailabilityANDROID    availability;
} XrVPSAvailabilityCheckCompletionANDROID;

सदस्यों की जानकारी

type, इस स्ट्रक्चर का XrStructureType है.
next, NULL है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है.
futureResult, जांच की कार्रवाई का XrResult है. अगर futureResult, XR_ERROR_GEOSPATIAL_CLOUD_AUTH_FAILED_ANDROID है, तो next चेन में मौजूद स्ट्रक्चर से, गड़बड़ी के बारे में ज़्यादा जानकारी मिल सकती है.
availability, XrVPSAvailabilityANDROID का नतीजा है. ऐप्लिकेशन को यह फ़ील्ड तब तक नहीं पढ़ना चाहिए, जब तक futureResult की वैल्यू XR_SUCCESS न हो.

आने वाले समय में मिलने वाले रिटर्न कोड

futureResult वैल्यू:

सफलता

XR_SUCCESS
XR_SESSION_LOSS_PENDING

Failure

XR_ERROR_RUNTIME_FAILURE
XR_ERROR_INSTANCE_LOST
XR_ERROR_SESSION_LOST
XR_ERROR_GEOSPATIAL_CLOUD_AUTH_FAILED_ANDROID

सही इस्तेमाल (इंप्लिसिट)

XrVPSAvailabilityCheckCompletionANDROID का इस्तेमाल करने से पहले, XR_ANDROID_geospatial एक्सटेंशन को चालू करना ज़रूरी है
type की वैल्यू XR_TYPE_VPS_AVAILABILITY_CHECK_COMPLETION_ANDROID होनी चाहिए
next NULL या स्ट्रक्चर चेन में अगले स्ट्रक्चर का मान्य पॉइंटर होना चाहिए
futureResult must be a valid XrResult value
availability XrVPSAvailabilityANDROID की मान्य वैल्यू होनी चाहिए

उदाहरण

जियोस्पेशल ट्रैकर सेट अप करना

PFN_xrCheckVpsAvailabilityAsyncANDROID xrCheckVpsAvailabilityAsyncANDROID;
PFN_xrPollFutureEXT xrPollFutureEXT;
PFN_xrCheckVpsAvailabilityCompleteANDROID xrCheckVpsAvailabilityCompleteANDROID;
PFN_xrCreateGeospatialTrackerANDROID xrCreateGeospatialTrackerANDROID;
XrInstance instance = XR_NULL_HANDLE;
XrSystemId systemId = XR_NULL_SYSTEM_ID;
XrSession session = XR_NULL_HANDLE;
double lat = 37.422, lng = -122.084;

// Check for support.
XrSystemGeospatialPropertiesANDROID geospatialSystemProperties{
    XR_TYPE_SYSTEM_GEOSPATIAL_PROPERTIES_ANDROID};
XrSystemProperties systemProperties{XR_TYPE_SYSTEM_PROPERTIES,
                                    &geospatialSystemProperties};
CHK_XR(xrGetSystemProperties(instance, systemId, &systemProperties));
if (!geospatialSystemProperties.supportsGeospatial) {
  return;
}

// Check VPS Availability.
XrFutureEXT future = XR_NULL_FUTURE_EXT;
CHK_XR(xrCheckVpsAvailabilityAsyncANDROID(session, lat, lng, &future));

XrFuturePollInfoEXT pollInfo{XR_TYPE_FUTURE_POLL_INFO_EXT};
XrFuturePollResultEXT pollResult{XR_TYPE_FUTURE_POLL_RESULT_EXT};
pollInfo.future = future;
pollResult.state = XR_FUTURE_STATE_PENDING_EXT;
while (pollResult.state == XR_FUTURE_STATE_PENDING_EXT) {
  // Do in render loop/state loop.
  CHK_XR(xrPollFutureEXT(instance, &pollInfo, &pollResult));
}

XrVPSAvailabilityCheckCompletionANDROID vpsCompletion{
    XR_TYPE_VPS_AVAILABILITY_CHECK_COMPLETION_ANDROID};
CHK_XR(xrCheckVpsAvailabilityCompleteANDROID(session, future, &vpsCompletion));
if (vpsCompletion.futureResult == XR_SUCCESS) {
  if (vpsCompletion.availability == XR_VPS_AVAILABILITY_UNAVAILABLE_ANDROID) {
    // Visual Positioning Service is not available. Accuracy of positions and
    // orientations from Geospatial APIs are expected to be lower at this location.
  } else {
    // Visual Positioning Service is available. Higher accuracy of position and
    // orientation is achievable at this location.
  }
}

// Create Geospatial Tracker.
XrGeospatialTrackerCreateInfoANDROID createInfo{
    XR_TYPE_GEOSPATIAL_TRACKER_CREATE_INFO_ANDROID};
XrGeospatialTrackerANDROID geospatialTracker = XR_NULL_HANDLE;
CHK_XR(xrCreateGeospatialTrackerANDROID(session, &createInfo, &geospatialTracker));

// In application main event loop:
while (true) {
  XrEventDataBuffer event = {XR_TYPE_EVENT_DATA_BUFFER};
  if (xrPollEvent(instance, &event) != XR_SUCCESS) {
    continue;
  }
  switch (event.type) {
    case XR_TYPE_EVENT_DATA_GEOSPATIAL_TRACKER_STATE_CHANGED_ANDROID:
      const XrEventDataGeospatialTrackerStateChangedANDROID& eventData =
          *reinterpret_cast<XrEventDataGeospatialTrackerStateChangedANDROID*>(&event);
      switch (eventData.state) {
        case XR_GEOSPATIAL_TRACKER_STATE_STOPPED_ANDROID:
          // Destroy existing anchors, if any.
          break;
        case XR_GEOSPATIAL_TRACKER_STATE_RUNNING_ANDROID:
          // Start adding content.
          break;
        case XR_GEOSPATIAL_TRACKER_STATE_INITIALIZATION_FAILED_ANDROID:
          // Handle eventData.initializationResult error result.
          break;
      }
  }
}

जियोस्पेशल पोज़ एपीआई को कॉल करना

PFN_xrLocateGeospatialPoseFromPoseANDROID xrLocateGeospatialPoseFromPoseANDROID;
PFN_xrLocateGeospatialPoseANDROID xrLocateGeospatialPoseANDROID;

XrGeospatialTrackerANDROID geospatialTracker;

// Get pose from view space.
XrSpace viewSpace;
XrPosef identityPose = {{0,0,0,1},{0,0,0}};
XrGeospatialPoseFromPoseLocateInfoANDROID poseGetInfo{
    XR_TYPE_GEOSPATIAL_POSE_FROM_POSE_LOCATE_INFO_ANDROID};
XrGeospatialPoseResultANDROID poseResult{
    XR_TYPE_GEOSPATIAL_POSE_RESULT_ANDROID};
poseGetInfo.space = viewSpace;
poseGetInfo.pose = identityPose;
poseGetInfo.time = 0;  // Next frame timestamp.
CHK_XR(xrLocateGeospatialPoseFromPoseANDROID(geospatialTracker, &poseGetInfo, &poseResult));
if ((poseResult.poseFlags & XR_GEOSPATIAL_POSE_ORIENTATION_VALID_BIT_ANDROID) &&
    (poseResult.poseFlags & XR_GEOSPATIAL_POSE_POSITION_VALID_BIT_ANDROID)) {
  // poseResult.geospatialPose is valid.
}

// Convert Geospatial pose to an XrSpaceLocation.
XrGeospatialPoseLocateInfoANDROID poseLocateInfo{
    XR_TYPE_GEOSPATIAL_POSE_LOCATE_INFO_ANDROID};
XrSpaceLocation location{XR_TYPE_SPACE_LOCATION};
poseLocateInfo.space = viewSpace;
poseLocateInfo.geospatialPose = poseResult.geospatialPose;
poseLocateInfo.time = 0; // Next frame timestamp.
CHK_XR(xrLocateGeospatialPoseANDROID(geospatialTracker, &poseLocateInfo, &location));
if ((location.locationFlags & XR_SPACE_LOCATION_ORIENTATION_VALID_BIT) &&
    (location.locationFlags & XR_SPACE_LOCATION_POSITION_VALID_BIT)) {
  // location.pose is valid.
}

नए ऑब्जेक्ट टाइप

XrGeospatialTrackerANDROID

नए स्ट्रक्चर

XrEventDataGeospatialTrackerStateChangedANDROID
XrGeospatialPoseANDROID
XrGeospatialPoseFromPoseLocateInfoANDROID
XrGeospatialPoseLocateInfoANDROID
XrGeospatialPoseResultANDROID
XrGeospatialTrackerCreateInfoANDROID
XrVPSAvailabilityCheckCompletionANDROID
XrSystemProperties को एक्सटेंड करना :
- XrSystemGeospatialPropertiesANDROID

नए Enum

XrGeospatialPoseFlagBitsANDROID
XrGeospatialTrackerStateANDROID
XrVPSAvailabilityANDROID

नए बिटमास्क

XrGeospatialPoseFlagsANDROID

नए Enum कॉन्सटेंट

XR_ANDROID_GEOSPATIAL_EXTENSION_NAME
XR_ANDROID_geospatial_SPEC_VERSION
XrObjectType को एक्सटेंड करना :
- XR_OBJECT_TYPE_GEOSPATIAL_TRACKER_ANDROID
XrResult को एक्सटेंड करना :
- XR_ERROR_GEOSPATIAL_CLOUD_AUTH_FAILED_ANDROID
- XR_ERROR_GEOSPATIAL_COORDINATES_INVALID_ANDROID
- XR_ERROR_GEOSPATIAL_TRACKER_NOT_RUNNING_ANDROID
XrStructureType को एक्सटेंड करना :
- XR_TYPE_EVENT_DATA_GEOSPATIAL_TRACKER_STATE_CHANGED_ANDROID
- XR_TYPE_GEOSPATIAL_POSE_FROM_POSE_LOCATE_INFO_ANDROID
- XR_TYPE_GEOSPATIAL_POSE_LOCATE_INFO_ANDROID
- XR_TYPE_GEOSPATIAL_POSE_RESULT_ANDROID
- XR_TYPE_GEOSPATIAL_TRACKER_CREATE_INFO_ANDROID
- XR_TYPE_SYSTEM_GEOSPATIAL_PROPERTIES_ANDROID
- XR_TYPE_VPS_AVAILABILITY_CHECK_COMPLETION_ANDROID

समस्याएं

वर्शन इतिहास

संशोधन 1, 18-12-2025 (बेन किंग)
- एक्सटेंशन का शुरुआती ब्यौरा.