概要

Nearby Messages API は、インターネットに接続された Android デバイスと iOS デバイスの間で小さなバイナリ ペイロードを渡すことができる、パブリッシュ / サブスクライブ API です。デバイスは同じネットワーク上にある必要はありませんが、インターネットに接続されている必要があります。

Nearby は、Bluetooth Low Energy を使用して、デバイス間で一意のペア設定コードを通信します。サーバーは、同じペア設定コードを検出したデバイス間のメッセージ交換を容易にします。デバイスは、近くのデバイスからペア設定コードを検出すると、そのペア設定コードを Nearby Messages サーバーに送信して検証し、アプリの現在のサブスクリプション セットに配信するメッセージがあるかどうかを確認します。

Nearby Messages は認証を必要とせず、Google アカウントも必要ありません。

データ交換の正確なメカニズムは、リリースごとに異なる場合があります。次のシーケンスは、メッセージ交換につながるイベントを示しています。

  1. パブリッシュするアプリは、バイナリ ペイロード(メッセージ)を、時間的に一意のペア設定コード(トークン)に関連付けるリクエストを行います。サーバーは、メッセージ ペイロードとトークンを一時的に関連付けます。

  2. 公開デバイスは、Bluetooth Low Energy を使用して、付近のデバイスがトークンを検出できるようにします。パブリッシュ側のデバイスは、Bluetooth Low Energy を使用して他のデバイスからのトークンをスキャンします。

  3. 定期購入アプリは、サブスクリプションをトークンに関連付け、Bluetooth Low Energy を使用してトークンをパブリッシャーに送信し、パブリッシャーのトークンを検出します。

  4. どちらかの側が相手のトークンを検出すると、サーバーに報告します。

  5. サーバーは、2 つのデバイスが共通のトークンに関連付けられており、呼び出し元アプリで使用される API キーが Google Developers Console の同じプロジェクトに関連付けられている場合に、デバイス間のメッセージ交換を容易にします。

Google Play 開発者サービスの Nearby SDK を使用すると、エクスペリエンスを向上させるために使用状況の分析情報が収集されます。

  • パフォーマンス指標: Nearby SDK の使用時に、パブリッシュとサブスクリプションの期間、受信したメッセージの数が収集されます。
  • デバイス情報: デバイスモデル、国、ビルド バージョン、アプリのパッケージ名が収集され、パフォーマンス指標に関連付けられます。これにより、地域やデバイス固有のスライスを特定できます。
  • Nearby Messages の公開: Nearby Messages を通じて公開されたデータは、メッセージが公開されなくなるまで Google によって保存されます。このデータは、デバイスの近くにいるサブスクライバーと共有されます。

エンドユーザーは、[設定] > [Google] > [使用状況と診断情報] に移動して、この収集を許可または拒否できます。