تتوفّر حزمة تطوير البرامج (SDK) لنظام Android XR الآن في "معاينة المطوّر". يهمّنا معرفة ملاحظاتك. يُرجى الانتقال إلى
صفحة الدعم للتواصل معنا.
إضافة OpenXR XR_ANDROID_passthrough_camera_state
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
سلسلة الاسم
XR_ANDROID_passthrough_camera_state
نوع الإضافة
إضافة مثيل
رقم الإضافة المسجَّل
461
المراجعة
1
التبعيات المتعلّقة بالإصدارات والإضافات
OpenXR 1.0
تاريخ آخر تعديل
2024-09-05
المساهمون
سبنسر كوين، Google
جاريد فايندر، Google
كيفن مول، Google
نيهاف جاين، Google
نظرة عامة
قد يستغرق بدء تشغيل كاميرا "العرض المباشر" بعض الوقت، وقد لا تكون متاحة
على الفور. تتيح هذه الإضافة للتطبيقات معرفة الحالة الحالية لكاميرا
العرض المباشر.
الحصول على الحالة الحالية للكاميرا التي تتيح الرؤية من خلال
XrResult xrGetPassthroughCameraStateANDROID(
XrSession session,
const XrPassthroughCameraStateGetInfoANDROID* getInfo,
XrPassthroughCameraStateANDROID* cameraStateOutput);
أوصاف المَعلمات
session هو معرّف XrSession تم إنشاؤه سابقًا باستخدام xrCreateSession.getInfo هي أي معلومات ستؤثّر في كيفية تحديد حالة الكاميرا.cameraStateOutput هي الحالة الحالية للكاميرا.
يسترجع xrGetPassthroughCameraStateANDROID الحالة الحالية لكاميرا
العرض المباشر.
بنية XrPassthroughCameraStateGetInfoANDROID هي بنية input/output
تحدد مَعلمات طلب حالة الكاميرا.
typedef struct XrPassthroughCameraStateGetInfoANDROID {
XrStructureType type;
void* next;
} XrPassthroughCameraStateGetInfoANDROID;
أوصاف الأعضاء
type هو XrStructureType لهذه البنية.next هو NULL أو مؤشر إلى البنية التالية في سلسلة البنية.
يحدِّد التعداد XrPassthroughCameraStateANDROID الحالات المختلفة
التي يمكن أن تكون فيها الكاميرا المزوّدة بميزة "العرض المباشر".
typedef enum XrPassthroughCameraStateANDROID {
XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID = 0,
XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID = 1,
XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID = 2,
XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID = 3,
XR_PASSTHROUGH_CAMERA_STATE_MAX_ENUM_ANDROID = 0x7FFFFFFF
} XrPassthroughCameraStateANDROID;
تحمل قوائم القيم المحدَّدة المعاني التالية:
تعداد |
الوصف |
XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID
|
تم إيقاف الكاميرا من خلال تطبيق أو النظام أو المستخدم. |
XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID
|
لا تزال الكاميرا في مرحلة الربط بالإنترنت وليست جاهزة للاستخدام بعد. |
XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID
|
أصبحت الكاميرا جاهزة للاستخدام. |
XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID
|
الكاميرا في حالة خطأ يتعذّر إصلاحه. |
أنواع العناصر الجديدة
أنواع الإبلاغ الجديدة
ثوابت قائمة التعداد الجديدة
تمّت إضافة ما يلي إلى التعداد XrStructureType:
XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID
عمليات التعداد الجديدة
التصاميم الجديدة
الدوالّ الجديدة
المشاكل
سجلّ الإصدارات
- المراجعة 1، 05-09-2024 (سمير كمال)
- الإصدار الأولي
OpenXR™ وشعار OpenXR هما علامتان تجاريتان مملوكتان
لشركة The Khronos Group Inc. ومسجَّلتان كعلامتَين تجاريتَين في الصين
والاتحاد الأوروبي واليابان والمملكة المتحدة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# XR_ANDROID_passthrough_camera_state OpenXR extension\n\n**Name String**\n\n`XR_ANDROID_passthrough_camera_state`\n\n**Extension Type**\n\nInstance extension\n\n**Registered Extension Number**\n\n461\n\n**Revision**\n\n1\n\n**Extension and Version Dependencies**\n\n[OpenXR 1.0](https://registry.khronos.org/OpenXR/specs/1.0/html/xrspec.html#versions-1.0)\n\n**Last Modified Date**\n\n2024-09-05\n\n**Contributors**\n\nSpencer Quin, Google\n\nJared Finder, Google\n\nKevin Moule, Google\n\nNihav Jain, Google\n\nOverview\n--------\n\nThe passthrough camera can take time to start up and may not be immediately\navailable. This extension lets applications know the current state of the\npassthrough camera.\n\nGet the current passthrough camera state\n----------------------------------------\n\n XrResult xrGetPassthroughCameraStateANDROID(\n XrSession session,\n const XrPassthroughCameraStateGetInfoANDROID* getInfo,\n XrPassthroughCameraStateANDROID* cameraStateOutput);\n\n### Parameter Descriptions\n\n- `session` is an [XrSession](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#XrSession) handle previously created with [xrCreateSession](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#xrCreateSession).\n- `getInfo` is any info that will affect how camera state is determined.\n- `cameraStateOutput` is the current state of the camera.\n\n[xrGetPassthroughCameraStateANDROID](#xrGetPassthroughCameraStateANDROID) retrieves the current state of the\npassthrough camera.\n\nThe [XrPassthroughCameraStateGetInfoANDROID](#XrPassthroughCameraStateGetInfoANDROID) structure is an input/output\nstruct which specifies the camera state request\nparameters. \n\n typedef struct XrPassthroughCameraStateGetInfoANDROID {\n XrStructureType type;\n void* next;\n } XrPassthroughCameraStateGetInfoANDROID;\n\n### Member Descriptions\n\n- `type` is the [XrStructureType](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#XrStructureType) of this structure.\n- `next` is `NULL` or a pointer to the next structure in a structure chain.\n\nThe [XrPassthroughCameraStateANDROID](#XrPassthroughCameraStateANDROID) enumeration identifies different states\nwhich the passthrough camera can be in. \n\n typedef enum XrPassthroughCameraStateANDROID {\n XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID = 0,\n XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID = 1,\n XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID = 2,\n XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID = 3,\n XR_PASSTHROUGH_CAMERA_STATE_MAX_ENUM_ANDROID = 0x7FFFFFFF\n } XrPassthroughCameraStateANDROID;\n\nThe enums have the following meanings:\n\n| Enum | Description |\n|----------------------------------------------------|-----------------------------------------------------------------|\n| `XR_PASSTHROUGH_CAMERA_STATE_DISABLED_ANDROID` | The camera has been disabled by an app, the system or the user. |\n| `XR_PASSTHROUGH_CAMERA_STATE_INITIALIZING_ANDROID` | The camera is still coming online and not yet ready to use. |\n| `XR_PASSTHROUGH_CAMERA_STATE_READY_ANDROID` | The camera is ready to use. |\n| `XR_PASSTHROUGH_CAMERA_STATE_ERROR_ANDROID` | The camera is in an unrecoverable error state. |\n\n**New Object Types**\n\n**New Flag Types**\n\n**New Enum Constants**\n\n[XrStructureType](https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#XrStructureType) enumeration is extended with:\n\n- `XR_TYPE_PASSTHROUGH_CAMERA_STATE_GET_INFO_ANDROID`\n\n**New Enums**\n\n- [XrPassthroughCameraStateANDROID](#XrPassthroughCameraStateANDROID)\n\n**New Structures**\n\n- [XrPassthroughCameraStateGetInfoANDROID](#XrPassthroughCameraStateGetInfoANDROID)\n\n**New Functions**\n\n- [xrGetPassthroughCameraStateANDROID](#xrGetPassthroughCameraStateANDROID)\n\n**Issues**\n\n**Version History**\n\n- Revision 1, 2024-09-05 (Spencer Quin)\n- Initial version.\n\n*** ** * ** ***\n\nOpenXR™ and the OpenXR logo are trademarks owned\nby The Khronos Group Inc. and are registered as a trademark in China,\nthe European Union, Japan and the United Kingdom."]]
