عرض ArSceneView

الطبقة العامة ArSceneView

SurfaceView يتكامل مع ARCore ويعرض مشهدًا.

الثوابت المكتسَبة

الحقول المكتسَبة

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

ArSceneView(سياق السياق)
إنشاء كائن ArSceneView وربطه بسياق Android.
ArSceneView(Context Context, AttributeSet
إنشاء كائن ArSceneView وربطه بسياق Android.

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

إطار
getArإطار()
عرض أحدث إطار ARCore إذا كان متاحًا
int
getCameraStreamRenderPriority()
حدِّد أولوية العرض التي تتحكّم في ترتيب عرض بث الكاميرا.
PlaneRenderer
getPlaneRenderer()
لعرض PlaneRenderer، الذي يتم استخدامه للتحكم في التمثيل البصري للطائرة.
الجلسة
getSession()
لعرض جلسة ARCore التي يستخدمها هذا الملف الشخصي.
منطقي
isEnvironmentalHdrLightingavailable()
عرض "صحيح" إذا تم ضبط كاميرا ARCore باستخدام Config.LightEstimationMode.ENVIRONMENTAL_HDR
منطقي
isLightDirectionUpdateEnabled()
تحقّق مما إذا كان يتم تعديل ضوء الشمس في كل إطار وفقًا لتقدير مستوى الإضاءة البيئية في النطاق العالي الديناميكية.
منطقي
باطلة
pause()
لإيقاف سلسلة العرض مؤقتًا وجلسة ARCore.
CompletableFuture<Void>
pauseAsync(منفّذ منفِّذ)
طلب غير محظور لإيقاف سلسلة العرض دائمًا وجلسة ARCore.
باطلة
استئناف()
استئناف سلسلة العرض وجلسة ARCore
CompletableFuture<Void>
resumeAsync(منفّذ منفِّذ)
مكالمة غير محظورة لاستئناف سلسلة العرض وجلسة ARCore في الخلفية

يجب استدعاء هذه الخطوة من خلال on سيرتك الذاتية.

باطلة
setCameraStreamRenderPriority (أولوية قصوى)
اضبط أولوية العرض للتحكم في ترتيب عرض بث الكاميرا.
باطلة
setLightDirectionUpdateEnabled(منطقي isLightDirectionUpdateEnabled)
يحدِّد هذا الإعداد ما إذا كان يجب تعديل اتجاه أشعة الشمس الناتجة عن إضاءة HDR البيئية في كل إطار.
باطلة
setLightEstimationEnabled(تفعيل منطقي)
تفعيل تقدير الإضاءة استنادًا إلى خلاصة الكاميرا.
باطلة
setupSession(جلسة الجلسة)
إعداد العرض باستخدام جلسة الواقع المعزّز.

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

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

علني ArSceneView (سياق السياقات)

إنشاء كائن ArSceneView وربطه بسياق Android.

لكي يعمل العرض بشكل صحيح، يجب استدعاء setupSession(Session).

المَعلمات
سياق سياق Android المطلوب استخدامه

علنية ArSceneView (سياق السياق، Attribute{/)

إنشاء كائن ArSceneView وربطه بسياق Android.

لكي يعمل العرض بشكل صحيح، يجب استدعاء setupSession(Session).

المَعلمات
سياق سياق Android المطلوب استخدامه
السمات Android AttributeSet لربطها بـ
راجع أيضًا

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

Public Frame getArframe ()

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

public int getCameraStreamRenderPriority ()

حدِّد أولوية العرض التي تتحكّم في ترتيب عرض بث الكاميرا. وتكون الأولوية بين نطاق من 0 (يتم عرضه أولاً) و7 (تاريخ العرض الأخير).

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

Public PlaneRenderer getPlaneRenderer ()

لعرض PlaneRenderer، الذي يتم استخدامه للتحكم في التمثيل البصري للطائرة.

علنية جلسة getSession ()

لعرض جلسة ARCore التي يستخدمها هذا الملف الشخصي.

Public boolean isEnvironmentalHdrLightingavailable ()

عرض "صحيح" إذا تم ضبط كاميرا ARCore باستخدام Config.LightEstimationMode.ENVIRONMENTAL_HDR عند تفعيل وضع الإضاءة البيئية في النطاق العالي الديناميكية، سيتم تطبيق تقديرات الإضاءة الناتجة على أجواء الإضاءة.

المرتجعات
  • صحيح إذا تم تفعيل إضاءة HDR في Sceneform بسبب تفعيل تقدير الإضاءة HDR في النطاق العالي الديناميكية.

Public boolean isLightDirectionUpdateEnabled ()

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

المرتجعات
  • صحيح إذا تم تحديث اتجاه ضوء الشمس في كل إطار، في حالة أخرى، سيتم خطأ.

Public boolean isLightEstimationEnabled ()

المرتجعات
  • عرض "صحيح" إذا تم تفعيل تقدير الضوء.

Public Empty pause ()

لإيقاف سلسلة العرض مؤقتًا وجلسة ARCore.

يجب استدعاء هذه السياسة من onPause().

Public CompletableFuture<Void> pauseAsync (مُنفِّذ)

طلب غير محظور لإيقاف سلسلة العرض دائمًا وجلسة ARCore.

يجب استدعاء هذه السياسة من onPause().

في حال استدعاء pauseAsync أثناء إيقاف مؤقت أو استئناف آخر، ستتم إضافة الإيقاف المؤقت إلى القائمة بعد اكتمال العملية الحالية.

المَعلمات
منفّذ وصية
المرتجعات
  • اكتملت CompletableFuture على سلسلة المحادثات الرئيسية عند الإيقاف المؤقت. سيتم إكمال المستقبل بطريقة استثنائية في حال تعذّر إكمال سيرة ذاتية.

Public Empty استئناف ()

استئناف سلسلة العرض وجلسة ARCore

يجب استدعاء هذه الخطوة من خلال on سيرتك الذاتية.

طرح
يتعذّر الوصول إلى استثناء الكاميرا إذا تعذّر فتح الكاميرا

Public CompletableFuture<Void> resumeAsync (مُنفِّذ

مكالمة غير محظورة لاستئناف سلسلة العرض وجلسة ARCore في الخلفية

يجب استدعاء هذه الخطوة من خلال on سيرتك الذاتية.

في حال تفعيل ميزة الإيقاف المؤقت أو الاستئناف مرة أخرى، ستتم إضافة السير الذاتية إلى قائمة الانتظار بعد اكتمال العملية.

المَعلمات
منفّذ وصية
المرتجعات
  • يتم إكمال جلسة مكمّلة في سلسلة المحادثات الرئيسية بعد اكتمال عملية استئناف العمل. سيتم إكمال العملية في المستقبل بطريقة استثنائية في حال تعذّر إكمال سيرتك الذاتية.

علنية باطلة setCameraStreamRenderPriority (أولوية قصوى)

اضبط أولوية العرض للتحكم في ترتيب عرض بث الكاميرا. وتكون الأولوية بين نطاق من 0 (يتم عرضه أولاً) و7 (تاريخ العرض الأخير).

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

المَعلمات
الأولوية

Public Empty setLightDirectionUpdateEnabled (منطقي isLightDirectionUpdateEnabled)

يحدِّد هذا الإعداد ما إذا كان يجب تعديل اتجاه أشعة الشمس الناتجة عن إضاءة HDR البيئية في كل إطار. وفي حال ضبطها على "خطأ"، سيتم تعديل اتجاه الضوء مرة واحدة ولن يتغيّر بعد ذلك.

يمكن استخدام هذا الإذن لإيقاف تحديثات اتجاه الظل عندما تكون مشتّتة للانتباه أو غير مرغوب فيها.

وتكون الحالة التلقائية صحيحة، ويتم تعديل اتجاه ضوء الشمس في كل إطار.

المَعلمات
isLightDirectionUpdateEnabled

Public Empty setLightEstimationEnabled (تفعيل منطقي)

تفعيل تقدير الإضاءة استنادًا إلى خلاصة الكاميرا. سيتم تعديل لون وضوء الشمس غير المباشر من خلال قيم مقدّمة من خلال تقدير ضوء ARCore's. وستتأثر العناصر في المشهد.

المَعلمات
تفعيل على "صحيح" لتفعيل تقدير الإضاءة أو "خطأ" لاستخدام التقدير التلقائي، وهو كثافة وحدة البكسل 1.0 وقيمة تصحيح الألوان باللون الأبيض (1.0 أو 1.0 أو 1.0).

علنية باطلة setupSession (جلسة الجلسة)

إعداد العرض باستخدام جلسة الواقع المعزّز. يجب طلب هذه الطريقة مرة واحدة لتوفير جلسة ARCore. الجلسة مطلوبة لأي عرض.

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

المَعلمات
جلسة جلسة ARCore التي يجب استخدامها في طريقة العرض هذه