Bắt đầu

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

  1. 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ần buildscriptallprojects:

    buildscript {
        repositories {
            google()
        }
    }
    
    allprojects {
        repositories {
            google()
        }
    }
    
  2. 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'
    }
    
  3. 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>android:name="com.google.android.awareness.API_KEY". Đối với android: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>
    
  4. 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: