الكاميرا

الطبقة العامة الكاميرا

ويمثّل كاميرا افتراضية تحدّد المنظر الذي يتم من خلاله عرض المشهد.

إذا كانت الكاميرا جزءًا من ArSceneView، ستتتبّع الكاميرا تلقائيًا وضع الكاميرا من ARCore. إضافةً إلى ذلك، ستؤدي الطرق التالية إلى عرض UnsupportedOperationException عند الاتصال:

• setParent(NodeParent) - لا يمكن تغيير أحد الوالدَين للكاميرا، ف المشهد دائمًا.
• setLocalPosition(Vector3) - لا يمكن تغيير موضع الكاميرا لأنّه يتم التحكّم في موضعها من خلال وضع الكاميرا ARCore.
• setLocalRotation(Quaternion) - لا يمكن تغيير تدوير الكاميرا، لأنّه يتم التحكّم فيها من خلال وضع الكاميرا ARCore.
• setWorldPosition(Vector3) - لا يمكن تغيير موضع الكاميرا لأنّه يتم التحكّم في موضعها من خلال وضع الكاميرا ARCore.
• setWorldRotation(Quaternion) - لا يمكن تغيير تدوير الكاميرا، لأنّه يتم التحكّم فيها من خلال وضع الكاميرا ARCore.

جميع الوظائف الأخرى في العقدة متاحة. يمكنك الوصول إلى موضع الكاميرا وتدويرها أو تخصيص شكل تصادم للكاميرا أو إضافة أطفال إلى الكاميرا. ويؤدي إيقاف الكاميرا إلى إيقاف العرض.

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

عدد عائم	getFarClipPlane()
عدد عائم	getNearClipPlane()
عدد عائم	getVerticalFovDegrees() الحصول على مجال الرؤية الرأسي للكاميرا
طاقة	screenPointToRay (العائم x، العائم y) لحساب أشعة في الفضاء العالمي تبعًا للمستوى القريب من الكاميرا والمرور بنقطة في مساحة الشاشة.
باطلة	setLocalPosition(موضع Vector3) اضبط موضع الكاميرا.
باطلة	setLocalRotation(تناوب العرض) اضبط دوران الكاميرا.
باطلة	setParent(العنصر الرئيسي NodeParent) عملية غير متوافقة.
باطلة	setVerticalFowDegrees(فاصلة عمودية عائمة) لضبط حقل الرؤية الرأسي للكاميرا غير التابعة للدرجات بالدرجات.
باطلة	setWorldPosition(موضع Vector3) اضبط موضع الكاميرا.
باطلة	setWorldRotation(دوران رباعي) اضبط دوران الكاميرا.
الموجّه 3	worldToScreenPoint(نقطة Vector3) تحويل نقطة من مساحة العالم إلى مساحة شاشة.

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

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

باطلة	addLifecycleListener(Node.LifecycleListener LifecycleListener) لإضافة مستمع سيتم استدعاءه عند وقوع أحداث مراحل العقدة.
باطلة	addTransformChangedListener(Node.TransformChangedListener TransformChangedListener) لإضافة مستمع سيتم استدعاءه عند تغيير تحويل العقدة.
باطلة	callOnHierarchy(consumer<Node>consumer) اجتياز التسلسل الهرمي واستدعاء طريقة في كل عُقدة (بما في ذلك هذه العقدة).
قيمة منطقية	canAddChild(Node children, StringBuilder failed reason)
العقدة	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() التعامل مع حالة هذه العقدة عندما تصبح نشطة.
إلغاء	onAddChild(عنصر عقدة)
باطلة	onDisable() التعامل مع حالة هذه العقدة غير نشطة.
إلغاء	onRemoveChild(عنصر فرعي للعقدة)
منطقي	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) لتحويل نقطة في الفضاء العالمي إلى المساحة المحلية لهذه العقدة.

من الصف 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 العائم getFarClipPlane ()

Public العائم getNearClipPlane ()

Public العائم getVerticalFovDegrees ()

الحصول على مجال الرؤية الرأسي للكاميرا

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

وبخلاف ذلك، سيؤدي هذا الإجراء إلى عرض القيمة التي تم ضبطها بواسطة setVerticalFovDegrees(float)، مع قيمة تلقائية تبلغ 90 درجة.

طرح

GoogleStateState:	إذا تم طلبه قبل الإطار الأول بعد استئناف ARCore

علنية Ray screenPointToRay (العائم x، العائم y)

لحساب أشعة في الفضاء العالمي تبعًا للمستوى القريب من الكاميرا والمرور بنقطة في مساحة الشاشة. مساحة الشاشة في إحداثيات شاشة جهاز Android: الجزء العلوي الأيسر = (0، 0) أسفل اليمين = (عرض الشاشة، ارتفاع الشاشة) لا تتأثر مساحة إحداثيات الجهاز باتجاه الجهاز.

المَعلمات

x	الموضع X في إحداثيات شاشة الجهاز
y	الموضع Y في إحداثيات شاشة الجهاز

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

اضبط موضع الكاميرا. استخدِم الكاميرا isTopLevel() دائمًا، وبالتالي سيتّبِع هذا السلوك تمامًا مثل "setWorldPosition(Vector3)".

إذا كانت الكاميرا جزءًا من ArSceneView، هذا يعني أن هذه العملية غير متاحة. لا يمكن تغيير موضع الكاميرا، لأنّه يتم التحكّم في موضع الكاميرا من خلال وضع الكاميرا ARCore.

المَعلمات

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

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

اضبط دوران الكاميرا. استخدِم الكاميرا isTopLevel() دائمًا، وبالتالي سيتّبِع هذا السلوك تمامًا مثل "setWorldRotation(Quaternion)".

إذا كانت الكاميرا جزءًا من ArSceneView، هذا يعني أن هذه العملية غير متاحة. لا يمكن تغيير تدوير الكاميرا، لأنّه يتم التحكّم في ذلك من خلال وضع الكاميرا ARCore.

المَعلمات

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

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

عملية غير متوافقة. لا يمكن تغيير أحد الوالدين في الكاميرا، لأنه دائمًا ما يكون المشهد.

المَعلمات

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

لضبط حقل الرؤية الرأسي للكاميرا غير التابعة للدرجات بالدرجات. إذا كانت هذه الكاميرا مزوّدة بتقنية الواقع المعزّز، هذا يعني أنّ جهاز vov مصدره ARCore ولا يمكن ضبطه، لذا سيتم طرح استثناء. الإعداد التلقائي هو 90 درجة.

المَعلمات

عموديFow

طرح

استثناء استثناء غير متوافق	إذا كانت هذه الكاميرا هي تقنية الواقع المعزّز

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

اضبط موضع الكاميرا. استخدِم الكاميرا isTopLevel() دائمًا، وبالتالي سيتّبِع هذا السلوك تمامًا مثل "setLocalPosition(Vector3)".

إذا كانت الكاميرا جزءًا من ArSceneView، هذا يعني أن هذه العملية غير متاحة. لا يمكن تغيير موضع الكاميرا، لأنّه يتم التحكّم في موضع الكاميرا من خلال وضع الكاميرا ARCore.

المَعلمات

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

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

اضبط دوران الكاميرا. استخدِم الكاميرا isTopLevel() دائمًا، وبالتالي سيتّبِع هذا السلوك تمامًا مثل "setLocalRotation(Quaternion)".

إذا كانت الكاميرا جزءًا من ArSceneView، هذا يعني أن هذه العملية غير متاحة. لا يمكن تغيير تدوير الكاميرا، لأنّه يتم التحكّم في ذلك من خلال وضع الكاميرا ARCore.

المَعلمات

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

علني Vector3 worldToScreenPoint (نقطة Vector3)

تحويل نقطة من مساحة العالم إلى مساحة شاشة.

تكون قيمة X سالبة عندما تكون النقطة يسار إطار العرض، بين 0 وعرض SceneView عندما تكون النقطة داخل إطار العرض، أكبر من العرض عندما تكون النقطة على يمين إطار العرض.

تكون قيمة Y سالبة عندما تكون النقطة أسفل إطار العرض، بين 0 وارتفاع SceneView عندما تكون النقطة داخل إطار العرض، وأكبر من الارتفاع عندما تكون النقطة فوق إطار العرض.

تكون قيمة Z دائمًا 0 لأن قيمة العرض هي إحداثيات ثنائية الأبعاد.

المَعلمات

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

المرتجعات

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