欢迎加入我们的邮寄名单,接收有关附近地点的最新动态和公告。

概览

Nearby Messages API 是一种发布-订阅 API,可让您在连接到互联网的 Android 和 iOS 设备之间传递较小的二进制文件载荷。设备不必连接到同一网络,但必须连接到互联网。

“附近”功能使用蓝牙低功耗在设备之间传递唯一的实时配对码。服务器可促进在检测到同一配对码的设备之间交换消息。设备检测到附近设备的配对码时,会将配对码发送到“附近消息”服务器进行验证,并检查是否为应用的当前订阅集传送了任何消息。

“附近消息”未经身份验证,不需要 Google 帐号。

具体的数据交换机制可能会因版本而异。以下序列显示了导致消息交换的事件:

  1. 发布应用发出请求,将二进制载荷(消息)与唯一的即时配对码(令牌)相关联。服务器会在消息载荷和令牌之间暂时建立关联。

  2. 发布设备使用蓝牙低功耗进行检测,以便附近的设备能够检测到该令牌。发布设备还会使用蓝牙低功耗扫描其他设备中的令牌。

  3. 订阅应用将其订阅与令牌相关联,并使用蓝牙低功耗将其令牌发送给发布商,并检测发布商的令牌。

  4. 当任一侧检测到另一方的令牌时,便会向服务器报告这一令牌。

  5. 如果两台设备均与一个通用令牌相关联,并且调用方应用所使用的 API 密钥与 Google Developers Console 中的同一项目相关联,则服务器会促进两台设备之间的消息交换。

使用 Google Play 服务 Nearby SDK 时,系统会收集使用情况分析以改善体验。

  • 性能指标:使用 Nearby SDK 收集发布和订阅的时长以及收到的消息数量。
  • 设备信息:系统会收集设备型号、国家/地区、build 版本和应用软件包名称并将其与性能指标相关联,以确定区域和设备专用切片。
  • 已发布的“附近消息”功能:通过“附近消息”功能发布的数据将由 Google 存储,直到相应消息不再发布。系统会将此数据分享给设备附近的订阅者。

最终用户可以通过依次转到“设置”>“Google”>“使用情况和诊断信息”来允许或拒绝此集合。