BaseArragment

الفئة التجريدية العامة BaseArFragment
الفئات الفرعية المباشرة المعروفة

يوفّر جزء الواقع المعزّز تنسيق العرض المطلوب ووحدات التحكُّم المطلوبة لميزات الواقع المعزّز الشائعة.

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

محسّنة BaseArFragment.OnSessionInitializationListener تم استدعاء عند إعداد جلسة ARCore. 
محسّنة BaseArFragment.OnTapArPlaneListener تم استدعاءها عند النقر على طائرة ARCore. 

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

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

تجريدي سلسلة[]
getAdditionalPermissions()
تعرض مجموعة من الأذونات الخطيرة التي يطلبها التطبيق بالإضافة إلى Manifest.permission.CAMERA، وهي مطلوبة من خلال ARCore.
ArSceneView
getArSceneView()
للحصول على ArSceneView لهذا الجزء.
طائرة استكشافية
getPlaneDetectyController()
تحصل على وحدة التحكّم في اكتشاف الطائرة، والتي تعرض تعليمات حول كيفية البحث عن الطائرات.
نظام التحويل
getTransformationSystem()
يحصل نظام التشغيل على نظام التحويل الذي تستخدمه TransformableNode لرصد الإيماءات وتنسيق العقدة المحدّدة.
منطقي
isArمطلوبة()
عرض "صحيح" إذا كان هذا التطبيق مطلوبًا باستخدام "الواقع المعزّز"، و"خطأ" إذا كان "الواقع المعزّز" اختياريًا.
عرض
باطلة
باطلة
باطلة
باطلة
onPeekTouch(HitTestResult HitTestResult, MotionEvent actionEvent)
يتم الاتصال عند إرسال حدث اللمس إلى مشهد.
باطلة
onRequestPermissionsResult(int orderCode, String[] permissions, int[] results)
تلقّي نتائج طلبات الأذونات.
باطلة
باطلة
onUpdate(TimeTime FrameTime)
يتم طلبها مرة واحدة لكل إطار قبل تحديث المشهد مباشرةً.
باطلة
setOnSessionInitialationListener(BaseArFragment.OnSessionInitializationListener onSessionInitializationListener)
تسجِّل استدعاءً لاستدعاءه عند بدء جلسة ARCore.
باطلة
setOnTapArPlaneListener(BaseArFragment.OnTapArPlaneListener onTapArPlaneListener)
تسجِّل استدعاءً لاستدعاءه عند النقر على طائرة ARCore.

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

منطقي
getCanRequestDemandPermissions()
إذا كانت القيمة صحيحة، تعرض خدمة requestDangerousPermissions() بدون اتخاذ أي إجراء، إذا تم طلب أذونات خطأ.
الإعداد المجرّد
تجريدي Set<Session.Feature>
getSessionFeatures()
يحدِّد هذا الإعداد ميزات إضافية لإنشاء Session ARCore.
تجريدي
إلغاء
initializeSession()
لإعداد جلسة ARCore.
نظام التحويل
makeTransformationSystem()
تنشئ نظام التحويل الذي يستخدمه هذا الجزء.
باطلة
onWindowتركيزChanged(boolean hasالتركيز)
باطلة
request القسمPermissions()
يبدأ عملية طلب أذونات خطيرة.
قيمة منطقية
باطلة
setCanRequest الخطيPermissions(Boolean canRequest الخطيPermissions)
إذا كانت القيمة صحيحة، تعرض خدمة requestDangerousPermissions() بدون اتخاذ أي إجراء، إذا تم طلب أذونات خطأ.
باطلة

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

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

Public BaseArFragment ()

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

علنية تجريدية سلسلة[] getAdditionalPermissions ()

تعرض مجموعة من الأذونات الخطيرة التي يطلبها التطبيق بالإضافة إلى Manifest.permission.CAMERA، وهي مطلوبة من خلال ARCore. وإذا لم تكن هناك حاجة إلى أذونات إضافية، يجب عرض مصفوفة فارغة.

Public ArSceneView getArSceneView ()

للحصول على ArSceneView لهذا الجزء.

Public PlaneDetectyController getPlaneDetectyController ()

تحصل على وحدة التحكّم في اكتشاف الطائرة، والتي تعرض تعليمات حول كيفية البحث عن الطائرات.

public TransformationSystem getTransformationSystem ()

يحصل نظام التشغيل على نظام التحويل الذي تستخدمه TransformableNode لرصد الإيماءات وتنسيق العقدة المحدّدة.

علنية تجريدية منطقية isArمطلوبة ()

عرض "صحيح" إذا كان هذا التطبيق مطلوبًا باستخدام "الواقع المعزّز"، و"خطأ" إذا كان "الواقع المعزّز" اختياريًا. ويُسمى هذا عند إعداد التطبيق والجلسة.

Public View onCreateView (LayoutInflater ملصقًا، حاوية ViewGroup، Bundle savedInstanceState)

المَعلمات
منتفخ
الحاوية
تم حفظ InstanceState

Public Empty onDestroy ()

Public Empty onDestroyView ()

Public Empty onPause ()

يتم الاتصال عند إرسال حدث اللمس إلى مشهد. سيتم استدعاء معاودة الاتصال قبل استدعاء Scene.OnTouchListener. ويتم استدعاء ذلك حتى إذا تم استهلاك الإيماءة، ما يتيح رصد جميع أحداث الحركة التي يتم إرسالها إلى المكان. ويُطلق على هذه العملية اسم حتى لو لم تكن اللمس فوق عُقدة، وفي هذه الحالة، ستكون قيمة getNode() فارغة.

المَعلمات
النتيجة الاختبارية تمثّل العقدة التي تم لمسها
actionEvent حَرَكَةُ الْحَرَكَة

علنية باطلة onRequestPermissionsResult (int orderCode, String[] permissions, int[] results)

تلقّي نتائج طلبات الأذونات.

سيُظهِر مربّع حوار لطلب الأذونات. ويمكن لمربّع الحوار إرسال المستخدم إلى تطبيق "الإعدادات" أو إنهاء النشاط.

المَعلمات
رمز الطلب
أذونات
نتائج

Public Empty onاستئناف ()

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

يتم طلبها مرة واحدة لكل إطار قبل تحديث المشهد مباشرةً.

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

Public Empty setOnSessionInitializationListener (BaseArFragment.OnSessionInitializationListener onSessionInitializationListener)

تسجِّل استدعاءً لاستدعاءه عند بدء جلسة ARCore. سيتم استدعاء معاودة الاتصال مرة واحدة فقط بعد بدء الجلسة وقبل استئنافها.

المَعلمات
onSessionInitialationListener BaseArFragment.OnSessionInitializationListener لإرفاقها.

Public Empty setOnTapArPlaneListener (BaseArFragment.OnTapArPlaneListener onTapArPlaneListener)

تسجِّل استدعاءً لاستدعاءه عند النقر على طائرة ARCore. لن يتم استدعاء معاودة الاتصال إلا إذا لم يتم النقر على Node.

المَعلمات
onTapArPlaneListener BaseArFragment.OnTapArPlaneListener لإرفاقه

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

محمي منطقي getCanRequest خطيرPermissions ()

إذا كانت القيمة صحيحة، تعرض خدمة requestDangerousPermissions() بدون اتخاذ أي إجراء، إذا تم طلب أذونات خطأ.

محمي تجريدي الإعداد getSessionConfiguration (جلسة جلسة)

المَعلمات
جلسة

محمية تجريدية Set<Session.Feature> getSessionFeatures ()

يحدِّد هذا الإعداد ميزات إضافية لإنشاء Session ARCore. يمكنك الاطّلاع على Session.Feature.

المَعلمات
استثناء الجلسة

حماية نهائية باطلة initializeSession ()

لإعداد جلسة ARCore. يتم التحقّق من إذن CAMERA قبل التحقّق من حالة تثبيت ARCore. بعد الموافقة على الأذونات والتثبيت، يتم استدعاء الطريقة #getSessionConfiguration(جلسة الجلسة) للحصول على إعداد الجلسة لاستخدامها. يتطلب Sceneform تحديث جلسة ARCore باستخدام LATEST_CAMERA_IMAGE لتجنب الحظر أثناء الرسم. يتم ضبط هذا الوضع على عنصر الضبط المعروض من الفئة الفرعية.

Protected TransformationSystem makeTransformationSystem ()

تنشئ نظام التحويل الذي يستخدمه هذا الجزء. يمكن إلغاء هذا النوع لإنشاء نظام تحويل مخصص.

بلد باطل onWindowتركيزChanged (boolean hasالتركيز)

المَعلمات
تحديد التركيز

Protected إبطال request الخطي الأذونات ()

يبدأ عملية طلب أذونات خطيرة. تجمع هذه السياسة بين إذن CAMERA المطلوب من ARCore وأي أذونات يتم عرضها من خلال getAdditionalPermissions(). لا تتوفّر معالجة محدّدة في نتيجة الطلب، ويمكن للفئات الفرعية إلغاء onRequestPermissionsResult() عند الحاجة إلى معالجة إضافية.

بإمكان setCanRequestDangerousPermissions(Boolean) إيقاف هذه الدالة من اتخاذ أي إجراء.

حماية نهائية منطقية requestInstall ()

بلد باطل setCanRequestInappropriatePermissions (Boolean canRequestInappropriatePermissions)

إذا كانت القيمة صحيحة، تعرض خدمة requestDangerousPermissions() بدون اتخاذ أي إجراء، إذا تم طلب أذونات خطأ.

المَعلمات
CanRequest الخطي أذونات

بلد باطل setupSelectionRenderable (FootprintSelectionVisualizerSelectvisibleizer)

المَعلمات
أداة الاختيار المرئية