このページは Cloud Translation API によって翻訳されました。

ビーコンメッセージを受信する

アプリで Bluetooth Low Energy（BLE）ビーコンアタッチメントをサブスクライブできるユーザーがパブリッシュしたメッセージをサブスクライブするのと同じメカニズムを接続できます。定期購入に登録すると、付近のデバイスの両方からメッセージを受信できます。

BLE ビーコンメッセージに登録する

您的应用可以通过两种方式订阅 BLE 信标消息：

在前台，响应用户操作或事件
在后台运行时，未运行。

在前台订阅

当您的应用在前台订阅信标消息时，扫描将直到您的应用退订为止仅启动前台订阅（通常是为了响应用户操作）。

您的应用可以通过调用 Nearby.getMessagesClient(Activity).subscribe(MessageListener, SubscribeOptions) 并将 Strategy 选项设置为 BLE_ONLY。

以下代码段演示了如何启动前台订阅 Nearby.getMessagesClient(Activity).subscribe(MessageListener, SubscribeOptions):

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }
}

// Subscribe to receive messages.
private void subscribe() {
    Log.i(TAG, "Subscribing.");
    SubscribeOptions options = new SubscribeOptions.Builder()
            .setStrategy(Strategy.BLE_ONLY)
            .build();
    Nearby.getMessagesClient(this).subscribe(mMessageListener, options);
}

当不再需要订阅时，您的应用应退订通过调用 Nearby.getMessagesClient(Activity).unsubscribe(MessageListener)。

在后台订阅

当您的应用在后台订阅信标消息时，低功耗扫描会在屏幕事件时触发，即使您的应用当前未处于活动状态也是如此。您可以使用这些扫描通知来“唤醒”响应特定消息。后台订阅的功耗低于前台订阅，但延迟时间较长，可靠性较低。

您的应用可以通过调用 Nearby.getMessagesClient(Activity).subscribe(PendingIntent, SubscribeOptions) 并将 Strategy 选项设置为 BLE_ONLY。

以下代码段展示了如何通过以下方法启动后台订阅：呼叫 Nearby.getMessagesClient(Activity).subscribe(PendingIntent, SubscribeOptions)。

// Subscribe to messages in the background.
private void backgroundSubscribe() {
    Log.i(TAG, "Subscribing for background updates.");
    SubscribeOptions options = new SubscribeOptions.Builder()
            .setStrategy(Strategy.BLE_ONLY)
            .build();
    Nearby.getMessagesClient(this).subscribe(getPendingIntent(), options);
}

private PendingIntent getPendingIntent() {
    return PendingIntent.getBroadcast(this, 0, new Intent(this, BeaconMessageReceiver.class),
            PendingIntent.FLAG_UPDATE_CURRENT);
}

以下代码段展示了如何在 BeaconMessageReceiver 类。

@Override
public void onReceive(Context context, Intent intent) {
    Nearby.getMessagesClient(context).handleIntent(intent, new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.i(TAG, "Found message via PendingIntent: " + message);
        }

        @Override
        public void onLost(Message message) {
            Log.i(TAG, "Lost message via PendingIntent: " + message);
        }
    });
}

当不再需要订阅时，您的应用应退订通过调用 Nearby.getMessagesClient(Activity).unsubscribe(PendingIntent)。

解析信标消息

信标附件是可以添加到信标的任意数据 blob。每个连接都由以下部分组成：

命名空间：命名空间标识符。
类型：数据类型。
数据：附件的数据值。

以下代码段演示了如何使用消息监听器来解析从 BLE 信标收到的消息：

mMessageListener = new MessageListener() {
    @Override
    public void onFound(Message message) {
        // Do something with the message here.
        Log.i(TAG, "Message found: " + message);
        Log.i(TAG, "Message string: " + new String(message.getContent()));
        Log.i(TAG, "Message namespaced type: " + message.getNamespace() +
                "/" + message.getType());
    }

    ...
};

内容的解析取决于字节的格式。本示例假设内容字节对 UTF-8 字符串进行编码，但信标消息对其他字节格式（例如序列化协议缓冲区）进行编码。如需了解详情，请参阅向信标添加附件。

プロジェクトに関連付けられている名前空間を確認するには、次のコマンドを呼び出します。 namespaces.list。

注:

バッテリーの消費を抑えるには、Nearby.getMessagesClient(Activity).unsubscribe() を呼び出します。これをアクティビティの onStop() 関数で呼び出します。なお、これはサブスクライブしていることをフォアグラウンドで確認します。
レイテンシを短縮するには、Nearby.getMessagesClient(Activity).subscribe() を呼び出すときに Strategy.BLE_ONLY オプションを使用します。このオプションを設定すると、Nearby Messages API は従来の Bluetooth をトリガーしません構成されますこれにより、ビーコン検出のレイテンシが短縮されます。すべてのスキャンタイプを順番に繰り返すわけではありません。
メッセージペイロードをビーコンに添付するには、 Proximity Beacon API。