Bắt đầu

Tài liệu này giải thích cách bắt đầu phát triển bằng Nearby Messages API trên Android. Nearby Messages API là một phần của Dịch vụ Google Play.

Bước 1: Tải Dịch vụ Google Play

Nearby Messages API hoạt động trên những thiết bị Android có Dịch vụ Google Play 7.8.0 trở lên. Thiết bị chạy Android 2.3 trở lên có ứng dụng Google Ứng dụng Cửa hàng Play tự động nhận bản cập nhật cho Dịch vụ Google Play. Để kiểm tra phiên bản Dịch vụ Google Play nào được cài đặt trên thiết bị của bạn, hãy truy cập Cài đặt > Ứng dụng > Dịch vụ Google Play.

Đảm bảo rằng bạn có thư viện ứng dụng mới nhất cho Dịch vụ Google Play trên máy chủ phát triển:

  1. Mở Trình quản lý SDK Android.

  2. Trong mục Giao diện và Hành vi > Cài đặt hệ thống > SDK Android > Bộ công cụ SDK, hãy đảm bảo rằng các gói sau đã được cài đặt:

    • Dịch vụ Google Play
    • Kho lưu trữ của Google

Bước 2: Tạo Tài khoản Google

Để sử dụng Nearby Messages API, bạn cần có Tài khoản Google. Việc này là để bạn, với tư cách là nhà phát triển, có thể bật Nearby API trong (người dùng của bạn sẽ không cần phải có Tài khoản Google). Nếu đã có tài khoản thì bạn đã hoàn tất. Có thể bạn cũng muốn riêng Tài khoản Google cho mục đích thử nghiệm.

Bước 3: Lấy khoá API

Làm theo các bước sau để bật API Google Nearby Messages cho Android và tải khoá API:

  1. Chuyển đến Google Developers Console.
  2. Tạo hoặc chọn một dự án để đăng ký ứng dụng của bạn.
  3. Nhấp vào Tiếp tục để bật API.
  4. Trên trang Thông tin đăng nhập, tạo một khoá Android mới (và đặt API Thông tin xác thực).
    Lưu ý: Nếu đã có khoá Android thì bạn có thể dùng khoá đó.
  5. Trong hộp thoại hiện ra, hãy nhập vân tay số SHA-1 của ứng dụng và tên gói. Ví dụ: 
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.nearbyexample
  6. Khoá API Android mới của bạn sẽ xuất hiện trong danh sách khoá API cho dự án của bạn. Khoá API là một chuỗi ký tự, có dạng như sau: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Lấy vân tay số SHA1 của chứng chỉ

Để tạo khoá API mới cho ứng dụng Android, bạn cần có vân tay số SHA1 của chứng chỉ mà bạn dùng để ký APK. Chỉ có thể trao đổi tin nhắn giữa các ứng dụng được ký bằng khoá API từ cùng một dự án.

Để có được vân tay số này:

  1. Tìm vị trí kho khoá của bạn.
  2. Trong dòng lệnh, hãy chạy tiện ích keytool qua JDK. Cho chẳng hạn như nếu bạn đang sử dụng kho khoá `debug`:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    Lưu ý: Đối với kho khoá gỡ lỗi, mật khẩu là android. Trên Mac OS và Linux, kho khoá gỡ lỗi thường là đặt tại ~/.android/debug.keystore. Trên Windows, thường nằm tại %USERPROFILE%\.android\debug.keystore.

  3. Kết quả của lệnh keytool chứa SHA1 vân tay số cho chứng chỉ.

Bước 4: Định cấu hình dự án

Android Studio cung cấp dễ dàng tạo dự án cho Nearby Messages API. Làm theo các bước được mô tả trong phần Tạo dự án để tạo một dự án mới. Trong Android Studio, hãy mở tệp build.gradle cho mô-đun của bạn và thêm thư viện ứng dụng Dịch vụ Google Play làm phần phụ thuộc:

apply plugin: 'android'
...

dependencies {
    compile 'com.google.android.gms:play-services-nearby:19.3.0'
}

Sau đó, hãy định cấu hình tệp kê khai bằng Khoá API được tạo ở bước trước:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.sample.app" >
    <application ...>
        <meta-data
            android:name="com.google.android.nearby.messages.API_KEY"
            android:value="API_KEY" />
        <activity>
        ...
        </activity>
    </application>
</manifest>

Bước 5: Xuất bản và đăng ký

Trong ứng dụng của bạn, hãy bắt đầu sử dụng Nearby Messages API.

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }

    mMessage = new Message("Hello World".getBytes());
}

@Override
public void onStart() {
    super.onStart();
    ...
    Nearby.getMessagesClient(this).publish(mMessage);
    Nearby.getMessagesClient(this).subscribe(mMessageListener);
}

@Override
public void onStop() {
    Nearby.getMessagesClient(this).unpublish(mMessage);
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
    ...
    super.onStop();
}

Nearby Messages API yêu cầu sự đồng ý của người dùng. Khi xuất bản hoặc đăng ký được gọi lần đầu tiên, tính năng Lân cận sẽ hiển thị hộp thoại chọn tham gia.