總覽

Nearby Messages API 是一種發布訂閱 API,可讓您在已連上網際網路的 Android 和 iOS 裝置之間傳遞小型二進位檔酬載。裝置不必位於同一個網路,但必須連上網際網路。

鄰近分享功能會使用藍牙低功耗技術,在裝置之間傳送專屬的即時配對代碼。伺服器可協助在偵測到相同配對代碼的裝置之間交換訊息。當裝置偵測到鄰近裝置提供的配對碼時,就會將配對代碼傳送至 Nearby Messages 伺服器進行驗證,並檢查是否有任何訊息需要針對應用程式目前的訂閱項目組合傳送。

「鄰近分享訊息」並未驗證,因此不需具備 Google 帳戶。

每個版本的資料交換機制可能不盡相同。以下順序顯示促成訊息交換的事件:

  1. 發布應用程式發出要求,將二進位酬載 (訊息) 與不重複的即時配對代碼 (權杖) 建立關聯。伺服器會在訊息酬載與權杖之間暫時建立關聯。

  2. 發布裝置會使用藍牙低功耗技術,讓鄰近裝置偵測權杖。發布裝置也會使用藍牙低功耗技術掃描其他裝置的權杖。

  3. 訂閱應用程式會將訂閱項目與權杖建立關聯,並使用藍牙低功耗功能將權杖傳送給發布者,並偵測發布者的權杖。

  4. 當任一側偵測到另一個符記時,就會向伺服器回報這個權杖。

  5. 當兩個裝置都與通用權杖建立關聯時,伺服器可協助推動訊息交換,以及呼叫應用程式使用的 API 金鑰與 Google Developers Console 中的相同專案建立關聯。

使用 Google Play 服務 Nearby SDK 時,系統會收集用量分析資料,以改善使用者體驗。

  • 成效指標:使用 Nearby SDK 時,收集發布和訂閱的時間長度和收到的訊息數量。
  • 裝置資訊:系統會收集裝置型號、國家/地區、建構版本和應用程式套件名稱,並與效能指標建立關聯,以識別特定區域和裝置配量。
  • Nearby Messages 發布:Google 會儲存透過 Nearby Messages 發布的資料,直到訊息發布為止。這項資料會與鄰近裝置的訂閱者分享。

使用者可以依序前往「設定」>「Google」>「使用狀況與診斷」,允許或拒絕這項收集作業。