ميزة "التجوّل الافتراضي في بانوراما"

الفئة العامة StreetViewPanoramaFragment تعمل على توسيع نطاق الأجزاء

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

 <fragment
    class="com.google.android.libraries.maps.StreetViewPanoramaFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
يجب الحصول على StreetViewPanorama باستخدام getStreetViewPanoramaAsync(OnStreetViewPanoramaReadyCallback). تعمل StreetViewPanoramaFragment على إعداد نظام "التجوّل الافتراضي" وطريقة العرض تلقائيًا.

يمكن إزالة طريقة عرض عندما يتم استدعاء طريقة onDestroyView() في StreetViewPanoramaFragment ويتم ضبط الخيار useViewLifecycleInFragment(boolean). وعند حدوث ذلك، تصبح ميزة StreetViewPanoramaFragment غير صالحة إلى أن تتم إعادة إنشاء العرض مرة أخرى لاحقًا عند استدعاء طريقة onCreateView(LayoutInflater, ViewGroup, Bundle) في MapFragment.

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

لا تستخدِم هذا الصف إلا إذا كنت تستهدف واجهة برمجة التطبيقات 12 والإصدارات الأحدث. بخلاف ذلك، يمكنك استخدام SupportStreetViewPanoramaFragment.

ملاحظة: لا تتوافق حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android مع عناصر StreetViewPanoramaFragment متعددة في نشاط واحد.

ملخّص ثابت مكتسَب

ملخّص عام للمنشئ

StreetViewPanoramaFragment()
لإنشاء جزء بانورامي للتجوّل الافتراضي.

ملخّص الطريقة العلنية

void
getStreetViewPanoramaAsync(OnStreetViewPanoramaReadyCallback callback)
تتيح هذه السياسة ضبط كائن استدعاء يتم تشغيله عندما يكون المثيل StreetViewPanorama جاهزًا للاستخدام.
StreetViewPanoramaFragment ثابت
newInstance(خيارات StreetViewPanoramaOptions)
لإنشاء جزء بانورامي للتجوّل الافتراضي باستخدام الخيارات المحددة.
StreetViewPanoramaFragment ثابت
newInstance()
لإنشاء جزء بانورامي للتجوّل الافتراضي، باستخدام الخيارات الافتراضية.
void
onActivityCreated(Bundle savedInstanceState)
void
onAttach(نشاط النشاط)
void
onCreate(Bundle savedInstanceState)
عرض
onCreateView(LayoutInflater inflater, ViewGroup, Bundle savedInstanceState)
void
void
void
onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState)
تحليل السمات أثناء التضخم من العرض الهرمي لطريقة العرض إلى الوسيطات التي نتعامل معها.
void
void
void
void
onSaveInstanceState(حزمة outState)
void
void
onStop()
void
setArguments(وسيطات الحزمة)

ملخّص الطريقة المكتسبة

مقاولات عامة

عامة StreetViewPanoramaFragment ()

لإنشاء جزء بانورامي للتجوّل الافتراضي. إنّ طريقة الإنشاء هذه متاحة للجميع فقط، ولا يمكن استخدامها إلا من قِبل شخص يشتعل. استخدام newInstance() لإنشاء StreetViewPanoramaFragment بشكل آلي.

الطرق العامة

إلغاء عام getStreetViewPanoramaAsync (معاودة الاتصال في OnStreetViewPanoramaReadyCallback)

تتيح هذه السياسة ضبط كائن استدعاء يتم تشغيله عندما يكون المثيل StreetViewPanorama جاهزًا للاستخدام.

ملاحظات:

  • في حال عدم تثبيت "خدمات Google Play" على جهاز المستخدم، لن يتم بدء معاودة الاتصال حتى يثبّتها المستخدم.
  • سيتم تنفيذ رد الاتصال في سلسلة التعليمات الرئيسية.
  • لا يتوفّر كائن StreetViewPanorama الذي يوفّره استدعاء الدالة.

المَعلمات
رد الاتصال كائن معاودة الاتصال الذي سيتم تشغيله عندما تكون البانوراما جاهزة للاستخدام.

عامة ثابتة StreetViewPanoramaFragment newInstance (خيارات StreetViewPanoramaOptions)

لإنشاء جزء بانورامي للتجوّل الافتراضي باستخدام الخيارات المحددة.

المَعلمات
الخيارات

public static StreetViewPanoramaFragment newInstance ()

لإنشاء جزء بانورامي للتجوّل الافتراضي، باستخدام الخيارات الافتراضية.

إبطال عام onActivityCreated (Bundle savedInstanceState)

المَعلمات
savedInstanceState

فارغ علني onAttach (نشاط نشاط)

المَعلمات
النشاط

إبطال عام onCreate (Bundle savedInstanceState)

المَعلمات
savedInstanceState

عامة عرض onCreateView (LayoutInflater inflater, ViewGroup, Bundle savedInstanceState)

المَعلمات
أداة نفخ
الحاوية
savedInstanceState

إلغاء عام onDestroy ()

إلغاء عام onDestroyView ()

public void onInflate (Activity activity, AttributeSet attrs, Bundle savedInstanceState)

تحليل السمات أثناء التضخم من العرض الهرمي لطريقة العرض إلى الوسيطات التي نتعامل معها.

المَعلمات
النشاط
attrs
savedInstanceState

فارغ علني onLowMemory ()

إلغاء علني onPause ()

فارغ أمام الجمهور onResume ()

إبطال عام onSaveInstanceState (حزمة outState)

المَعلمات
outState

فارغ علني onStart ()

إلغاء علني onStop ()

إلغاء علني setArguments (وسيطات الحزمة)

المَعلمات
args