開始使用

本文件說明如何開始在 Android 上使用 Nearby Messages API 進行開發。Nearby Messages API 屬於 Google Play 服務的一部分。

步驟 1：取得 Google Play 服務

Nearby Messages API 適用於搭載 Google Play 服務 7.8.0 以上版本的 Android 裝置。搭載 Android 2.3 以上版本且已安裝 Google Play 商店應用程式的裝置會自動收到 Google Play 服務更新。如要查看裝置上安裝的 Google Play 服務版本，請依序前往「設定」>「應用程式」>「Google Play 服務」。

確認您在開發主機上擁有 Google Play 服務的最新用戶端程式庫：

  1. 開啟 Android SDK Manager。

  2. 在「Appearance & Behavior」>「System Settings」>「Android SDK」>「SDK Tools」下方，確認已安裝下列套件：

    • Google Play 服務
    • Google 存放區

步驟 2：取得 Google 帳戶

您必須擁有 Google 帳戶，才能使用 Nearby Messages API。這樣一來，開發人員就可以在下一個步驟中啟用 Nearby API (使用者無需擁有 Google 帳戶)。如果您已有帳戶，則已準備就緒。您也可以另外使用一個 Google 帳戶進行測試。

步驟 3：取得 API 金鑰

請按照下列步驟啟用 Android 版 Google Nearby Messages API 並取得 API 金鑰：

  1. 前往 Google Developers Console。
  2. 建立或選取要註冊應用程式的專案。
  3. 按一下「繼續」即可啟用 API。
  4. 在「Credentials」(憑證) 頁面上，建立新的 Android 金鑰 (並設定 API 憑證)。
    注意：如果您已有 Android 金鑰，可以使用該金鑰。
  5. 在結果對話方塊中，輸入應用程式的 SHA-1 指紋和套件名稱。例如： 
    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. 新的 Android API 金鑰會顯示在專案的 API 金鑰清單中。API 金鑰是字元字串，如下所示： 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

取得憑證的 SHA1 指紋

如要為 Android 應用程式建立新的 API 金鑰，您需要簽署 APK 的憑證 SHA1 指紋。只有使用相同專案 API 金鑰簽署的應用程式，才能交換訊息。

如要取得此指紋，請按照下列步驟操作：

  1. 找出 KeyStore 的位置。
  2. 在終端機中，從 JDK 執行 keytool 公用程式。舉例來說，如果您使用的是 `debug` KeyStore：
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    注意：針對偵錯 KeyStore，密碼為 android。Mac OS 和 Linux 的偵錯 KeyStore 通常位於 ~/.android/debug.keystore。在 Windows 上，該位址通常位於 %USERPROFILE%\.android\debug.keystore。

  3. keytool 指令的輸出結果包含憑證的 SHA1 指紋。

步驟 4：設定專案

Android Studio 可讓您輕鬆為 Nearby Messages API 建立專案。按照建立專案一文中所述的步驟建立新專案。在 Android Studio 中開啟模組的 build.gradle 檔案，然後將 Google Play 服務用戶端程式庫新增為依附元件：

apply plugin: 'android'
...

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

然後使用您在上一個步驟中產生的 API 金鑰設定資訊清單：

<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>

步驟 5：發布並訂閱

在應用程式中開始使用 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 須取得使用者同意。系統首次叫用發布或訂閱時，Nearby 會顯示選擇加入對話方塊。