Khi muốn gọi đến một trong các API trong SDK do Dịch vụ Google Play cung cấp, chẳng hạn như Đăng nhập bằng Google hoặc Bộ máy học, trước tiên, bạn cần tạo một bản sao của đối tượng ứng dụng API. Các đối tượng này tự động quản lý kết nối với Dịch vụ Google Play. Khi có kết nối, mỗi đối tượng ứng dụng API sẽ thực thi các yêu cầu theo thứ tự. Nếu không, đối tượng ứng dụng khách sẽ đưa các yêu cầu vào hàng đợi. Trừ khi tài liệu cho biết khác, các đối tượng ứng dụng khách ở mức giá rẻ sẽ được xây dựng; bạn có thể tạo các ứng dụng khách API mới mỗi khi muốn gọi các phương thức API.
Hướng dẫn này cho biết cách bạn có thể thực hiện lệnh gọi API đến bất kỳ SDK nào do Dịch vụ Google Play cung cấp, bao gồm cả cách truy cập vào các dịch vụ không yêu cầu uỷ quyền và các dịch vụ yêu cầu uỷ quyền.
Bắt đầu
Để bắt đầu, hãy thêm các công cụ và phần phụ thuộc cần thiết vào dự án ứng dụng, như mô tả trong hướng dẫn về cách thiết lập Dịch vụ Google Play.
Truy cập khi không cần ủy quyền
Để truy cập một dịch vụ không yêu cầu uỷ quyền API, hãy lấy một bản sao của đối tượng ứng dụng của dịch vụ, chuyển đối tượng đó vào Context hiện tại hoặc Activity hiện tại.
Trước khi thực hiện bất kỳ lệnh gọi API nào, người dùng sẽ được nhắc nâng cấp Dịch vụ Google Play nếu cần.
Ví dụ: để lấy vị trí đã biết gần đây nhất của thiết bị bằng cách sử dụng Trình cung cấp vị trí kết hợp cho Android, hãy thêm logic được hiển thị trong đoạn mã sau:
Kotlin
// Code required for requesting location permissions omitted for brevity. val client = LocationServices.getFusedLocationProviderClient(this) // Get the last known location. In some rare situations, this can be null. client.lastLocation.addOnSuccessListener { location : Location? -> location?.let { // Logic to handle location object. } }
Java
// Code required for requesting location permissions omitted for brevity. FusedLocationProviderClient client = LocationServices.getFusedLocationProviderClient(this); // Get the last known location. In some rare situations, this can be null. client.getLastLocation() .addOnSuccessListener(this, location -> { if (location != null) { // Logic to handle location object. } });
Truy cập khi cần ủy quyền
Để truy cập một dịch vụ yêu cầu người dùng ủy quyền, hãy hoàn tất các bước sau:
- Đăng nhập người dùng.
- Yêu cầu quyền truy cập vào các phạm vi mà dịch vụ yêu cầu.
- Lấy thực thể của đối tượng ứng dụng dùng cho dịch vụ, truyền đối tượng đó vào đối tượng
GoogleSignInAccountcủa người dùng ngoài đối tượngContexthoặcActivity.
Ví dụ sau triển khai việc đọc các bước hằng ngày của người dùng bằng API Google Fit. Để xem cách triển khai tương tự trong bối cảnh của một dự án đầy đủ, vui lòng xem hoạt động chính của ứng dụng BasicHistoryApiKotlin trên GitHub.
Kotlin
class FitFragment : Fragment() {
private val fitnessOptions: FitnessOptions by lazy {
FitnessOptions.builder()
.addDataType(DataType.TYPE_STEP_COUNT_CUMULATIVE)
.addDataType(DataType.TYPE_STEP_COUNT_DELTA)
.build()
}
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
fitSignIn()
}
/*
* Checks whether the user is signed in. If so, executes the specified
* function. If the user is not signed in, initiates the sign-in flow,
* specifying the function to execute after the user signs in.
*/
private fun fitSignIn() {
if (oAuthPermissionsApproved()) {
readDailySteps()
} else {
GoogleSignIn.requestPermissions(
this,
SIGN_IN_REQUEST_CODE,
getGoogleAccount(),
fitnessOptions
)
}
}
private fun oAuthPermissionsApproved() =
GoogleSignIn.hasPermissions(getGoogleAccount(), fitnessOptions)
/*
* Gets a Google account for use in creating the fitness client. This is
* achieved by either using the last signed-in account, or if necessary,
* prompting the user to sign in. It's better to use the
* getAccountForExtension() method instead of the getLastSignedInAccount()
* method because the latter can return null if there has been no sign in
* before.
*/
private fun getGoogleAccount(): GoogleSignInAccount =
GoogleSignIn.getAccountForExtension(requireContext(), fitnessOptions)
/*
* Handles the callback from the OAuth sign in flow, executing the function
* after sign-in is complete.
*/
override fun onActivityResult(
requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
when (resultCode) {
RESULT_OK -> {
readDailySteps()
}
else -> {
// Handle error.
}
}
}
/*
* Reads the current daily step total.
*/
private fun readDailySteps() {
Fitness.getHistoryClient(requireContext(), getGoogleAccount())
.readDailyTotal(DataType.TYPE_STEP_COUNT_DELTA)
.addOnSuccessListener { dataSet ->
val total = when {
dataSet.isEmpty -> 0
else -> dataSet.dataPoints.first()
.getValue(Field.FIELD_STEPS).asInt()
}
Log.i(TAG, "Total steps: $total")
}
.addOnFailureListener { e ->
Log.w(TAG, "There was a problem getting the step count.", e)
}
}
companion object {
const val SIGN_IN_REQUEST_CODE = 1001
}
}
Java
public class FitFragment extends Fragment {
private final FitnessOptions fitnessOptions = FitnessOptions.builder()
.addDataType(DataType.TYPE_STEP_COUNT_CUMULATIVE)
.addDataType(DataType.TYPE_STEP_COUNT_DELTA)
.build();
@Override
public void onViewCreated(
@NotNull View view, @Nullable Bundle savedInstanceState) {
fitSignIn();
}
/*
* Checks whether the user is signed in. If so, executes the specified
* function. If the user is not signed in, initiates the sign-in flow,
* specifying the function to execute after the user signs in.
*/
private void fitSignIn() {
if (oAuthPermissionsApproved()) {
readDailySteps();
} else {
GoogleSignIn.requestPermissions(this, SIGN_IN_REQUEST_CODE,
getGoogleAccount(), fitnessOptions);
}
}
private boolean oAuthPermissionsApproved() {
return GoogleSignIn.hasPermissions(getGoogleAccount(), fitnessOptions);
}
/*
* Gets a Google account for use in creating the fitness client. This is
* achieved by either using the last signed-in account, or if necessary,
* prompting the user to sign in. It's better to use the
* getAccountForExtension() method instead of the getLastSignedInAccount()
* method because the latter can return null if there has been no sign in
* before.
*/
private GoogleSignInAccount getGoogleAccount() {
return GoogleSignIn.getAccountForExtension(
requireContext(), fitnessOptions);
}
/*
* Handles the callback from the OAuth sign in flow, executing the function
* after sign-in is complete.
*/
@Override
public void onActivityResult(
int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (resultCode == RESULT_OK) {
readDailySteps();
} else {
// Handle error.
}
}
/*
* Reads the current daily step total.
*/
private void readDailySteps() {
AtomicInteger total = new AtomicInteger();
Fitness.getHistoryClient(requireContext(), getGoogleAccount())
.readDailyTotal(DataType.TYPE_STEP_COUNT_DELTA)
.addOnSuccessListener(dataSet -> {
if (!dataSet.isEmpty())
total.set(Integer.parseInt(dataSet.getDataPoints()
.get(0).getValue(FIELD_STEPS).toString()));
Log.i(TAG, "Total steps: $total");
})
.addOnFailureListener(e -> {
Log.w(TAG, "There was a problem getting the step count.", e);
});
}
private static final int SIGN_IN_REQUEST_CODE = 1001;
}
Kiểm tra phạm vi cung cấp API
Trước khi bật một tính năng trong ứng dụng phụ thuộc vào API Dịch vụ Google Play, hãy kiểm tra tính khả dụng của API trên thiết bị. Để thực hiện việc này,
hãy gọi checkApiAvailability().
Đoạn mã sau đây minh hoạ cách kiểm tra khả năng cung cấp của trình cung cấp vị trí kết hợp.
Kotlin
fun getLastLocationIfApiAvailable(context: Context?): Task<Location>? {
val client = getFusedLocationProviderClient(context)
return GoogleApiAvailability.getInstance()
.checkApiAvailability(client)
.onSuccessTask { _ -> client.lastLocation }
.addOnFailureListener { _ -> Log.d(TAG, "Location unavailable.")}
}
Java
public Task<Location> getLastLocationIfApiAvailable(Context context) {
FusedLocationProviderClient client =
getFusedLocationProviderClient(context);
return GoogleApiAvailability.getInstance()
.checkApiAvailability(client)
.onSuccessTask(unused -> client.getLastLocation())
.addOnFailureListener(e -> Log.d(TAG, "Location unavailable."));
}