Tài liệu này giải thích cách bắt đầu phát triển bằng API Nhận biết trên Android. API Nhận biết là một phần của Dịch vụ Google Play.
Để sử dụng API Nhận thức, bạn cần có một Tài khoản Google. Nếu đã có tài khoản thì bạn có thể bỏ qua bước này. Bạn cũng nên tạo một Tài khoản Google riêng cho mục đích thử nghiệm.
Trước khi bắt đầu
Lấy khóa API
Nếu bạn chưa bật API Nhận biết và chưa lấy khoá API của Google, hãy làm theo các bước trong Khoá đăng ký và khoá API.
Định cấu hình ứng dụng
Trong tệp
build.gradle
cấp dự án, hãy đưa kho lưu trữ Maven của Google vào cả hai phầnbuildscript
vàallprojects
:buildscript { repositories { google() } } allprojects { repositories { google() } }
Thêm các phần phụ thuộc cho API Nhận biết vào tệp Gradle cấp ứng dụng của mô-đun, thường là
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-awareness:19.0.1' }
Thêm Khoá API Nhận biết vào tệp
AndroidManifest.xml
của ứng dụng. Để làm vậy, hãy thêm thẻ<meta-data>
cóandroid:name="com.google.android.awareness.API_KEY"
. Đối vớiandroid:value
, hãy chèn Khoá API nhận biết của riêng bạn, được đặt trong dấu ngoặc kép.<manifest> <application> <meta-data android:name="com.google.android.awareness.API_KEY" android:value="API_KEY"/> </application> </manifest>
Thêm các quyền cần thiết vào tệp
AndroidManifest.xml
của ứng dụng. Các quyền cần thiết sẽ khác nhau tuỳ thuộc vào phương thức API và loại hàng rào mà ứng dụng của bạn sử dụng.
Ví dụ về lệnh gọi
Ví dụ sau đây gọi
getDetectedActivity()
minh họa cách sử dụng mô hình Dịch vụ Google Play không kết nối với
API Nhận biết:
// Each type of contextual information in the snapshot API has a corresponding "get" method.
// For instance, this is how to get the user's current Activity.
Awareness.getSnapshotClient(this).getDetectedActivity()
.addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
@Override
public void onSuccess(DetectedActivityResponse dar) {
ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
// getMostProbableActivity() is good enough for basic Activity detection.
// To work within a threshold of confidence,
// use ActivityRecognitionResult.getProbableActivities() to get a list of
// potential current activities, and check the confidence of each one.
DetectedActivity probableActivity = arr.getMostProbableActivity();
int confidence = probableActivity.getConfidence();
String activityStr = probableActivity.toString();
mLogFragment.getLogView().println("Activity: " + activityStr
+ ", Confidence: " + confidence + "/100");
}
})
Các bước tiếp theo
Tìm hiểu thêm về các API khác nhau trong API Nhận thức: