開始使用

本文說明如何開始在以下平台使用 Nearby Messages API 進行開發 Android。Nearby Messages API Google Play 服務。

步驟 1：取得 Google Play 服務

Nearby Messages API 適用於搭載以下作業系統的 Android 裝置： Google Play 服務 7.8.0 以上版本。搭載 Android 2.3 以上版本且搭載 Google Play 商店應用程式會自動接收 Google Play 服務更新。確認 裝置上安裝的 Google Play 服務版本，請前往 設定 >應用程式 >Google Play 服務。

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

  1. 開啟 Android SDK Manager。

  2. 在「外觀與」底下行為 >系統設定 >Android SDK >SDK 工具， 確認下列套件已安裝：

    • Google Play 服務
    • Google 存放區

步驟 2：取得 Google 帳戶

您必須擁有 Google 帳戶，才能使用 Nearby Messages API。 因此，開發人員可於下一次啟用 Nearby API 步驟 (使用者不一定要有 Google 帳戶)。 如果您已經有帳戶，則已準備就緒。您也可以 測試用不同的 Google 帳戶

步驟 3：取得 API 金鑰

請按照下列步驟啟用 Google Nearby Messages API for Android，並 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 金鑰，您需要 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.3.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。發布或訂閱時 「鄰近分享」會顯示選擇啟用對話方塊。