總覽

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

「鄰近分享」會使用藍牙低功耗技術,在裝置間傳送不重複的配對碼。伺服器會協助偵測到相同配對碼的裝置交換訊息。當裝置偵測到鄰近裝置的配對碼時,會將配對碼傳送至 Nearby Messages 伺服器進行驗證,並檢查是否有任何訊息要傳送至應用程式目前的訂閱項目。

Nearby Messages 不需要經過驗證,也不需要 Google 帳戶。

確切的資料交換機制可能因版本而異。下列序列顯示導致訊息交換的事件:

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

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

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

  4. 當任一方偵測到對方的權杖時,就會回報給伺服器。

  5. 當兩個裝置與同一個權杖建立關聯,且呼叫應用程式使用的 API 金鑰與 Google Developers 控制台中的同一個專案建立關聯時,伺服器會協助兩個裝置交換訊息。

使用 Google Play 服務 Nearby SDK 時,系統會收集使用數據分析,以改善體驗。

  • 成效指標:使用 Nearby SDK 時,系統會收集發布和訂閱作業的時間長度,以及收到的訊息數量。
  • 裝置資訊:系統會收集裝置型號、國家/地區、版本和應用程式套件名稱,並與成效指標建立關聯,以識別區域和裝置專屬切片。
  • 鄰近分享訊息發布:透過鄰近分享訊息發布的資料會由 Google 儲存,直到訊息不再發布為止。這項資料會提供給裝置附近的訂閱者。

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