|
|
@@ -0,0 +1,165 @@
|
|
|
+<!DOCTYPE html>
|
|
|
+<html lang="ar">
|
|
|
+ <head>
|
|
|
+ <meta charset="utf-8" />
|
|
|
+ <base href="../../../../" />
|
|
|
+ <script src="page.js"></script>
|
|
|
+ <link type="text/css" rel="stylesheet" href="page.css" />
|
|
|
+ </head>
|
|
|
+ <body class="rtl">
|
|
|
+ <h1>[name]</h1>
|
|
|
+
|
|
|
+ <p class="desc">
|
|
|
+ تمثل هذه الفئة تجريدًا لواجهة برمجة تطبيقات WebXR Device وتستخدم
|
|
|
+ داخليًا بواسطة [page:WebGLRenderer]. [name] يوفر أيضًا واجهة عامة
|
|
|
+ الذي يسمح للمستخدمين بتمكين / تعطيل XR وتنفيذ مهام ذات صلة بـ XR
|
|
|
+ مثل استرداد التحكُّمات على سبيل المثال.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h2>الخصائص (Properties)</h2>
|
|
|
+
|
|
|
+ <h3>[property:Boolean cameraAutoUpdate]</h3>
|
|
|
+ <p>
|
|
|
+ ما إذا كان يجب تحديث كاميرا XR الخاصة بالمدير تلقائيًا أم لا.
|
|
|
+ الافتراضي هو `true`.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[property:Boolean enabled]</h3>
|
|
|
+ <p>
|
|
|
+ هذا العلم يخطر المقدم بأن يكون جاهزًا للتصوير XR. الافتراضي هو
|
|
|
+ `false`. قم بتعيينه على `true` إذا كنت ستستخدم XR في تطبيقك.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[property:Boolean isPresenting]</h3>
|
|
|
+ <p>
|
|
|
+ ما إذا كان التقديم XR نشطًا أم لا. الافتراضي هو `false`. هذا العلم هو
|
|
|
+ للقراءة فقط وتعيينه تلقائيًا بواسطة [name].
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h2>الطرق (Methods)</h2>
|
|
|
+
|
|
|
+ <h3>[method:ArrayCamera getCamera]()</h3>
|
|
|
+ <p>
|
|
|
+ يرجع نسخة من [page:ArrayCamera] التي تمثل كاميرا XR
|
|
|
+ لجلسة XR النشطة. لكل عرض يحتفظ بكائن كاميرا منفصل
|
|
|
+ في خصائص [page:ArrayCamera.cameras cameras].
|
|
|
+ </p>
|
|
|
+ <p>
|
|
|
+ حاليًا لا يتم استخدام `fov` الكاميرا ولا يعكس fov من
|
|
|
+ كاميرا XR. إذا كنت بحاجة إلى fov على مستوى التطبيق ، فعليك حسابه
|
|
|
+ بشكل يدوي من مصفوفات الإسقاط الخاصة بكاميرا XR.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:Group getController]( [param:Integer index] )</h3>
|
|
|
+ <p>
|
|
|
+ [page:Integer index] — فهرس المتحكم. <br /><br />
|
|
|
+
|
|
|
+ يعود بـ [page:Group] يمثل ما يسمى بمساحة *الشعاع المستهدف* من
|
|
|
+ المتحكم XR. استخدم هذه المساحة لتصور الكائنات ثلاثية الأبعاد التي تدعم
|
|
|
+ المستخدم في مهام الإشارة مثل التفاعل مع واجهة المستخدم.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:Group getControllerGrip]( [param:Integer index] )</h3>
|
|
|
+ <p>
|
|
|
+ [page:Integer index] — فهرس المتحكم. <br /><br />
|
|
|
+
|
|
|
+ يعود بـ [page:Group] يمثل ما يسمى بمساحة `القبضة` من المتحكم XR
|
|
|
+ . استخدم هذه المساحة إذا كان المستخدم سيحمل كائنات ثلاثية الأبعاد أخرى
|
|
|
+ مثل سيف الضوء.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <p>
|
|
|
+ ملاحظة: إذا كنت ترغب في إظهار شيء في يد المستخدم وتقديم
|
|
|
+ شعاع الإشارة في نفس الوقت ، فسترغب في إرفاق الكائن المحمول باليد
|
|
|
+ إلى المجموعة التي يتم إرجاعها بواسطة [page:.getControllerGrip]() والشعاع إلى
|
|
|
+ المجموعة التي يتم إرجاعها بواسطة [page:.getController](). الفكرة هي أن يكون لديك اثنان
|
|
|
+ مجموعات مختلفة في مسافتين إحداثيتين مختلفتين لنفس WebXR
|
|
|
+ التحكم.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:Float getFoveation]()</h3>
|
|
|
+ <p>
|
|
|
+ يعود بكمية الفوفيشن المستخدمة من قبل ملحق XR لـ
|
|
|
+ طبقة الإسقاط.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:Group getHand]( [param:Integer index] )</h3>
|
|
|
+ <p>
|
|
|
+ [page:Integer index] — فهرس المتحكم. <br /><br />
|
|
|
+
|
|
|
+ يعود بـ [page:Group] يمثل ما يسمى بـ `hand` أو `joint` space
|
|
|
+ التحكم XR. استخدام هذه المساحة لتصور أيدي المستخدم عند عدم استخدام
|
|
|
+ التحكُّمات الفعلية.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:String getReferenceSpace]()</h3>
|
|
|
+ <p>يرجع المسافة المرجعية.</p>
|
|
|
+
|
|
|
+ <h3>[method:XRSession getSession]()</h3>
|
|
|
+ <p>
|
|
|
+ يرجع كائن `XRSession` الذي يسمح بإدارة أكثر دقة
|
|
|
+ لجلسات WebXR النشطة على مستوى التطبيق.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:undefined setFoveation]( [param:Float foveation] )</h3>
|
|
|
+ <p>
|
|
|
+ [page:Float foveation] — الفوفيشن المراد تعيينه. <br /><br />
|
|
|
+
|
|
|
+ يحدد مقدار الفوفيشن المستخدم من قبل ملحق XR للطبقة.
|
|
|
+ يجب أن يكون قيمة بين `0` و `1`.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:undefined setFramebufferScaleFactor]( [param:Float framebufferScaleFactor] )</h3>
|
|
|
+ <p>
|
|
|
+ [page:Float framebufferScaleFactor] — عامل مقياس الإطار المراد تعيينه. <br /><br />
|
|
|
+
|
|
|
+ يحدد عامل التحجيم المستخدم عند تحديد حجم الإطار عند التصوير إلى جهاز XR. القيمة نسبية إلى
|
|
|
+ دقة عرض جهاز XR الافتراضية. الافتراضي هو `1`. قيمة `0.5`
|
|
|
+ تحدد إطارًا بنسبة 50٪ من دقة العرض الأصلية.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <p>
|
|
|
+ ملاحظة: لا يمكن تغيير عامل مقياس الإطار أثناء
|
|
|
+ تقديم محتوى XR.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:undefined setReferenceSpace]( [param:XRReferenceSpace referenceSpace] )</h3>
|
|
|
+ <p>
|
|
|
+ [page:XRReferenceSpace referenceSpace] — مساحة مرجعية مخصصة. <br /><br />
|
|
|
+
|
|
|
+ يمكن استخدامه لتكوين مساحة مرجعية مخصصة تستبدل
|
|
|
+ المساحة المرجعية الافتراضية.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:undefined setReferenceSpaceType]( [param:String referenceSpaceType] )</h3>
|
|
|
+ <p>
|
|
|
+ [page:String referenceSpaceType] — نوع المساحة المرجعية المراد تعيينه. <br /><br />
|
|
|
+
|
|
|
+ يمكن استخدامه لتكوين علاقة فضائية مع
|
|
|
+ بيئة المستخدم الفعلية. اعتمادًا على كيفية حركة المستخدم في الفضاء ثلاثي الأبعاد ، يمكن أن يؤدي تعيين
|
|
|
+ مساحة مرجعية مناسبة إلى تحسين التتبع. الافتراضي هو
|
|
|
+ `local-floor`. يرجى التحقق من
|
|
|
+ [link:https://developer.mozilla.org/en-US/docs/Web/API/XRReferenceSpaceType MDN]
|
|
|
+ للحصول على قائمة بالقيم الممكنة وحالات استخدامها.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h3>[method:undefined updateCamera]( [param:PerspectiveCamera camera] )</h3>
|
|
|
+ <p>
|
|
|
+ تحديث حالة كاميرا XR. استخدم هذه الطريقة على مستوى التطبيق إذا
|
|
|
+ ضبط [page:.cameraAutoUpdate] إلى `false`. تتطلب الطريقة كاميرا غير XR
|
|
|
+ المشهد كمعلم. يتم ضبط تحولات الكاميرا التي تم تمريرها تلقائيًا إلى موضع كاميرا XR عند استدعاء
|
|
|
+ هذه الطريقة.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <p>
|
|
|
+ ملاحظة: لا يمكن تغيير نوع المساحة المرجعية أثناء
|
|
|
+ تقديم محتوى XR.
|
|
|
+ </p>
|
|
|
+
|
|
|
+ <h2>المصدر (Source)</h2>
|
|
|
+
|
|
|
+ <p>
|
|
|
+ [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
|
|
|
+ </p>
|
|
|
+ </body>
|
|
|
+</html>
|
Omar Khalifa