نقطة الدخول إلى واجهة برمجة تطبيقات التنقّل استخدِم الطرق الثابتة في هذه الفئة للحصول على مرجع
إلى Navigator
.
ملخص الفئة المدمَجة
@interface | NavigationApi.ErrorCode | رمز الخطأ هو رمز حالة يعرضه getNavigator(Activity, NavigatorListener)
وgetNavigator(Application, NavigatorListener) عندما يتعذّر الحصول على
Navigator بنجاح. |
|
واحدة | NavigationApi.NavigatorListener | عليك تسجيل NavigatorListener لدى getNavigator(Activity, NavigatorListener) ليتم
إعلامك بحالة Navigator المذكورة. |
|
واحدة | NavigationApi.OnTermsResponseListener | سجِّل OnTermsResponseListener لدى "showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) " لتلقّي إشعار عند قبول المستخدم للأحكام والشروط أو رفضها. |
ملخّص الطريقة العلنية
قيمة منطقية ثابتة |
areTermsAccepted(تقديم طلب الانضمام إلى البرنامج)
تعرض
true إذا سبق للمستخدم قبول أحكام وشروط التنقّل في Google. |
قيمة فارغة |
cleanup()
تنظِّف الحالة الداخلية لمكوّنات NavSDK.
|
متزامن ثابت ForegroundServiceManager |
getForegroundServiceManager(تطبيق التطبيق)
يمكن الحصول على مثيل
ForegroundServiceManager المفرد. |
ثابتة سلسلة |
getNavSDKVersion()
تعرض إصدار NavSDK الحالي.
|
قيمة فارغة |
getNavigator(تطبيق التطبيق، معاودة الاتصال NavigationApi.NavigatorListener)
يمكن الحصول على مثيل
Navigator . |
قيمة فارغة |
getNavigator(نشاط النشاط، معاودة الاتصال NavigationApi.NavigatorListener و TermsAndConditionsCheckOption termsCheck)
يمكن الحصول على مثيل
Navigator . |
قيمة فارغة |
getNavigator(نشاط النشاط، معاودة الاتصال NavigationApi.NavigatorListener)
هذا الرمز مكافئ للرمز
getNavigator(activity, callback, {@link
TermsAndConditionsCheckOption#ENABLED} . |
قيمة فارغة |
getNavigatorNoToS(تطبيق التطبيق، معاودة الاتصال NavigationApi.NavigatorListener)
يمكن الحصول على مثيل
Navigator . |
ثابت RoadSnappedLocationProvider |
getRoadSnappedLocationProvider(تطبيق التطبيق)
يمكن الحصول على مثيل من
RoadSnappedLocationProvider يمكن استخدامه للاشتراك
في المواقع الجغرافية للمستخدمين التي تم التقاط صور لها على الطريق. |
ثابت NavigationTransactionRecorder |
getTransactionRecorder(تطبيق التطبيق)
الحصول على مثيل من
NavigationTransactionRecorder يمكن استخدامه لتسجيل
المعاملات ذات الصلة بالتنقل |
متزامن ثابت فارغ |
initForegroundServiceManager(تطبيق التطبيق، معرِّف عدد صحيح، معرِّف السلسلة التلقائي، مزوّد NotificationContentProvider)
لتهيئة النسخة الافتراضية
ForegroundServiceManager مع الوسيطات المقدمة. |
قيمة فارغة |
resetTermsAccepted(طلب الانضمام إلى التطبيق)
إعادة ضبط الأحكام والشروط للاختبار.
|
قيمة فارغة |
showTermsAndConditionsDialog(نشاط النشاط، اسم شركة السلسلة، عنوان السلسلة، أداة معالجة البيانات NavigationApi.OnTermsResponseListener)
تعرض مربع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google،
باستخدام الشكل والأسلوب التلقائيَين.
|
قيمة فارغة |
showTermsAndConditionsDialog(نشاط النشاط، اسم الشركة ذات السلسلة، عنوان السلسلة، TermsAndConditionsUIParams uiParams، وNavigationApi.OnTermsResponseListener، ومستمع TermsAndConditionsCheckOption termsAndConditionsCheckOption)
تعرض مربّع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google.
|
قيمة فارغة |
showTermsAndConditionsDialog(نشاط النشاط، اسم الشركة الأصلية، NavigationApi.OnTermsResponseListener)
تعرض مربّع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google،
باستخدام العنوان التلقائي والشكل والأسلوب التلقائيَين.
|
ملخّص الطريقة المكتسبة
الطرق العامة
عامة ثابتة منطقية areTermsAccepted (طلب الانضمام إلى البرنامج)
تعرض true
إذا سبق للمستخدم قبول أحكام وشروط التنقّل في Google.
ويمكنك استخدام هذه الطريقة لمعرفة ما إذا كان يجب عرض شاشة العبارات في وقت مبكر في التطبيق، بدلاً من عرضها عندما يكون المستخدم على وشك الانتقال إلى مكان ما. على سبيل المثال، قد يكون من المناسب التحقق من هذه القيمة عندما يعرض تطبيقك أحكامًا وشروطًا أخرى، وذلك كي يتمكن المستخدم من قبول جميع الأحكام والشروط المطلوبة للتطبيق في مهمة واحدة.
المَعلمات
التطبيق | التطبيق الحالي |
---|
المرتجعات
true
إذا قبل المستخدم البنود، وfalse
بخلاف ذلك
عامة ثابتة إلغاء تنظيف ()
تنظِّف الحالة الداخلية لمكوّنات NavSDK. في حال وجود مستكشف حالي، يتم إيقاف الإرشادات وإيقافها. لا يمكن إجراء أي طلبات في المستقبل للحصول على إرشادات من هذا المستكشف. وعليك باستدعاء هذه الطريقة لاسترداد الذاكرة إذا لم يعُد تطبيقك يتطلب Navigator وكان تطبيقك قد دمّر جميع الإشارات إلى Navigator. إذا كان تطبيقك يتطلب Navigator بعد هذه المكالمة، يمكنك استخدام getNavigator() لإنشاء واحد جديد. ملاحظة: يستغرق إنشاء برنامج مستكشف جديد بعض الوقت، ولكن عليك مراعاة كيفية تأثير التأخير في أداء تطبيقك وفي مزايا الذاكرة التي يتم استردادها.
عامة ثابتة تمت مزامنتها ForegroundServiceManager getForegroundServiceManager (تطبيق التطبيق)
يمكن الحصول على مثيل ForegroundServiceManager
المفرد. إذا لم يتم استدعاء initForegroundServiceManager(Application, Integer, String, NotificationContentProvider)
قبل getForegroundServiceManager(Application)
، سيتم
استخدام معرّف الإشعار التلقائي والرسالة والإشعارات.
المَعلمات
التطبيق | قيمة Application الحالية
|
---|
public static سلسلة getNavSDKVersion ()
تعرض إصدار NavSDK الحالي.
public static إلغاء getNavigator (طلب معاودة الاتصال بتطبيق التطبيق NavigationApi.NavigatorListener)
يمكن الحصول على مثيل Navigator
.
إذا لم يوافق المستخدم على الأحكام والشروط بعد، سيتم تنشيط معاودة الاتصال على الفور
مع عرض رمز الخطأ TERMS_NOT_ACCEPTED
.
يُرجى العِلم أنّ Navigator هي عملية فردية من نوع واحد، وإذا استدعيت هذه الطريقة عدة مرات، ستعرض كل عملية طلب أداة المستكشف نفسها.
المَعلمات
التطبيق | قيمة Application الحالية |
---|---|
رد الاتصال | معاودة الاتصال التي سيتم تنشيطها عندما تكون Navigator جاهزة أو عند حدوث خطأ
|
public static باطلة getNavigator (نشاط النشاط، ومعاودة الاتصال NavigationApi.NavigatorListener، وTermsAndConditionsCheckOption التحقّق من البنود)
يمكن الحصول على مثيل Navigator
.
إذا لم يوافق المستخدم على الأحكام والشروط بعد، ستعرض المكالمة مربّع حوار يحث المستخدم على الالتزام باللوائح المحلية.
إذا كان termsCheck
هو ENABLED
، سيحتوي مربع الحوار أيضًا على رابط إلى الأحكام والشروط لحزمة تطوير البرامج (SDK) للتنقل. وسيتم استدعاء callback
مع عرض الخطأ TERMS_NOT_ACCEPTED
إذا لم يوافق المستخدم على هذه
الأحكام.
يُرجى العِلم أنّ Navigator هي عملية فردية من نوع واحد، وإذا استدعيت هذه الطريقة عدة مرات، ستعرض كل عملية طلب أداة المستكشف نفسها.
public static إلغاء getNavigator (نشاط نشاط، معاودة الاتصال بـ NavigationApi.NavigatorListener)
هذا الرمز مكافئ للرمز getNavigator(activity, callback, {@link
TermsAndConditionsCheckOption#ENABLED}
.
المَعلمات
النشاط | |
---|---|
رد الاتصال |
public static إلغاء getNavigatorNoToS (طلب استدعاء التطبيق NavigationApi.NavigatorListener)
يمكن الحصول على مثيل Navigator
.
يتجاوز الأحكام والشروط.
يُرجى العِلم أنّ Navigator هي عملية فردية من نوع واحد، وإذا استدعيت هذه الطريقة عدة مرات، ستعرض كل عملية طلب أداة المستكشف نفسها.
المَعلمات
التطبيق | قيمة Application الحالية. |
---|---|
رد الاتصال | معاودة الاتصال التي سيتم تنشيطها عندما تكون Navigator جاهزة أو عند حدوث خطأ.
|
public static RoadSnappedLocationProvider getRoadSnappedLocationProvider (تطبيق التطبيق)
يمكن الحصول على مثيل من RoadSnappedLocationProvider
يمكن استخدامه للاشتراك
في المواقع الجغرافية للمستخدمين التي تم التقاط صور لها على الطريق. وتجدُر الإشارة إلى أنّ الاشتراك في تحديثات الموقع الجغرافي التي تم التقاطها على الطريق قد يتسبّب في استنزاف البطارية أو جمع بيانات الموقع الجغرافي للمستخدم بشكل غير مقصود في حال تركها قيد التشغيل في الخلفية.
يجب الحصول على Navigator
بنجاح قبل استدعاء هذه الطريقة، وإلا سيتم عرض null
.
المَعلمات
التطبيق | قيمة Application الحالية
|
---|
public static NavigationTransactionRecorder getTransactionRecorder (تطبيق التطبيق)
الحصول على مثيل من NavigationTransactionRecorder
يمكن استخدامه لتسجيل
المعاملات ذات الصلة بالتنقل
يجب استخدام هذه الفئة فقط إذا كانت Google تحصّل رسوم شركتك من خلال كل معاملة.
يجب الحصول على Navigator
بنجاح قبل استدعاء هذه الطريقة، وإلا سيتم عرض null
.
المَعلمات
التطبيق | قيمة Application الحالية
|
---|
عامة ثابتة إلغاء متزامنة initForegroundServiceManager (تطبيق التطبيق، معرّف الإشعار الصحيح، القيمة التلقائية للسلسلة، موفِّر خدمة NotificationContentProvider)
لتهيئة النسخة الافتراضية ForegroundServiceManager
مع الوسيطات المقدمة.
ويجب طلب هذا الإجراء فقط إذا أردت تعديل أيّ من المَعلمات التلقائية. وبخلاف ذلك،
يمكنك الاتصال بـ "getForegroundServiceManager(Application)
" مباشرةً. يمكن طلب هذه الطريقة مرة واحدة فقط
ويجب طلبها قبل getForegroundServiceManager(Application)
.
المَعلمات
التطبيق | قيمة Application الحالية |
---|---|
notificationId | رقم تعريف الإشعار للإشعار الدائم |
defaultMessage | الرسالة التلقائية التي سيتم عرضها إذا لم يتم تحديد provider |
provider | تنفيذ NotificationContentProvider
|
متاح للجميع ثابت لاغٍ resetTermsAccepted (طلب الانضمام إلى البرنامج)
إعادة ضبط الأحكام والشروط للاختبار. يُرجى إضافة مكالمة إلى هذا المستخدم قبل أيّ مكالمات إلى NavigationApi
إذا أردت اختبار مربّع حوار الأحكام والشروط.
المَعلمات
التطبيق | التطبيق الحالي |
---|
public static void showTermsAndConditionsDialog (نشاط النشاط، اسم الشركة المصنّعة، عنوان السلسلة، أداة معالجة البيانات NavigationApi.OnTermsResponseListener)
تعرض مربع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google، باستخدام الشكل والأسلوب التلقائيَين.
المَعلمات
النشاط | |
---|---|
companyName | |
العنوان | |
أداة معالجة الحدث |
راجِع أيضًا
public static void showTermsAndConditionsDialog (النشاط، String companyName، String title، TermsAndConditionsUIParams uiParams، NavigationApi.OnTermsResponseListener مستمع، TermsAndConditionsCheckOption termsAnd3ConditionsCheckOption){/1
تعرض مربّع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google. في حال تحديد ذلك، سيتم استدعاء المستمع في سلسلة محادثات واجهة المستخدم، للإشارة إلى ما إذا كان المستخدم سيقبل الأحكام والشروط.
تجدر الإشارة إلى أنّ مربّع الحوار سيظهر حتى إذا وافق المستخدم في السابق. ويجب طلب هذا الإجراء فقط إذا كانت قيمة السمة areTermsAccepted(Application)
هي false
، لأنّه من غير الممكن أن يرفض المستخدم الأحكام والشروط.
المَعلمات
النشاط | Activity الذي سيظهر عليه مربّع الحوار |
---|---|
companyName | اسم شركتك الذي سيظهر في مربّع حوار الأحكام والشروط |
العنوان | عنوان مربع الحوار. إذا كانت فارغة، سيستخدم مربّع الحوار العنوان التلقائي. |
uiParams | المعلمات المستخدمة لتخصيص شكل ومظهر مربع الحوار. وإذا كانت قيمة هذه السمة فارغة، يتم استخدام المظهر والأسلوب التلقائيَين. |
أداة معالجة الحدث | معاودة الاتصال الاختيارية التي سيتم تنشيطها عندما يقبل المستخدم الأحكام والشروط أو يرفضها |
termsAndConditionsCheckOption | TermsAndConditionsCheckOption التي تحدّد
خيارات التحقّق من الأحكام والشروط
|
public static باطلة showTermsAndConditionsDialog (نشاط النشاط، وسلسلة اسم الشركة، وNavigationApi.OnTermsResponseListener)
تعرض مربّع حوار يوجّه المستخدم إلى قبول أحكام وشروط التنقّل في Google، باستخدام العنوان التلقائي والشكل والأسلوب التلقائيَين.
المَعلمات
النشاط | |
---|---|
companyName | |
أداة معالجة الحدث |