عرض التنقّل

الفئة العامة NavigationView توسيع ParentalLayout

طريقة عرض تعرض خريطة للتنقل.

على المستخدمين في هذا الفئة إعادة توجيه جميع طُرق دورة الحياة من Activity أو Fragment التي تحتوي على هذا العرض إلى الطرق المقابلة لها في هذا الفئة. وعلى وجه الخصوص، يجب إعادة توجيه الطرق التالية:

إذا تمت إضافة NavView بعد مرور Activity أو Fragment خلال مراحل نشاط الإنشاء، يجب طلب onCreate(Bundle) وonStart() وonResume() يدويًا لإعداده بشكل صحيح. وبالمثل، إذا تم فصل NavView عن العنصر الرئيسي Activity أو Fragment، عليك استدعاء onPause() وonStop() وonDestroy() يدويًا لمنع تسرُّب البيانات.

ملاحظة: ننصحك بعدم إضافة أطفال إلى هذا العرض.

يجب تنفيذ جميع عمليات الاستدعاء إلى NavView في سلسلة محادثات واجهة المستخدم.

ملخص الفئة المدمَجة

واحدة NavigationView.OnNightModeChangedListener واجهة للمستمع الذي سيتم إرسال إشعار إليه عند دخول واجهة المستخدم "الوضع الليلي" أو الخروج منه.
واحدة NavigationView.OnRecenterButtonClickedListener واجهة للمستمع سيتم إرسال إشعار إليها عند النقر على زر إعادة التوسيط. 

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

ملخّص الحقل المكتسَب

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

NavigationView(سياق السياق)
NavigationView(سياق السياق، عناصر AttributeSet)
NavigationView(سياق السياق، AttributeSet attrs، int defStyleAttr)

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

الكاميرا
getCamera()
تعرض كائن الكاميرا الذي يمكن استخدامه لتغيير إطار العرض للخريطة.
NavigationMap
getMap()
تعرض كائنًا يمكن استخدامه لإضافة محتوى إلى الخريطة.
void
onConfigurationChanged(Configuration config)
void
onCreate(Bundle savedInstanceState)
void
void
void
void
onSaveInstanceState(حزمة outState)
void
void
onStop()
void
onTrimMemory(مستوى الهدف الصحيح)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode replaceInfoDisplayModeOverride)
تلغي هذه العلامة وضع العرض التلقائي لوسائل شرح الإعلان النصي الموسَّع أثناء التنقّل.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormatوسيلة الشرحInfoFormatOverride)
لضبط وضع تنسيق معلومات وسائل الشرح لوسائل شرح المسار.
void
setCompassEnabled(تفعيل منطقي)
لتحديد ما إذا كانت البوصلة مرئية أم لا.
void
setCustomControl(عرض عنصر التحكّم، الموضع CustomControlPosition)
يعين طريقة عرض تحكم مخصصة والتي ستظهر في الموضع المحدد في واجهة مستخدم التنقل.
void
setEtaCardEnabled(تفعيل منطقي)
لتحديد ما إذا كانت بطاقة الوقت المقدر للوصول ستظهر أثناء التنقل.
void
setForceNightMode(int NightMode)
لضبط ForceNightMode الحالية
void
setHeaderEnabled(تفعيل منطقي)
تحدِّد هذه السياسة ما إذا كان رأس التنقّل باتّجاهات مفصّلة مرئيًا أثناء التنقّل.
void
setOnNightModeChangedListener(NavigationView.OnNightModeChangedListener مستمع)
لضبط مستمِع يتم إرسال إشعار إليه على الفور بحالة "الوضع الليلي" الحالية ومتى تدخل واجهة المستخدم في "الوضع الليلي" أو تخرج منها.
void
setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener مستمع)
لضبط مستمع سيتم إرسال إشعار إليه عند النقر على زر إعادة التوسيط.
void
setRecenterButtonEnabled(تفعيل منطقي)
يحدّد هذا الإعداد ما إذا كان يجب عرض زر إعادة التوسيط.
void
setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions)
تضبط هذه السياسة SpeedAlertOptions لتخصيص حدود التشغيل لـ SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(تفعيل منطقي)
يحدِّد هذا الإعداد ما إذا كان سيتم عرض رمز حدّ السرعة.
void
setSpeedometerIconEnabled(تم تفعيل منطقية)
تحدِّد هذه السياسة ما إذا كان سيتم عرض رمز عدّاد السرعة.
void
setSpeedometerUiOptions(SpeedometerUiOptions عداد السرعةUiOptions)
تضبط هذه السياسة إعدادات واجهة المستخدم لعدّاد السرعة على SpeedometerUiOptions استنادًا إلى SpeedAlertSeverity.
void
setStylingOptions(StylingOptions styleOptions)
تعيين بعض خيارات التصميم لواجهة مستخدم التنقل.
void
setTrafficIncidentCardsEnabled(تفعيل منطقية)
لتحديد ما إذا كان يجب عرض بطاقات حوادث المرور عندما ينقر المستخدم على رمز حادث المرور.
void
setTrafficPromptsEnabled(تفعيل منطقي)
يحدّد هذا الإعداد ما إذا كان يجب عرض مطالبات بشأن حركة المرور أم لا.

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

مقاولات عامة

عامة NavigationView (سياق السياق)

المَعلمات
سياق

public NavigationView (سياق السياق، عناصر AttributeSet attrs)

المَعلمات
سياق
attrs

public NavigationView (سياق السياق, AttributeSet attrs, int defStyleAttr)

المَعلمات
سياق
attrs
defStyleAttr

الطرق العامة

متاح للجميع الكاميرا getCamera ()

تعرض كائن الكاميرا الذي يمكن استخدامه لتغيير إطار العرض للخريطة. يجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

المرتجعات
  • كائن Camera المرتبط بطريقة العرض هذه

Public NavigationMap getMap ()

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

عامة إلغاء onConfigurationChanged (Configuration config)

المَعلمات
config

public إلغاء onCreate (Bundle savedInstanceState)

المَعلمات
savedInstanceState

عام إلغاء onDestroy ()

عامة إلغاء onPause ()

متاح للجميع لاغٍ onResume ()

public إلغاء onSaveInstanceState (Bundle outState)

المَعلمات
outState

عام فارغ onStart ()

عام إلغاء onStop ()

متاح للجميع إلغاء onTrimMemory (مستوى صحيح)

المَعلمات
المستوى

عامة إلغاء setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode قَوْلْInfoDisplayModeOverride)

تلغي هذه العلامة وضع العرض التلقائي لوسائل شرح الإعلان النصي الموسَّع أثناء التنقّل. يؤدي تمرير القيمة "فارغ" إلى إعادة ضبط وضع العرض التلقائي.

المَعلمات
calloutInfoDisplayModeOverride وضع العرض الجديد المطلوب.

عام إلغاء setCalloutInfoFormatOverride (RouteCalloutInfoFormat قَوْلْInfoFormatOverride)

لضبط وضع تنسيق معلومات وسائل الشرح لوسائل شرح المسار. في حال عدم استدعاء هذه الطريقة، ستتبع وسائل الشرح السلوك المحدّد في RouteCalloutInfoFormat.DEFAULT.

المَعلمات
calloutInfoFormatOverride شكل وسيلة الشرح الجديد المطلوب

عام إلغاء setCompassEnabled (boolean enabled)

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

المَعلمات
مفعّلة

عام إلغاء setCustomControl (عرض عنصر التحكّم، الموضع CustomControlPosition)

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

المَعلمات
تحكم عرض سيتم وضعه داخل واجهة مستخدم التنقل
الموضع يحدد مكان وضع عنصر التحكم المخصص في واجهة المستخدم بالنسبة إلى عناصر التحكم المضمنة.

public إلغاء setEtaCardEnabled (boolean enabled)

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

المَعلمات
مفعّلة

متاح للجميع إلغاء setForceNightMode (int NightMode)

لضبط ForceNightMode الحالية

المَعلمات
nightMode

public إلغاء setHeaderEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان رأس التنقّل باتّجاهات مفصّلة مرئيًا أثناء التنقّل. يجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

المَعلمات
مفعّلة

عامة إلغاء setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener مستمع)

لضبط مستمِع يتم إرسال إشعار إليه على الفور بحالة "الوضع الليلي" الحالية ومتى تدخل واجهة المستخدم في "الوضع الليلي" أو تخرج منها. ويجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

ملاحظة: لتجنُّب تسرُّب الذاكرة، يجب استدعاء setOnNightModeChangedListener(null) عندما لا يكون المستمع مطلوبًا.

المَعلمات
أداة معالجة الحدث مستمِع يتم إرسال إشعار إليه عند دخول واجهة المستخدم في الوضع الليلي أو الخروج منه

public باطلة setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener مستمع)

لضبط مستمع سيتم إرسال إشعار إليه عند النقر على زر إعادة التوسيط. يجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

ملاحظة: لتجنُّب تسرُّب الذاكرة، يجب استدعاء setOnRecenterButtonClickedListener(null) عندما لا يكون المستمع مطلوبًا.

المَعلمات
أداة معالجة الحدث المستمع الذي سيتم إرسال إشعار إليه عند النقر على زر إعادة التوسيط

متاح للجميع إلغاء setRecenterButtonEnabled (boolean enabled)

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

المَعلمات
مفعّلة

عامة إلغاء setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

تضبط هذه السياسة SpeedAlertOptions لتخصيص حدود التشغيل لـ SpeedAlertSeverity.

يمكنك استخدام هذه الطريقة لتخصيص حدود تشغيل تنبيه السرعة بالنسبة المئوية لكل من تنبيهَي MINOR وMAJOR. يمكنك أيضًا استخدام هذه الطريقة لضبط الوقت بالثواني اللازم لترقية تنبيهات السرعة من MINOR إلى MAJOR.

عند ضبط null SpeedAlertOptions أو عدم ضبطها، سيعرض تنبيه السرعة التلقائي الخاص بـ NavSDK: يعرض تنبيه السرعة نصًا أحمر بخلفية بيضاء/داكنة للوضع النهاري/الليلي على التوالي عندما تكون السرعة أقل من 5 ميل في الساعة أو 10 كم/ساعة عند تجاوز الحد الأقصى للسرعة، ويعرض نصًا أبيض في الخلفية الحمراء عند زيادة السرعة التي تزيد عن 5 ميل في الساعة أو 10 كم/ساعة.

المَعلمات
speedAlertOptions

متاح للجميع إلغاء setSpeedLimitIconEnabled (boolean enabled)

يحدِّد هذا الإعداد ما إذا كان سيتم عرض رمز حدّ السرعة. استدعِ هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

عند تفعيل هذه الميزة، يظهر رمز حدّ السرعة الذي يشير إلى حدّ سرعة الطريق في الزاوية السفلية من البداية أثناء التوجيه. لا يظهر الرمز إلا في المواقع الجغرافية التي تتوفّر فيها بيانات موثوقة عن حدود السرعة. عند ظهور رمز عدّاد السرعة، يتم إرفاقها.

في حال تفعيل زر إعادة التوسيط، يكون رمز حد السرعة مخفيًا مؤقتًا عند عرض زر إعادة الضبط.

ملاحظة: على السائقين اتّباع جميع اللافتات المنشورة على الطريق واستخدام رمز حدّ السرعة كمرجع فقط. لا يمكن ضمان دقة بيانات حد السرعة. يمكنك الإبلاغ عن عدم دقة في بيانات حدود السرعة من خلال تقديم طلب في بوابة دعم Google Cloud.

المَعلمات
مفعّلة

متاح للجميع إلغاء setSpeedometerIconEnabled (boolean enabled)

تحدِّد هذه السياسة ما إذا كان سيتم عرض رمز عدّاد السرعة. استدعِ هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

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

يؤدي تفعيل رمز مقياس السرعة إلى تفعيل رمز حدّ السرعة أيضًا بشكل كامل، ولكن يمكنك استخدام setSpeedLimitIconEnabled(boolean) لإيقاف أو تفعيل رمز حدّ السرعة بشكل منفصل.

إذا كان زر إعادة الضبط مفعّلاً، يكون رمز عدّاد السرعة مخفيًا مؤقتًا عند ظهور زر إعادة الضبط.

المَعلمات
مفعّلة

متاح للجميع فارغ setSpeedometerUiOptions (SpeedometerUiOptions عداد السرعةUiOptions)

تضبط هذه السياسة إعدادات واجهة المستخدم لعدّاد السرعة على SpeedometerUiOptions استنادًا إلى SpeedAlertSeverity. استدعِ هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

من خلال ضبط null SpeedometerUiOptions، يتم محو الإجراء السابق في حال ضبطه. في حال عدم ضبط أي SpeedometerUiOptions، يتم الرجوع إلى واجهة مستخدم عدّاد السرعة إلى إعدادات NavSDK التلقائية لتنبيهات السرعة لمختلف SpeedAlertSeverity:

  • تنبيه السرعة MINOR في وضع اليوم: نص أحمر في خلفية بيضاء
  • تنبيه السرعة من MINOR في الوضع الليلي: نص أحمر في خلفية داكنة
  • تنبيه السرعة MAJOR في وضع اليوم: نص أبيض في خلفية حمراء
  • تنبيه السرعة MAJOR في الوضع الليلي: نص أبيض في خلفية حمراء

المَعلمات
speedometerUiOptions

عامة إلغاء setStylingOptions (StylingOptions styleOptions)

تعيين بعض خيارات التصميم لواجهة مستخدم التنقل. ويجب طلب هذه الطريقة فقط في سلسلة محادثات واجهة المستخدم.

المَعلمات
stylingOptions

public إلغاء setTrafficIncidentCardsEnabled (boolean enabled)

لتحديد ما إذا كان يجب عرض بطاقات حوادث المرور عندما ينقر المستخدم على رمز حادث المرور. يجب طلب هذه الطريقة فقط في سلسلة واجهة المستخدم.

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

المَعلمات
مفعّلة

عامة إلغاء setTrafficPromptsEnabled (boolean enabled)

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

المَعلمات
مفعّلة