العقدة

فئة عامة العقدة

الفئات الفرعية المباشرة المعروفة AnchorNode وAenhancedFaceNode وBaseTransformableNode والكاميرا وSkeletonNode وSun AnchorNode عقدة يتم وضعها تلقائيًا في مساحة العالم استنادًا إلى علامة ارتساء ARCore.  AEnhancedFaceNode العُقدة المستخدمة لعرض التأثيرات البصرية على وجه من خلال ميزة AugmentedFace ARCore's.  BaseTransformableNode الفئة الأساسية للعُقد التي يمكن تحويلها باستخدام الإيماءات من TransformationSystem.  باستخدام الكاميرا ويمثّل كاميرا افتراضية تحدّد المنظر الذي يتم من خلاله عرض المشهد.  إطار هيكلي Node يقدم عمليات الربط بين عظام ModelRenderable الجلدية ومجموعة من Nodes.  الأحد تُمثّل هذه المعلّمة "s;"; - ضوء الاتجاه التلقائي في المشهد.

الفئات الفرعية غير المباشرة المعروفة TransformableNode TransformableNode عقدة يمكن اختيارها وترجمتها وتدويرها باستخدام الإيماءات من TransformationSystem.

تمثل العقدة تحويلاً داخل الرسم البياني للمشهد. ويمكن أن يتضمّن مكوّنًا قابلاً للعرض في محرّك العرض.

يمكن أن تحتوي كل عقدة على عدد عشوائي من العُقد الفرعية وعنصر رئيسي واحد. قد يكون العنصر الرئيسي عقدة أخرى، أو المشهد.

الصفوف المتداخلة

محسّنة	Node.LifecycleListener		تعريف الواجهة لاستدعاءات استدعاءات عند استدعاء أحداث دورة حياة العقدة.
محسّنة	Node.OnTapListener		تعريف الواجهة لاستدعاء معاودة الاتصال عند النقر على عُقدة.
محسّنة	Node.OnTouchListener		تعريف الواجهة لاستدعاء استدعاء عندما يتم إرسال حدث اللمس إلى هذه العقدة.
محسّنة	Node.ConversionChangedListener		تعريف الواجهة لاستدعاءات استدعاءات عندما يتم تغيير تحويل العقدة.

الأشغال العامة

Node() تنشئ عقدة بدون عنصر رئيسي.

الأساليب العامة

باطلة	addLifecycleListener(Node.LifecycleListener LifecycleListener) لإضافة مستمع سيتم استدعاءه عند وقوع أحداث مراحل العقدة.
باطلة	addTransformChangedListener(Node.TransformChangedListener TransformChangedListener) لإضافة مستمع سيتم استدعاءه عند تغيير تحويل العقدة.
باطلة	callOnHierarchy(consumer<Node>consumer) اجتياز التسلسل الهرمي واستدعاء طريقة في كل عُقدة (بما في ذلك هذه العقدة).
العقدة	findInHierarchy(Predicate<Node>condition) اجتياز التسلسل الهرمي للعثور على العقدة الأولى (بما في ذلك هذه العقدة) التي تستوفي شرطًا.
النهائي Vector3	get Back() يحصل على متّجه للخلف للخلف (zz) لهذه العقدة.
Collisionالشكل	getCollisionالشكل() يحصل على الشكل لاستخدامه للتصادمات مع هذه العقدة.
النهائي Vector3	getdown() للحصول على متّجه المسافة العالمي (-y) لهذه العقدة.
النهائي Vector3	getForward() للحصول على متّجه للأمام حول العالم (-z) لهذه العقدة.
النهائي Vector3	getleft() للحصول على المتّجه لليسار في الشبكة العالمية (-x) لهذه العقدة.
فاتح	getLight() يحصل على الإضاءة الحالية، وهي متغيّرة.
النهائي Vector3	getLocalPosition() الحصول على نسخة من موضع العُقد مقارنةً بالعنصر الرئيسي (المساحة المحلية).
النتيجة النهائية رُبع	getLocalRotation() يحصل على نسخة من تدوير العُقد مقارنةً بالشاشة الرئيسية (مساحة محلية).
النهائي Vector3	getLocalScale() يحصل على نسخة من مقياس العُقد مقارنةً بالعنصر الرئيسي (المساحة المحلية).
السلسلة النهائية	getName() لعرض اسم العُقدة.
العقدة النهائية	getParent() لعرض العنصر الرئيسي لهذه العقدة.
قابلة للعرض	getRenderable() الحصول على العرض القابل للعرض لهذه العقدة.
النهائي Vector3	getright() يحصل على المتّجه الأيمن لليمين (+x) لهذه العقدة.
المشهد النهائي	getScene() لعرض المشهد الذي تشكّل هذه العقدة جزءًا منه، وتكون القيمة فارغة إذا كانت جزءًا من أي مشهد.
النهائي Vector3	getUp() للحصول على متّجه لأعلى عالمي (+y) لهذه العقدة.
النهائي Vector3	getWorldPosition() الحصول على نسخة من موضع العالَم في الفضاء العالمي.
النتيجة النهائية رُبع	getWorldRotation() تعرض هذه السياسة نسخة من دوران المساحات العالمية في العُقد.
النهائي Vector3	getWorldScale() للحصول على نسخة من مقياس مساحة العالم للعُقد.
قيمة منطقية	isActive() عرض "صحيح" إذا كانت العقدة نشطة.
قيمة منطقية	isDescendantOf(أحد أصل NodeParent) تتحقق مما إذا كانت الوحدة الرئيسية الرئيسية المحددة هي أصل هذه العقدة بشكل متكرر.
قيمة منطقية	isEnabled() يحصل على الحالة المفعَّلة لهذه العقدة.
منطقي	isTopLevel() عرض "صحيح" إذا كانت هذه العقدة في المستوى الأعلى
النهائي Vector3	localToWorldDirection(الاتجاه Vector3) لتحويل اتجاه من المساحة المحلية لهذه العقدة إلى مساحة العالم.
النهائي Vector3	localToWorldPoint(نقطة Vector3) لتحويل نقطة في المساحة المحلية لهذه العقدة إلى مساحة عالمية.
باطلة	onActivate() التعامل مع حالة هذه العقدة عندما تصبح نشطة.
باطلة	onDisable() التعامل مع حالة هذه العقدة غير نشطة.
منطقي	onTouchEvent(HitTestالنتيجة HitTest وMotionEvent actionEvent) التعامل مع هذه العقدة عند لمس هذه العقدة.
باطلة	onTransformChange(NodeoriginatingNode) التعامل مع هذه التغييرات عند تغيير تحويل هذه العقدة.
باطلة	onUpdate(TimeTime FrameTime) التعامل مع هذه العقدة عند تعديل هذه العقدة.
باطلة	removeLifecycleListener(Node.LifecycleListener LifecycleListener) تتم إزالة المستمع الذي سيتم طلبه عند وقوع أحداث مراحل العقدة.
باطلة	removeTransformChangedListener(Node.TransformChangedListener TransformChangedListener) تتم إزالة المستمع الذي سيتم طلبه عند تغيير تحويل العقدة.
باطلة	setCollisionFormat(Collisionأشكال التصادم) لضبط الشكل الذي يتم استخدامه لاكتشاف أي تعارضات في Node.
إلغاء	setEnabled (مفعَّل منطقي) تتيح هذه السياسة ضبط الحالة المفعّلة لهذه العقدة.
باطلة	setLight(فاتح فاتحة) لضبط Light على العرض.
باطلة	setLocalPosition(موضع Vector3) يحدّد موضع هذه العقدة مقارنةً بالعنصر الرئيسي (المساحة المحلية).
باطلة	setLocalRotation(تناوب العرض) يحدّد دوران هذه العقدة مقارنةً بالعنصر الرئيسي (المساحة المحلية).
باطلة	setLocalScale(مقياس Vector3) لضبط حجم هذه العقدة بالنسبة إلى العنصر الرئيسي (المساحة المحلية).
إلغاء	setLookDirection(الاتجاه 3 من اتجاه الاتجاه) يحدِّد الاتجاه الذي تنظر إليه العُقدة في الفضاء العالمي.
إلغاء	setLookDirection(الاتجاه نحو Vector3، اتجاه اتجاه Vector3) يحدِّد الاتجاه الذي تنظر إليه العُقدة في الفضاء العالمي.
إلغاء	setName(اسم سلسلة) إعداد اسم هذه العقدة.
باطلة	setOnTapListener(Node.OnTapListener onTapListener) تسجِّل استدعاءً لاستدعاءه عند النقر على هذه العقدة.
باطلة	setOnTouchListener(Node.OnTouchListener onTouchListener) تسجِّل معاودة اتصال ليتم استدعاؤها عند إرسال حدث اللمس إلى هذه العقدة.
باطلة	setParent(العنصر الرئيسي NodeParent) يؤدي إلى تغيير العقدة الرئيسية لهذه العقدة.
باطلة	setRenderable(قابلة للعرض قابلة للعرض) تعمل على ضبط السمة Renderable لعرضها على هذه العقدة.
باطلة	setWorldPosition(موضع Vector3) إعداد موضع الفضاء العالمي لهذه العقدة.
باطلة	setWorldRotation(دوران رباعي) إعداد دوران العقدة العالمية للمساحة في هذه العقدة.
باطلة	setWorldScale(مقياس Vector3) لتحديد مقياس المسافة العالمية لهذه العقدة.
سلسلة	toString()
النهائي Vector3	worldToLocalDirection(الاتجاه Vector3) لتحويل اتجاه من الفضاء العالمي إلى المساحة المحلية لهذه العقدة.
النهائي Vector3	worldToLocalPoint(نقطة Vector3) لتحويل نقطة في الفضاء العالمي إلى المساحة المحلية لهذه العقدة.

الطرق المحمية

قيمة منطقية	canAddChild(Node children, StringBuilder failed reason)
إلغاء	onAddChild(عنصر عقدة)
إلغاء	onRemoveChild(عنصر فرعي للعقدة)

الطرق المكتسَبة

من الصف com.google.ar.sceneform.NodeParent

إلغاء	addChild(الفرع العُقدة) إضافة عُقدة كعنصر ثانوي لهذه العقدة الأساسية.
باطلة	callOnHierarchy(consumer<Node>consumer) اجتياز التسلسل الهرمي واستدعاء طريقة في كل عُقدة.
منطقي	canAddChild(Node children, StringBuilder failed reason)
العقدة	findByName(اسم السلسلة) عليك اجتياز العرض الهرمي للعثور على العُقدة الأولى باسم معيّن.
العقدة	findInHierarchy(Predicate<Node>condition) عليك اجتياز العرض الهرمي للعثور على العُقدة الأولى التي تستوفي شرطًا.
Final List<Node>	getChild() عرض قائمة غير قابلة للتغيير لهذا العنصر الرئيسي.
باطلة	onAddChild(عنصر عقدة)
باطلة	onRemoveChild(عنصر فرعي للعقدة)
إلغاء	removeChild(الفرع العُقدة) إزالة عُقدة من العناصر الثانوية لهذه العقدة الأصلية.

من الفئة java.lang.Object

الكائن	clone()
منطقي	يساوي(Object arg0)
باطلة	Finishize()
نهائي Class<?>	getClass()
int	hashCode()
إلغاء	Notify()
إلغاء	NotifyAll()
سلسلة	toString()
إلغاء	لمدة الانتظار(long arg0, int arg1)
إلغاء	[ مستخدم] (وسيطة طويلة)
إلغاء	Pending()

الأشغال العامة

Public Node ()

تنشئ عقدة بدون عنصر رئيسي.

الأساليب العامة

Public Empty addLifecycleListener (Node.LifecycleListener LifecycleListener)

لإضافة مستمع سيتم استدعاءه عند وقوع أحداث مراحل العقدة. وسيتم استدعاء المستمعين حسب ترتيب إضافتهم.

المَعلمات

أداة معالجة مراحل النشاط

Public Empty addTransformChangedListener (Node.TransformChangedListener TransformChangedListener)

لإضافة مستمع سيتم استدعاءه عند تغيير تحويل العقدة.

المَعلمات

TransformChangedListener

Public Empty callOnHierarchy (consumer<Node> Consumer)

اجتياز التسلسل الهرمي واستدعاء طريقة في كل عُقدة (بما في ذلك هذه العقدة). الاجتياز هو العمق أولاً.

المَعلمات

مستهلك	طريقة الاستدعاء في كل عُقدة

Public Node findInHierarchy (Predicate<Node>condition)

اجتياز التسلسل الهرمي للعثور على العقدة الأولى (بما في ذلك هذه العقدة) التي تستوفي شرطًا. بعد استيفاء predicate، يتوقف الاجتياز. الاجتياز أولاً.

المَعلمات

الشرط	تحدّد شروط العقدة للبحث عنها.

المرتجعات

• العقدة الأولى التي تطابق شروط افتراض، بخلاف ذلك يتم عرض قيمة فارغة

علني نهائي Vector3 getback ()

يحصل على متّجه للخلف للخلف (zz) لهذه العقدة.

المرتجعات

• متّجه جديد يمثّل اتجاه العُقدة في الفضاء

Public Collisionالشكل getCollisionالشكل ()

يحصل على الشكل لاستخدامه للتصادمات مع هذه العقدة. إذا كان الشكل فارغًا وتم ضبط setRenderable(Renderable)، يتم استخدام getCollisionShape() لرصد التصادمات لهذا Node.

المرتجعات

• يمثل شكلاً هندسيًا، مثل كرة أرضية ومربّع ومقلّم.

راجع أيضًا

• hitTest(Ray)
• hitTestAll(Ray)
• overlapTest(Node)
• overlapTestAll(Node)

علني نهائي Vector3 getdown ()

للحصول على متّجه المسافة العالمي (-y) لهذه العقدة.

المرتجعات

• متّجه جديد يمثّل اتجاه العُقدة للأسفل في الفضاء العالمي

علني نهائي Vector3 getForward ()

للحصول على متّجه للأمام حول العالم (-z) لهذه العقدة.

المرتجعات

• متّجه جديد يمثّل اتجاه العقدة للأمام في الفضاء العالمي

علني نهائي Vector3 getيسار ()

للحصول على المتّجه لليسار في الشبكة العالمية (-x) لهذه العقدة.

المرتجعات

• متّجه جديد يمثّل الاتجاه الأيسر للعقدة في الفضاء العالمي

علنية فاتحة getLight ()

يحصل على الإضاءة الحالية، وهي متغيّرة.

عامة نهائية Vector3 getLocalPosition ()

الحصول على نسخة من موضع العُقد مقارنةً بالعنصر الرئيسي (المساحة المحلية). إذا كانت السياسة isTopLevel() صحيحة، تتطابق هذه القاعدة مع getWorldPosition().

المرتجعات

• متّجه جديد يمثّل موضع المساحة المحلية للعقدة

راجع أيضًا

• setLocalPosition(Vector3)

Public Final Quaternion getLocalRotation ()

يحصل على نسخة من تدوير العُقد مقارنةً بالشاشة الرئيسية (مساحة محلية). إذا كانت السياسة isTopLevel() صحيحة، تتطابق هذه القاعدة مع getWorldRotation().

المرتجعات

• قسم جديد يمثّل دوران مساحة العمل المحلية في العقدة

راجع أيضًا

• setLocalRotation(Quaternion)

علني نهائي Vector3 getLocalScale ()

يحصل على نسخة من مقياس العُقد مقارنةً بالعنصر الرئيسي (المساحة المحلية). إذا كانت السياسة isTopLevel() صحيحة، تكون قيمة السمة هي getWorldScale() نفسها.

المرتجعات

• متّجه جديد يمثّل مقياس المسافة المحلية على العقدة

راجع أيضًا

• setLocalScale(Vector3)

علنية نهائية سلسلة getName ()

لعرض اسم العُقدة. القيمة التلقائية هي "Node;Node".

علني نهائي عقدة getParent ()

لعرض العنصر الرئيسي لهذه العقدة. إذا كانت هذه Node تحتوي على عنصر رئيسي، وكان ذلك العنصر الرئيسي فئة فرعية Node أو Node، ستعرض هذه الدالة العنصر الرئيسي على أنها Node. لعرض قيمة فارغة إذا كان العنصر الرئيسي Scene، استخدِم getScene() لاسترداد العنصر الرئيسي بدلاً من ذلك.

المرتجعات

• العنصر الرئيسي باعتباره Node، إذا كان العنصر الرئيسي Node.

Public Renderable getRenderable ()

الحصول على العرض القابل للعرض لهذه العقدة.

المرتجعات

• يمكن عرضه لهذه العقدة

علني نهائي Vector3 getright ()

يحصل على المتّجه الأيمن لليمين (+x) لهذه العقدة.

المرتجعات

• متّجه جديد يمثّل الاتجاه الصحيح للعقدة في الفضاء العالمي

علني نهائي Scene getScene ()

لعرض المشهد الذي تشكّل هذه العقدة جزءًا منه، وتكون القيمة فارغة إذا كانت جزءًا من أي مشهد. تكون العُقدة جزءًا من مشهد إذا كان الأصل السابق في المستوى Scene

علني نهائي Vector3 getUp ()

للحصول على متّجه لأعلى عالمي (+y) لهذه العقدة.

المرتجعات

• متّجه جديد يمثّل اتجاه العُقدة في الفضاء العالمي

علني نهائي Vector3 getWorldPosition ()

الحصول على نسخة من موضع العالَم في الفضاء العالمي.

المرتجعات

• متّجه جديد يمثّل موضع الفضاء على العُقدة

راجع أيضًا

• setWorldPosition(Vector3)

Public Final Quaternion getWorldRotation ()

تعرض هذه السياسة نسخة من دوران المساحات العالمية في العُقد.

المرتجعات

• قسم جديد يمثل العُقدة في الفضاء على مستوى العالم

راجع أيضًا

• setWorldRotation(Quaternion)

علني نهائي Vector3 getWorldScale ()

للحصول على نسخة من مقياس مساحة العالم للعُقد. سيتم فقدان بعض الدقة في حال انحراف العقدة.

المرتجعات

• متّجه جديد يمثّل مقياس الفضاء العالمي

راجع أيضًا

• setWorldScale(Vector3)

علنية نهائية منطقية isActive ()

عرض "صحيح" إذا كانت العقدة نشطة. تُعد العُقدة نشطة إذا استوفت جميع الشروط التالية:

• العقدة جزء من مشهد.
• العنصر الرئيسي للعقدة&#39؛ نشط.
• تم تفعيل العقدة.

تشتمل العقدة النشطة على السلوك التالي:

• سيتم استدعاء دالة onUpdate(FrameTime) للعقدة# كل إطار.
• سيتم عرض العُقدة getRenderable().
• سيتم التحقق من العقدة getCollisionShape() في الاستدعاءات لـ Scene.hitTest.
• سيتم استدعاء دالة onTouchEvent(HitTestResult, MotionEvent) للعقدة عند لمس العقدة.

المرتجعات

• الحالة النشطة للعقدة

راجع أيضًا

• onActivate()
• onDeactivate()

Public Final boolean isDescendantOf (NodeParent الأسف)

تتحقق مما إذا كانت الوحدة الرئيسية الرئيسية المحددة هي أصل هذه العقدة بشكل متكرر.

المَعلمات

كيان أصل	العنصر الرئيسي للعقدة المطلوب التحقق منه

المرتجعات

• صحيح إذا كانت العُقدة هي أصل هذه العقدة

علنية نهائية منطقية isEnabled ()

يحصل على الحالة المفعَّلة لهذه العقدة. تجدر الإشارة إلى أن العقدة قد تكون مفعّلة ولكنها لا تزال غير نشطة إذا لم تكن جزءًا من المشهد أو إذا كانت العنصر الرئيسي غير نشط.

المرتجعات

• حالة العُقدة مفعّلة.

راجع أيضًا

• isActive()

Public boolean isTopLevel ()

عرض "صحيح" إذا كانت هذه العقدة في المستوى الأعلى يتم اعتبار العُقدة في المستوى الأعلى إذا لم تتضمّن أي عنصر رئيسي أو إذا كانت العقدة الرئيسية هي المشهد.

المرتجعات

• صحيح إذا كانت العقدة في المستوى الأعلى

علني نهائي Vector3 localToWorldDirection (الاتجاه Vector3)

لتحويل اتجاه من المساحة المحلية لهذه العقدة إلى مساحة العالم. لا تتأثر بموضع العقدة أو نطاقها.

المَعلمات

direction	الاتجاه في المساحة المحلية لإجراء إحالة ناجحة

المرتجعات

• متّجه جديد يمثّل الاتجاه في الفضاء العالمي

علني نهائي Vector3 localToWorldPoint (نقطة Vector3)

لتحويل نقطة في المساحة المحلية لهذه العقدة إلى مساحة عالمية.

المَعلمات

نقطة واحدة	النقطة في المساحة المحلية لإجراء الإحالة الناجحة

المرتجعات

• متّجه جديد يمثّل النقطة في الفضاء العالمي

Public Empty onActivate ()

التعامل مع حالة هذه العقدة عندما تصبح نشطة. تكون العُقدة نشطة إذا كانت مفعّلة، وتشكّل جزءًا من مشهد، وكانت المجموعة الرئيسية نشطة.

يمكنك إجراء إلغاء لتنفيذ أي إعداد يجب حدوثه عند تفعيل العُقدة.

راجع أيضًا

• isActive()
• isEnabled()

Public Empty onDisable ()

التعامل مع حالة هذه العقدة غير نشطة. تكون العُقدة غير نشطة إذا كانت غير مفعَّلة، أو ليست جزءًا من مشهد أو إذا كانت الصفحة الرئيسية غير نشطة.

ويمكنك إلغاء هذه العملية لتنفيذ أي إعداد يجب تنفيذه عند إيقاف العُقدة.

راجع أيضًا

• isActive()
• isEnabled()

Public boolean onTouchEvent (HitTestResult HitTestResult, MotionEvent actionEvent)

التعامل مع هذه العقدة عند لمس هذه العقدة.

ويمكنك إجراء أي منطق يجب أن يحدث عند لمس هذه العقدة. إنّ طريقة نشر أحداث اللمس تعكس الطريقة التي يتم بها نشر اللمسات في الملفات الشخصية على Android. ويُسمى هذا الإجراء فقط عندما تكون العقدة نشطة.

عند وقوع الحدث ACTION_DOWN، يمثل بداية إيماءة. تمثيل ACTION_UP أو ACTION_CANCEL عند انتهاء إيماءة. عند بدء إيماءة، يتم تنفيذ ما يلي:

• عليك إرسال أحداث اللمس إلى العُقدة التي تم لمسها كما تم رصدها من قِبل hitTest(MotionEvent).
• إذا كانت العقدة لا تستخدم الحدث، تكرِّر مرة أخرى من خلال العنصر الرئيسي للعقدة وترسل حدث اللمس إلى أن تستهلك إحدى العُقدة الحدث.
• إذا لم تستهلك أي عُقدة الحدث، سيتم تجاهل الإيماءة ولن يتم تمرير الأحداث اللاحقة التي تكون جزءًا من الإيماءة إلى أي عُقد.
• إذا استهلكت إحدى العُقدة الحدث، ستستهلك هذه العقدة جميع أحداث اللمس المستقبلية للإيماءة.

عند إرسال حدث باللمس إلى عُقدة، يتم تمرير الحدث أولاً إلى العُقدة Node.OnTouchListener. إذا لم يعالج Node.OnTouchListener الفعالية، سيتم تمريرها إلى onTouchEvent(HitTestResult, MotionEvent).

المَعلمات

النتيجة الاختبارية	وتمثل العُقدة التي تم لمسها ومعلومات حول المكان الذي تم لمسها. في الأحداث ACTION_DOWN، سيكون getNode() دائمًا هذه العُقدة أو إحدى العناصر الثانوية لها. وفي أحداث أخرى، من المحتمل أن يكون اللمس قد انتقل إلى تغيير getNode() (أو ربما يكون القيمة فارغة).
actionEvent	حدث الحركة.

المرتجعات

• صحيح إذا تم التعامل مع الحدث، خطأ في حالة أخرى.

Public Empty onConversionChange (NodeoriginatingNode)

التعامل مع هذه التغييرات عند تغيير تحويل هذه العقدة.

العقدة الأصلية هي العُقدة ذات المستوى الأعلى في التسلسل الهرمي التي أدت إلى تغيير هذه العقدة. وستكون هذه السمة دائمًا هي العقدة نفسها أو إحدى نقاط التعريف الخاصة بها، أي أنه في حال تغيير موضع العُقدة A&39، سيؤدي ذلك إلى تشغيل onTransformChange(Node) في جميع العناصر الثانوية التابعة لها.

المَعلمات

origin محتوى العقدة	العقدة التي أدت إلى تغيير هذه العقدة

علنية باطلة onUpdate (TimeTime FrameTime)

التعامل مع هذه العقدة عند تعديل هذه العقدة. يتم تعديل عُقدة قبل عرض كل إطار. ويُسمى هذا الإجراء فقط عندما تكون العقدة نشطة.

ويمكنك إلغاء إجراء أي تعديلات يجب أن تحدث في كل إطار.

المَعلمات

وقت عرض اللقطة	يوفّر معلومات حول الإطار الحالي

Public Empty removeLifecycleListener (Node.LifecycleListener LifecycleListener)

تتم إزالة المستمع الذي سيتم طلبه عند وقوع أحداث مراحل العقدة.

المَعلمات

أداة معالجة مراحل النشاط

Public Empty removeTransformChangedListener (Node.TransformChangedListener TransformChangedListener)

تتم إزالة المستمع الذي سيتم طلبه عند تغيير تحويل العقدة.

المَعلمات

TransformChangedListener

لضبط الشكل الذي يتم استخدامه لاكتشاف أي تعارضات في Node. إذا لم يتم ضبط الشكل وتم ضبط setRenderable(Renderable)، يتم استخدام getCollisionShape() لرصد الأعطال على Node.

المَعلمات

شكل التصادم	يمثل شكلاً هندسيًا، مثل كرة أرضية ومربّع ومقلّم. إذا كانت فارغة، ستتم إزالة شكل التصادم الحالي لهذه العقدة.

راجع أيضًا

• hitTest(Ray)
• hitTestAll(Ray)
• overlapTest(Node)
• overlapTestAll(Node)

علنية نهائية باطلة setEnabled (مفعَّلة منطقية)

تتيح هذه السياسة ضبط الحالة المفعّلة لهذه العقدة. تجدر الإشارة إلى أن العقدة قد تكون مفعّلة ولكنها لا تزال غير نشطة إذا لم تكن جزءًا من المشهد أو إذا كانت العنصر الرئيسي غير نشط.

المَعلمات

مفعّلة	الحالة المفعّلة الجديدة للعقدة

راجع أيضًا

• isActive()

علني باطل setLight (فاتح فاتح)

لضبط Light على العرض. لاستخدامها، عليك أولاً إنشاء Light باستخدام Light.Builder. عليك ضبط المعلَمات التي تهمّك، ثم إرفاقها بالعقدة باستخدام هذه الدالة. قد تحتوي العقدة على عرض وإضاءة أو تعمل فقط كـ Light.

المَعلمات

خفيف	خصائص Light للعرض، يُرجى تمرير قيمة فارغة لإزالة الضوء.

عامة باطلة setLocalPosition (موضع V3or3)

يحدّد موضع هذه العقدة مقارنةً بالعنصر الرئيسي (المساحة المحلية). إذا كانت السياسة isTopLevel() صحيحة، تكون قيمة السمة هي setWorldPosition(Vector3) نفسها.

المَعلمات

الموضع	الموضع المطلوب تطبيقه.

راجع أيضًا

• getLocalPosition()

عامة باطلة setLocalRotation (دوران الربع)

يحدّد دوران هذه العقدة مقارنةً بالعنصر الرئيسي (المساحة المحلية). إذا كانت السياسة isTopLevel() صحيحة، تكون قيمة السمة هي setWorldRotation(Quaternion) نفسها.

المَعلمات

دوران	تدوير لتطبيقه.

راجع أيضًا

• getLocalRotation()

علني باطل setLocalScale (مقياس Vector3)

لضبط حجم هذه العقدة بالنسبة إلى العنصر الرئيسي (المساحة المحلية). إذا كانت السياسة isTopLevel() صحيحة، تتطابق هذه السياسة مع setWorldScale(Vector3).

المَعلمات

التطوّر	المقياس المطلوب تطبيقه.

راجع أيضًا

• getLocalScale()

علني نهائي باطل setLookDirection (Vector3 LookDirection)

يحدِّد الاتجاه الذي تنظر إليه العُقدة في الفضاء العالمي. عند الاتصال بعد ذلك، سيتطابق getForward() مع اتجاه المظهر الذي تم تمريره. سيتم استخدام مفتاح المسافة عاليًا (0، 1، 0) لتحديد اتجاه العقدة حول الاتجاه.

المَعلمات

اتجاه النظر	متّجه يمثّل اتجاه المظهر المطلوب في الفضاء العالمي

علني نهائي باطل setLookDirection (Vector3LookDirection وVector3 upDirection)

يحدِّد الاتجاه الذي تنظر إليه العُقدة في الفضاء العالمي. عند الاتصال بعد ذلك، سيتطابق getForward() مع اتجاه المظهر الذي تم تمريره. سيحدّد الاتجاه للأعلى اتجاه العُقدة حول الاتجاه. لا يمكن أن يكون اتجاه العرض واتجاهه مصادفة (موازٍ) أو أن يكون الاتجاه غير صالح.

المَعلمات

اتجاه النظر	متّجه يمثّل اتجاه المظهر المطلوب في الفضاء العالمي
الاتجاه لأعلى	متّجه يمثل متّجهًا صالحًا للاستخدام، مثل Vector3.up()

Public المعلمة النهائية باطلة setName (String name)

إعداد اسم هذه العقدة. يمكن العثور على العُقد باستخدام أسمائها. وقد تتضمّن عدّة عُقد الاسم نفسه، وفي هذه الحالة يؤدي عرض findByName(String) إلى عرض العُقدة الأولى بالاسم نفسه.

المَعلمات

اسم	اسم العُقدة.

Public Empty setOnTapListener (Node.OnTapListener onTapListener)

تسجِّل استدعاءً لاستدعاءه عند النقر على هذه العقدة. إذا كان هناك معاودة اتصال مسجَّلة، لن تظهر أحداث اللمس في فقاعة العقدة هذه. إذا تم إلغاء Node.onTouchEvent ولم يتم استدعاء Super.onTouchEvent، لن تحدث النقرة.

المَعلمات

onTapListener

راجع أيضًا

• Node.OnTapListener

Public Empty setOnTouchListener (Node.OnTouchListener onTouchListener)

تسجِّل معاودة اتصال ليتم استدعاؤها عند إرسال حدث اللمس إلى هذه العقدة. إنّ طريقة نشر أحداث اللمس تعكس الطريقة التي يتم بها نشر اللمسات في الملفات الشخصية على Android. ويُسمى هذا الإجراء فقط عندما تكون العقدة نشطة.

عند وقوع الحدث ACTION_DOWN، يمثل بداية إيماءة. تمثيل ACTION_UP أو ACTION_CANCEL عند انتهاء إيماءة. عند بدء إيماءة، يتم تنفيذ ما يلي:

• عليك إرسال أحداث اللمس إلى العُقدة التي تم لمسها كما تم رصدها من قِبل hitTest(MotionEvent).
• إذا كانت العقدة لا تستخدم الحدث، تكرِّر مرة أخرى من خلال العنصر الرئيسي للعقدة وترسل حدث اللمس إلى أن تستهلك إحدى العُقدة الحدث.
• إذا لم تستهلك أي عُقدة الحدث، سيتم تجاهل الإيماءة ولن يتم تمرير الأحداث اللاحقة التي تكون جزءًا من الإيماءة إلى أي عُقد.
• إذا استهلكت إحدى العُقدة الحدث، ستستهلك هذه العقدة جميع أحداث اللمس المستقبلية للإيماءة.

عند إرسال حدث باللمس إلى عُقدة، يتم تمرير الحدث أولاً إلى العُقدة Node.OnTouchListener. إذا لم يعالج Node.OnTouchListener الفعالية، سيتم تمريرها إلى onTouchEvent(HitTestResult, MotionEvent).

المَعلمات

onTouchListener

راجع أيضًا

• Node.OnTouchListener

Public Empty setParent (NodeParent الرئيسي)

يؤدي إلى تغيير العقدة الرئيسية لهذه العقدة. في حال ضبط السياسة على قيمة فارغة، سيتم فصل هذه العقدة عن العقدة الرئيسية. ولن يطرأ أي تغيير على الموضع المحلي والتدوير والمقياس للعقدة. لذلك، قد يختلف الموضع العالمي لهذه العقدة وتدويرها وحجمها بعد تغيير العنصر الرئيسي.

قد يكون أحد الوالدَين Node أو Scene آخر. إذا كانت المشاهد عبارة عن مشهد، تُعتبر Node المستوى الأعلى. سيعرض getParent() قيمة فارغة، وسيعرض getScene() المشهد.

المَعلمات

عنصر رئيسي	العنصر الرئيسي الجديد الذي ستكون هذه العقدة فرعيًا منه. في حال عدم وجود قيم، سيتم فصل هذه العقدة عن العنصر الرئيسي.

راجع أيضًا

• getParent()
• getScene()

علنية باطلة setRenderable (قابلة للعرض قابلة للعرض)

تعمل على ضبط السمة Renderable لعرضها على هذه العقدة. إذا لم يتم ضبط setCollisionShape(CollisionShape)، يتم استخدام getCollisionShape() لرصد الأعطال في Node.

المَعلمات

قابل للعرض	نموذج ثلاثي الأبعاد في العادة إذا كانت القيمة فارغة، ستتم إزالة هذه العقدة الحالية القابلة للعرض.

راجع أيضًا

• ModelRenderable
• ViewRenderable

Public false setWorldPosition (Vector3 الموضع)

إعداد موضع الفضاء العالمي لهذه العقدة.

المَعلمات

الموضع	الموضع المطلوب تطبيقه.

راجع أيضًا

• getWorldPosition()

علنية باطلة setWorldRotation (دوران)

إعداد دوران العقدة العالمية للمساحة في هذه العقدة.

المَعلمات

دوران	تدوير لتطبيقه.

راجع أيضًا

• getWorldRotation()

Public Empty setWorldScale (مقياس Vector3)

لتحديد مقياس المسافة العالمية لهذه العقدة.

المَعلمات

التطوّر	المقياس المطلوب تطبيقه.

راجع أيضًا

• getWorldScale()

Public String toString ()

علني نهائي Vector3 worldToLocalDirection (الاتجاه V3or)

لتحويل اتجاه من الفضاء العالمي إلى المساحة المحلية لهذه العقدة. لا تتأثر بموضع العقدة أو نطاقها.

المَعلمات

direction	الاتجاه في العالم إلى الإحالة الناجحة

المرتجعات

• متّجه جديد يمثّل الاتجاه في المساحة المحلية

علني نهائي Vector3 worldToLocalPoint (نقطة Vector3)

لتحويل نقطة في الفضاء العالمي إلى المساحة المحلية لهذه العقدة.

المَعلمات

نقطة واحدة	نقطة في العالم لإجراء إحالة ناجحة

المرتجعات

• متّجه جديد يمثّل النقطة في المساحة المحلية

الطرق المحمية

حماية نهائية منطقية

المَعلمات

عنصر ثانوي
سبب الخطأ

حماية نهائية باطلة onAddChild (تابع ثانوي)

المَعلمات

عنصر ثانوي

حماية نهائية باطلة onChildChild (Node children)

المَعلمات

عنصر ثانوي