الفئات الفرعية المباشرة المعروفة |
يوفّر جزء الواقع المعزّز تنسيق العرض المطلوب ووحدات التحكُّم المطلوبة لميزات الواقع المعزّز الشائعة.
الصفوف المتداخلة
محسّنة | BaseArFragment.OnSessionInitializationListener | تم استدعاء عند إعداد جلسة ARCore. | |
محسّنة | BaseArFragment.OnTapArPlaneListener | تم استدعاءها عند النقر على طائرة ARCore. |
الأشغال العامة
الأساليب العامة
تجريدي سلسلة[] |
getAdditionalPermissions()
تعرض مجموعة من الأذونات الخطيرة التي يطلبها التطبيق بالإضافة إلى
Manifest.permission.CAMERA، وهي مطلوبة من خلال ARCore.
|
ArSceneView |
getArSceneView()
للحصول على ArSceneView لهذا الجزء.
|
طائرة استكشافية |
getPlaneDetectyController()
تحصل على وحدة التحكّم في اكتشاف الطائرة، والتي تعرض تعليمات حول كيفية البحث عن الطائرات.
|
نظام التحويل |
getTransformationSystem()
يحصل نظام التشغيل على نظام التحويل الذي تستخدمه
TransformableNode لرصد الإيماءات وتنسيق العقدة المحدّدة. |
منطقي |
isArمطلوبة()
عرض "صحيح" إذا كان هذا التطبيق مطلوبًا باستخدام "الواقع المعزّز"، و"خطأ" إذا كان "الواقع المعزّز" اختياريًا.
|
عرض | |
باطلة | |
باطلة | |
باطلة |
onPause()
|
باطلة |
onPeekTouch(HitTestResult HitTestResult, MotionEvent actionEvent)
يتم الاتصال عند إرسال حدث اللمس إلى مشهد.
|
باطلة |
onRequestPermissionsResult(int orderCode, String[] permissions, int[] results)
تلقّي نتائج طلبات الأذونات.
|
باطلة | |
باطلة | |
باطلة |
setOnSessionInitialationListener(BaseArFragment.OnSessionInitializationListener onSessionInitializationListener)
تسجِّل استدعاءً لاستدعاءه عند بدء جلسة ARCore.
|
باطلة |
setOnTapArPlaneListener(BaseArFragment.OnTapArPlaneListener onTapArPlaneListener)
تسجِّل استدعاءً لاستدعاءه عند النقر على طائرة ARCore.
|
الطرق المحمية
منطقي |
getCanRequestDemandPermissions()
إذا كانت القيمة صحيحة، تعرض خدمة
requestDangerousPermissions() بدون اتخاذ أي إجراء، إذا تم طلب أذونات
خطأ.
|
الإعداد المجرّد |
getSessionConfiguration(جلسة جلسة)
|
تجريدي Set<Session.Feature> |
getSessionFeatures()
يحدِّد هذا الإعداد ميزات إضافية لإنشاء
Session ARCore. |
تجريدي |
andleSessionException(UnavailableExceptions sessionException)
|
إلغاء |
initializeSession()
لإعداد جلسة ARCore.
|
نظام التحويل |
makeTransformationSystem()
تنشئ نظام التحويل الذي يستخدمه هذا الجزء.
|
باطلة |
onWindowتركيزChanged(boolean hasالتركيز)
|
باطلة |
request القسمPermissions()
يبدأ عملية طلب أذونات خطيرة.
|
قيمة منطقية | |
باطلة |
setCanRequest الخطيPermissions(Boolean canRequest الخطيPermissions)
إذا كانت القيمة صحيحة، تعرض خدمة
requestDangerousPermissions() بدون اتخاذ أي إجراء، إذا تم طلب أذونات
خطأ.
|
باطلة |
setupSelectionRenderable(FootprintSelectionمرئيizer الاختيار المرئي)
|
الطرق المكتسَبة
الأشغال العامة
Public BaseArFragment ()
الأساليب العامة
علنية تجريدية سلسلة[] getAdditionalPermissions ()
تعرض مجموعة من الأذونات الخطيرة التي يطلبها التطبيق بالإضافة إلى Manifest.permission.CAMERA، وهي مطلوبة من خلال ARCore. وإذا لم تكن هناك حاجة إلى أذونات إضافية، يجب عرض مصفوفة فارغة.
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()
بدون اتخاذ أي إجراء، إذا تم طلب أذونات
خطأ.
محمية تجريدية 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)
إيقاف هذه الدالة من اتخاذ أي إجراء.
بلد باطل setCanRequestInappropriatePermissions (Boolean canRequestInappropriatePermissions)
إذا كانت القيمة صحيحة، تعرض خدمة requestDangerousPermissions()
بدون اتخاذ أي إجراء، إذا تم طلب أذونات
خطأ.
المَعلمات
CanRequest الخطي أذونات |
---|
بلد باطل setupSelectionRenderable (FootprintSelectionVisualizerSelectvisibleizer)
المَعلمات
أداة الاختيار المرئية |
---|