Name String
XR_ANDROID_trackables_object
एक्सटेंशन टाइप
इंस्टेंस एक्सटेंशन
रजिस्टर किया गया एक्सटेंशन नंबर
467
बदलाव
1
एक्सटेंशन और वर्शन की डिपेंडेंसी
पिछली बार बदलाव करने की तारीख
2024-10-03
आईपी स्टेटस
आईपी पर कोई दावा नहीं किया गया है.
योगदान देने वाले
स्पेंसर क्विन, Google
निहाव जैन, Google
जॉन पर्सी, Google
जेरेड फ़ाइंडर, Google
लेवाना चेन, Google
केनी वर्कमेयर, Google
खास जानकारी
इस एक्सटेंशन की मदद से, किसी ऑब्जेक्ट को ट्रैक किया जा सकता है. उदाहरण के लिए, कीबोर्ड, माउस, और आस-पास मौजूद अन्य ऑब्जेक्ट.
ऑब्जेक्ट ट्रैक करना
यह एक्सटेंशन, XrTrackableTypeANDROID में XR_TRACKABLE_TYPE_OBJECT_ANDROID
जोड़ता है.
ऐप्लिकेशन, ऑब्जेक्ट को ट्रैक करने के लिए, xrCreateTrackableTrackerANDROID को कॉल करके XrTrackableTrackerANDROID बना सकता है. इसके लिए, XrTrackableTrackerCreateInfoANDROID::trackableType में ट्रैक किए जा सकने वाले टाइप के तौर पर XR_TRACKABLE_TYPE_OBJECT_ANDROID
तय करना ज़रूरी है.
ट्रैक किया जा सकने वाला ऑब्जेक्ट पाना
xrGetTrackableObjectANDROID फ़ंक्शन को इस तरह से परिभाषित किया गया है:
XrResult xrGetTrackableObjectANDROID(
XrTrackableTrackerANDROID tracker,
const XrTrackableGetInfoANDROID* getInfo,
XrTrackableObjectANDROID* objectOutput);
पैरामीटर की जानकारी
tracker
वह XrTrackableTrackerANDROID है जिसकी क्वेरी की जानी है.getInfo
, XrTrackableGetInfoANDROID है. इसमें ट्रैक किए जा सकने वाले ऑब्जेक्ट को पाने के लिए इस्तेमाल की जाने वाली जानकारी होती है.objectOutput
, XrTrackableObjectANDROID स्ट्रक्चर का पॉइंटर है, जिसमें ट्रैक किया जा सकने वाला ऑब्जेक्ट दिखाया जाता है.
अगर XrTrackableANDROID
का ट्रैक किया जा सकने वाला टाइप XR_TRACKABLE_TYPE_OBJECT_ANDROID
नहीं है या XrTrackableTrackerANDROID का ट्रैक किया जा सकने वाला टाइप XR_TRACKABLE_TYPE_OBJECT_ANDROID
नहीं है, तो XR_ERROR_MISMATCHING_TRACKABLE_TYPE_ANDROID
दिखाया जाएगा.
मान्य इस्तेमाल (इंप्लिसिट)
- xrGetTrackableObjectANDROID को कॉल करने से पहले,
XR_ANDROID_trackables_object
एक्सटेंशन चालू होना- ज़रूरी है
tracker
एक मान्य XrTrackableTrackerANDROID हैंडल होना चाहिएgetInfo
को किसी मान्य XrTrackableGetInfoANDROID स्ट्रक्चर का पॉइंटर होना चाहिएobjectOutput
XrTrackableObjectANDROID स्ट्रक्चर का पॉइंटर होना ज़रूरी है
रिटर्न कोड
XR_SUCCESS
XR_SESSION_LOSS_PENDING
XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_VALIDATION_FAILURE
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_SESSION_LOST
XR_ERROR_SESSION_NOT_RUNNING
XR_ERROR_TIME_INVALID
XrTrackableObjectANDROID स्ट्रक्चर को इस तरह परिभाषित किया गया है:
typedef struct XrTrackableObjectANDROID {
XrStructureType type;
void* next;
XrTrackingStateANDROID trackingState;
XrPosef centerPose;
XrExtent3DfEXT extents;
XrObjectLabelANDROID objectLabel;
XrTime lastUpdatedTime;
} XrTrackableObjectANDROID;
पैसे चुकाकर बने सदस्यों के ब्यौरे
type
इस स्ट्रक्चर का XrStructureType है.next
,NULL
है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर है. OpenXR के मुख्य वर्शन या इस एक्सटेंशन में, इस तरह के स्ट्रक्चर तय नहीं किए गए हैं.trackingState
, ऑब्जेक्ट का XrTrackingStateANDROID है.centerPose
, XrTrackableGetInfoANDROID::baseSpace में मौजूद ऑब्जेक्ट का XrPosef है.extents
, ऑब्जेक्ट का XrExtent3DfEXT डाइमेंशन है.objectLabel
, XrObjectLabelANDROID है, जिसे रनटाइम ने इस ऑब्जेक्ट के लिए तय किया है.lastUpdatedTime
, ऑब्जेक्ट के आखिरी अपडेट काXrTime
है.
मान्य इस्तेमाल (इंप्लिसिट)
- XrTrackableObjectANDROID का इस्तेमाल करने से पहले,
XR_ANDROID_trackables_object
एक्सटेंशन चालू होना- ज़रूरी है
type
होनी चाहिएXR_TYPE_TRACKABLE_OBJECT_ANDROID
next
NULL
या स्ट्रक्चर चेन में अगले स्ट्रक्चर के लिए मान्य पॉइंटर होना चाहिएtrackingState
XrTrackingStateANDROID की मान्य वैल्यू होनी चाहिएobjectLabel
की वैल्यू, XrObjectLabelANDROID की मान्य वैल्यू होनी चाहिए
XrObjectLabelANDROID एनम, XrTrackableANDROID
ऑब्जेक्ट के लिए एक लेबल है.
typedef enum XrObjectLabelANDROID {
XR_OBJECT_LABEL_UNKNOWN_ANDROID = 0,
XR_OBJECT_LABEL_KEYBOARD_ANDROID = 1,
XR_OBJECT_LABEL_MOUSE_ANDROID = 2,
XR_OBJECT_LABEL_LAPTOP_ANDROID = 3,
XR_OBJECT_LABEL_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrObjectLabelANDROID;
ट्रैक किए जा सकने वाले ऑब्जेक्ट पाने के लिए कोड का उदाहरण
नीचे दिए गए उदाहरण में, ट्रैक किए जा सकने वाले ऑब्जेक्ट पाने का तरीका बताया गया है.
XrSession session; // previously initialized
// The function pointers are previously initialized using xrGetInstanceProcAddr.
PFN_xrCreateTrackableTrackerANDROID xrCreateTrackableTrackerANDROID; // previously initialized
PFN_xrGetAllTrackablesANDROID xrGetAllTrackablesANDROID; // previously initialized
PFN_xrGetTrackableObjectANDROID xrGetTrackableObjectANDROID; // previously initialized
PFN_xrDestroyTrackableTrackerANDROID xrDestroyTrackableTrackerANDROID; // previously initialized
XrTime updateTime; // Time used for the current frame's simulation update.
XrSpace appSpace; // Space created for XR_REFERENCE_SPACE_TYPE_LOCAL.
XrTrackableTrackerCreateInfoANDROID
createInfo{XR_TYPE_TRACKABLE_TRACKER_CREATE_INFO_ANDROID};
createInfo.trackableType = XR_TRACKABLE_TYPE_OBJECT_ANDROID;
XrTrackableTracker objectTrackableTracker;
XrResult result = xrCreateTrackableTrackerANDROID(
session,
&createInfo,
&objectrackableTracker);
if (result != XR_SUCCESS) { /* Handle failures. */ }
uint32_t trackableCountOutput = 0;
std::vector<XrTrackableANDROID> allObjectTrackables;
// Query the number of trackables available.
result = xrGetAllTrackablesANDROID(
objectTrackableTracker,
0,
&trackableCountOutput,
nullptr
);
if (result == XR_SUCCESS) {
allObjectTrackables.resize(trackableCountOutput, XR_NULL_TRACKABLE_ANDROID);
// Fetch the actual trackable handles in the appropriately resized array.
result = xrGetAllTrackablesANDROID(
objectTrackableTracker,
trackableCountOutput,
&trackableCountOutput,
allObjectTrackables.data());
if (result == XR_SUCCESS) {
for (XrTrackableANDROID trackable : allObjectTrackables) {
// Object trackable query information
XrTrackableGetInfoANDROID objectGetInfo;
objectGetInfo.type = XR_TYPE_TRACKABLE_GET_INFO_ANDROID;
objectGetInfo.next = nullptr;
objectGetInfo.trackable = trackable;
objectGetInfo.space = appSpace;
objectGetInfo.time = updateTime;
// Get the object trackable. Note that the tracker only returns object types.
XrTrackableObjectANDROID object = { XR_TYPE_TRACKABLE_OBJECT_ANDROID };
result = xrGetTrackableObjectANDROID(
objectTrackableTracker,
&objectGetInfo,
&object
);
if (result == XR_SUCCESS) {
/** Do Stuff with the object */
}
}
}
}
// Release trackable tracker.
result = xrDestroyTrackableTrackerANDROID(objectTrackableTracker);
नई Enum Constant
XrStructureType एनोटेशन को इनके साथ जोड़ा गया है:
XR_TYPE_TRACKABLE_OBJECT_ANDROID
XR_TYPE_TRACKABLE_OBJECT_CONFIGURATION_ANDROID
XrTrackableTypeANDROID एनोटेशन में ये वैल्यू जोड़ी गई हैं:
XR_TRACKABLE_TYPE_OBJECT_ANDROID
नए Enums
नए स्ट्रक्चर
नए फ़ंक्शन
समस्याएं
वर्शन का इतिहास
- पहला बदलाव, 03-10-2024 (कैनी वर्कमेयर)
- एक्सटेंशन का शुरुआती ब्यौरा.