概要

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 で同じプロジェクトに関連付けられている場合、サーバーは 2 つのデバイス間のメッセージ交換を容易にします。

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

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

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