Khởi chạy SDK người tiêu dùng

Trước khi bắt đầu các quy trình này, hãy đảm bảo bạn đã bật các dịch vụ thích hợp và SDK Người tiêu dùng như mô tả trong các phần trước.

Để khởi chạy SDK Người tiêu dùng, hãy làm theo các bước sau:

1. Lấy thực thể ConsumerAPI
2. Khởi chạy SDK Maps để yêu cầu trình kết xuất ưu tiên

Lấy thực thể ConsumerApi

Để sử dụng SDK Người tiêu dùng, ứng dụng của bạn cần khởi chạy singleton ConsumerApi không đồng bộ. Phương thức khởi chạy sẽ lấy lớp AuthTokenFactory để tạo mã thông báo JWT mới cho người dùng khi cần.

providerId là Mã dự án của dự án trên Google Cloud. Để biết thêm thông tin về cách tạo dự án Fleet Engine, hãy xem phần Tạo dự án Fleet Engine trong hướng dẫn về Fleet Engine.

Ứng dụng của bạn phải triển khai AuthTokenFactory như mô tả trong phần Xác thực SDK người dùng.

Task<ConsumerApi> consumerApiTask = ConsumerApi.initialize(
    this, "myProviderId", authTokenFactory);

consumerApiTask.addOnSuccessListener(
  consumerApi -> this.consumerApi = consumerApi);

val consumerApiTask =
  ConsumerApi.initialize(this, "myProviderId", authTokenFactory)

consumerApiTask?.addOnSuccessListener { consumerApi: ConsumerApi ->
  this@YourActivity.consumerApi = consumerApi
}

SDK Maps và trình kết xuất bản đồ

SDK Người tiêu dùng phiên bản 2.0.0 trở lên hỗ trợ SDK Maps cho Android phiên bản 18.1.0 trở lên. Bảng sau đây tóm tắt trình kết xuất mặc định theo phiên bản SDK Maps và khả năng hỗ trợ của cả hai trình kết xuất. Nếu có thể, hãy sử dụng trình kết xuất mới nhất. Nếu bạn phải sử dụng trình kết xuất cũ, hãy chỉ định rõ ràng bằng cách sử dụng MapsInitializer.initialize().

* Khi Trình kết xuất Maps mới ra mắt, Trình kết xuất mới nhất sẽ là trình kết xuất mặc định.

Nếu bạn phải sử dụng trình kết xuất ưu tiên, hãy chạy tất cả các thao tác kết xuất giao diện người dùng sau khi OnMapsSdkInitializedCallback trả về kết quả. Các thao tác kết xuất giao diện người dùng bao gồm:

• Tăng cường một khung hiển thị chứa GoogleMapView hoặc ConsumerMapView.

• Đang đặt điểm đánh dấu trên ConsumerMapView.

Nếu bạn không chạy các thao tác này sau khi nhận được kết quả OnMapsSdkInitializedCallback, thì SDK Bản đồ sẽ không phân bổ trình kết xuất mà bạn ưu tiên và chế độ xem bản đồ sẽ được kết xuất bằng trình kết xuất mặc định.

Khởi chạy SDK Maps trước khi khởi chạy SDK Người tiêu dùng

1. Trong lớp Application hoặc lớp khởi động Activity, hãy gọi MapsInitializer.initialize()

2. Chờ kết quả yêu cầu của trình kết xuất trước khi khởi chạy SDK Người tiêu dùng.

Hãy xem các ví dụ sau để biết thông tin chi tiết.

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.main);
  initViews();

  MapsInitializer.initialize(getApplicationContext(), Renderer.LATEST,
      new OnMapsSdkInitializedCallback() {
        @Override
        public void onMapsSdkInitialized(Renderer renderer) {
          switch (renderer) {
            case LATEST:
              Log.i("maps_renderer", "LATEST renderer");
              break;
            case LEGACY:
              Log.i("maps_renderer", "LEGACY renderer");
              break;
          }

          initializeConsumerSdk();
        }
      });
}

fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)
  initViews()

  MapsInitializer.initialize(
    getApplicationContext(), Renderer.LATEST,
    object : OnMapsSdkInitializedCallback() {
      fun onMapsSdkInitialized(renderer: Renderer?) {
        when (renderer) {
          LATEST -> Log.i("maps_renderer", "LATEST renderer")
          LEGACY -> Log.i("maps_renderer", "LEGACY renderer")
        }
        initializeConsumerSdk()
      }
    })
  }

Lưu ý về SSL/TLS

Trong nội bộ, việc triển khai SDK Người tiêu dùng sử dụng SSL/TLS để giao tiếp an toàn với dịch vụ Fleet Engine. Các phiên bản API Android 23 trở xuống có thể yêu cầu bản vá SecurityProvider để giao tiếp với máy chủ. Để biết thêm thông tin về cách làm việc với SSL trong Android, hãy xem bài viết Nhà cung cấp GMS bảo mật. Bài viết này cũng có các mã mẫu để vá nhà cung cấp dịch vụ bảo mật.

Bước tiếp theo

Thiết lập bản đồ