จุดแรกเข้าไปยัง Navigation API ใช้วิธีการแบบคงที่ในคลาสนี้เพื่อรับการอ้างอิงไปยัง Navigator
สรุปข้อมูลชั้นเรียนที่ซ้อนกัน
@อินเทอร์เฟซ | NavigationApi.ErrorCode | 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 ไว้ก่อนหน้านี้ |
คงที่ เป็นโมฆะ |
ล้าง()
ล้างข้อมูลสถานะภายในของคอมโพเนนต์ NavSDK
|
ซิงค์แล้ว static ForegroundServiceManager |
getForegroundServiceManager(แอปพลิเคชันแอปพลิเคชัน)
รับอินสแตนซ์
ForegroundServiceManager เดี่ยว |
static สตริง |
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 |
static RoadSnappedLocationProvider |
getRoadSnappedLocationProvider(แอปพลิเคชันแอปพลิเคชัน)
รับอินสแตนซ์ของ
RoadSnappedLocationProvider ซึ่งสามารถใช้เพื่อสมัครใช้บริการตำแหน่งของผู้ใช้ที่ถูกสแนปถนนได้ |
แบบคงที่ NavigationTransactionRecorder |
getTransactionRecorder(แอปพลิเคชันแอปพลิเคชัน)
รับอินสแตนซ์ของ
NavigationTransactionRecorder ซึ่งสามารถใช้เพื่อบันทึกธุรกรรมที่เกี่ยวข้องกับการนำทาง |
ทำให้ข้อมูลตรงกันแล้ว คงที่ โมฆะ |
initForegroundServiceManager(แอปพลิเคชันแอปพลิเคชัน, รหัสการแจ้งเตือนจำนวนเต็ม, String defaultMessage, ผู้ให้บริการ NotificationContentProvider)
เริ่มต้นอินสแตนซ์
ForegroundServiceManager ด้วยอาร์กิวเมนต์ที่ระบุ |
คงที่ เป็นโมฆะ |
resetTermsAccepted(ใบสมัครแอปพลิเคชัน)
รีเซ็ตข้อกำหนดในการให้บริการ - สำหรับการทดสอบ
|
คงที่ เป็นโมฆะ |
showTermsAndConditionsDialog(กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, Listener NavigationApi.OnTermsResponseListener)
แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขของการนำทางของ Google โดยใช้รูปลักษณ์เริ่มต้น
|
คงที่ เป็นโมฆะ |
showTermsAndConditionsDialog(กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, uiParams TermsAndConditionsUIParams, NavigationApi.OnTermsResponseListener, TermsAndConditionsCheckOptiontermsAndConditionsCheckOption)
แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดในการให้บริการของการนำทางของ Google
|
คงที่ เป็นโมฆะ |
showTermsAndConditionsDialog(กิจกรรมกิจกรรม, String companyName, Listener NavigationApi.OnTermsResponseListener)
แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขของการนำทางของ Google โดยใช้ชื่อเริ่มต้นและรูปลักษณ์เริ่มต้น
|
ข้อมูลสรุปของเมธอดที่รับช่วงมา
วิธีการสาธารณะ
สาธารณะ คงที่ บูลีน areTermsAccepted (แอปพลิเคชันแอปพลิเคชัน)
แสดงผล true
หากผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขสำหรับการนำทางของ Google ไว้ก่อนหน้านี้
คุณใช้การตั้งค่านี้เพื่อตรวจสอบได้ว่าคุณควรแสดงหน้าจอคำศัพท์ไว้ก่อนหน้าในแอปพลิเคชันหรือไม่ แทนการแสดงเมื่อผู้ใช้กำลังจะไปยังที่ใดที่หนึ่ง เช่น ควรตรวจสอบค่านี้เมื่อแอปแสดงข้อกำหนดและเงื่อนไขอื่นๆ เพื่อให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขที่จำเป็นทั้งหมดสำหรับแอปได้งานเดียว
พารามิเตอร์
แอปพลิเคชัน | แอปพลิเคชันปัจจุบัน |
---|
คิกรีเทิร์น
true
หากผู้ใช้ยอมรับข้อกำหนดแล้ว และfalse
สาธารณะ คงที่ โมฆะ ล้าง ()
ล้างข้อมูลสถานะภายในของคอมโพเนนต์ NavSDK หากมีตัวนำทางปัจจุบันอยู่ การนำทางจะหยุดและปิดใช้ การนำทางนี้ไม่สามารถขอคำแนะนำได้อีกในอนาคต เรียกใช้เมธอดนี้เพื่อกู้คืนหน่วยความจำเมื่อแอปของคุณไม่ต้องใช้ Navigator แล้ว และแอปได้ทำลายการอ้างอิงไปยัง Navigator ทั้งหมดแล้ว หากแอปของคุณต้องใช้ Navigator หลังจากการเรียกนี้ ให้ใช้ getNavigator() เพื่อสร้างใหม่ หมายเหตุ: การสร้างการนำทางใหม่ต้องใช้เวลา ลองพิจารณาว่าความล่าช้าจะส่งผลต่อประสิทธิภาพของแอปอย่างไรเมื่อเทียบกับประโยชน์ของหน่วยความจำที่กู้คืน
สาธารณะ คงที่ ซิงค์ ForegroundServiceManager getForegroundServiceManager (แอปพลิเคชันแอปพลิเคชัน)
รับอินสแตนซ์ ForegroundServiceManager
เดี่ยว หากไม่มีการเรียกใช้ initForegroundServiceManager(Application, Integer, String, NotificationContentProvider)
ก่อน getForegroundServiceManager(Application)
ระบบจะใช้รหัสการแจ้งเตือนเริ่มต้น ข้อความ และผู้ให้บริการการแจ้งเตือน
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน
|
---|
สาธารณะ คงที่ สตริง getNavSDKVersion ()
แสดงผล NavSDK เวอร์ชันปัจจุบัน
สาธารณะ คงที่ void getNavigator (แอปพลิเคชันแอปพลิเคชัน, โค้ดเรียกกลับ NavigationApi.NavigatorListener)
รับอินสแตนซ์ Navigator
หากผู้ใช้ยังไม่ได้ยอมรับข้อกำหนดและเงื่อนไข โค้ดเรียกกลับจะเริ่มทำงานทันทีพร้อมรหัสข้อผิดพลาด TERMS_NOT_ACCEPTED
โปรดทราบว่า Navigator เป็น Singleton หากคุณเรียกใช้เมธอดนี้หลายครั้ง การเรียกแต่ละครั้งจะแสดง Navigator เดียวกัน
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน |
---|---|
โค้ดเรียกกลับ | โค้ดเรียกกลับที่จะเริ่มทำงานเมื่อ Navigator พร้อมใช้งาน หรือเกิดข้อผิดพลาด
|
สาธารณะ คงที่ void getNavigator (กิจกรรมกิจกรรม, โค้ดเรียกกลับ NavigationApi.NavigatorListener, TermsAndConditionsCheckOption TermsCheck)
รับอินสแตนซ์ Navigator
หากผู้ใช้ยังไม่ได้ยอมรับข้อกำหนดและเงื่อนไข การโทรนี้จะแสดงกล่องโต้ตอบที่ขอให้ผู้ใช้ปฏิบัติตามกฎระเบียบท้องถิ่น
หาก termsCheck
คือ ENABLED
กล่องโต้ตอบจะมีลิงก์ไปยังข้อกำหนดและเงื่อนไขของ Navigation SDK ด้วย ระบบจะเรียกใช้ callback
โดยมีข้อผิดพลาด TERMS_NOT_ACCEPTED
หากผู้ใช้ยอมรับข้อกำหนดเหล่านี้
โปรดทราบว่า Navigator เป็น Singleton หากคุณเรียกใช้เมธอดนี้หลายครั้ง การเรียกแต่ละครั้งจะแสดง Navigator เดียวกัน
สาธารณะ static void getNavigator (กิจกรรมกิจกรรม, NavigationApi.NavigatorListener โค้ดเรียกกลับ)
เทียบเท่ากับ getNavigator(activity, callback, {@link
TermsAndConditionsCheckOption#ENABLED}
พารามิเตอร์
กิจกรรม | |
---|---|
โค้ดเรียกกลับ |
สาธารณะ คงที่ void getNavigatorNoToS (แอปพลิเคชันแอปพลิเคชัน, โค้ดเรียกกลับ NavigationApi.NavigatorListener)
รับอินสแตนซ์ Navigator
ไม่เป็นไปตามข้อกำหนดและเงื่อนไข
โปรดทราบว่า Navigator เป็น Singleton หากคุณเรียกใช้เมธอดนี้หลายครั้ง การเรียกแต่ละครั้งจะแสดง Navigator เดียวกัน
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน |
---|---|
โค้ดเรียกกลับ | โค้ดเรียกกลับซึ่งจะเริ่มทำงานเมื่อ Navigator พร้อมใช้งาน หรือเกิดข้อผิดพลาด
|
สาธารณะ static RoadSnappedLocationProvider getRoadSnappedLocationProvider (แอปพลิเคชันแอปพลิเคชัน)
รับอินสแตนซ์ของ RoadSnappedLocationProvider
ซึ่งสามารถใช้เพื่อสมัครใช้บริการตำแหน่งของผู้ใช้ที่ถูกสแนปถนนได้ โปรดทราบว่าการสมัครรับข้อมูลการอัปเดตตำแหน่งที่ตัดถนนอาจทำให้แบตเตอรี่หมดหรือเก็บรวบรวมข้อมูลตำแหน่งของผู้ใช้โดยไม่ได้ตั้งใจหากปล่อยให้ทำงานในพื้นหลัง
ต้องได้รับ Navigator
ก่อนเรียกใช้เมธอดนี้ มิฉะนั้นจะแสดงผลเป็น null
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน
|
---|
สาธารณะ static NavigationTransactionRecorder getTransactionRecorder (แอปพลิเคชัน)
รับอินสแตนซ์ของ NavigationTransactionRecorder
ซึ่งสามารถใช้เพื่อบันทึกธุรกรรมที่เกี่ยวข้องกับการนำทาง
ควรใช้คลาสนี้ในกรณีที่ Google เรียกเก็บเงินจากบริษัทของคุณแบบ ต่อธุรกรรมเท่านั้น
ต้องได้รับ Navigator
ก่อนเรียกใช้เมธอดนี้ มิฉะนั้นจะแสดงผลเป็น null
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน
|
---|
Public static ซิงโครไนซ์ void initForegroundServiceManager (แอปพลิเคชันแอปพลิเคชัน, รหัสการแจ้งเตือนจำนวนเต็ม, String defaultMessage, ผู้ให้บริการ NotificationContentProvider)
เริ่มต้นอินสแตนซ์ ForegroundServiceManager
ด้วยอาร์กิวเมนต์ที่ระบุ
ระบบจะเรียกค่านี้เมื่อต้องการแก้ไขพารามิเตอร์เริ่มต้นเท่านั้น หรือโทรไปที่ getForegroundServiceManager(Application)
โดยตรง ระบบจะเรียกใช้เมธอดนี้ได้เพียงครั้งเดียวเท่านั้นและต้องเรียกใช้ก่อนวันที่ getForegroundServiceManager(Application)
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน |
---|---|
notificationId | รหัสการแจ้งเตือนสำหรับการแจ้งเตือนถาวร |
defaultMessage | ข้อความเริ่มต้นที่จะแสดงหากไม่ได้ระบุ provider |
ผู้ให้บริการ | การใช้งาน NotificationContentProvider
|
สาธารณะ static void resetTermsAccepted (แอปพลิเคชันแอปพลิเคชัน)
รีเซ็ตข้อกำหนดในการให้บริการ - สำหรับการทดสอบ เพิ่มการเรียกใช้นี้ก่อนที่จะเรียกไปยัง NavigationApi
หากคุณต้องการทดสอบกล่องโต้ตอบข้อกำหนดและเงื่อนไข
พารามิเตอร์
แอปพลิเคชัน | แอปพลิเคชันปัจจุบัน |
---|
สาธารณะ static void showTermsAndConditionsDialog (กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, NavigationApi.OnTermsResponseListener Listener)
แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขของการนำทางของ Google โดยใช้รูปลักษณ์เริ่มต้น
พารามิเตอร์
กิจกรรม | |
---|---|
companyName | |
title | |
Listener |
ดูเพิ่มเติม
สาธารณะ คงที่ void showTermsAndConditionsDialog (กิจกรรมกิจกรรม, String companyName, ชื่อสตริง, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListenerListener, TermsAndConditionsCheckOption TermsAndConditionsCheckOption){/13
แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดในการให้บริการของการนำทางของ Google หากระบุไว้ ระบบจะเรียกใช้ Listener ในเทรด UI โดยระบุว่าผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขหรือไม่
โปรดทราบว่ากล่องโต้ตอบจะปรากฏขึ้นแม้ว่าผู้ใช้จะเคยยอมรับแล้วก็ตาม ควรเรียกใช้ URL นี้หาก areTermsAccepted(Application)
คือ false
เท่านั้น เนื่องจากผู้ใช้จะไม่ยอมรับข้อกําหนดและเงื่อนไขไม่ได้
พารามิเตอร์
กิจกรรม | Activity ที่กล่องโต้ตอบจะปรากฏขึ้น |
---|---|
companyName | ชื่อบริษัทของคุณ ซึ่งจะแสดงในกล่องโต้ตอบข้อกำหนดและเงื่อนไข |
title | ชื่อของกล่องโต้ตอบ หาก Null กล่องโต้ตอบจะใช้ชื่อเริ่มต้น |
uiParams | พารามิเตอร์ที่ใช้เพื่อปรับแต่งรูปลักษณ์ของกล่องโต้ตอบ หาก Null ระบบจะใช้รูปลักษณ์เริ่มต้น |
Listener | โค้ดเรียกกลับซึ่งไม่บังคับซึ่งจะเริ่มทำงานเมื่อผู้ใช้ยอมรับหรือปฏิเสธข้อกำหนดและเงื่อนไข |
termsAndConditionsCheckOption | TermsAndConditionsCheckOption ซึ่งระบุตัวเลือกสำหรับตรวจสอบข้อกำหนดและเงื่อนไข
|
สาธารณะ static void showTermsAndConditionsDialog (กิจกรรมกิจกรรม, String companyName, NavigationApi.OnTermsResponseListenerสู่Listener)
แสดงกล่องโต้ตอบที่ให้ผู้ใช้ยอมรับข้อกำหนดและเงื่อนไขของการนำทางของ Google โดยใช้ชื่อเริ่มต้นและรูปลักษณ์เริ่มต้น
พารามิเตอร์
กิจกรรม | |
---|---|
companyName | |
Listener |