バッテリーに関する通知
プロバイダに複数のコンポーネントが含まれている場合、各コンポーネントのバッテリー残量をシーカーに通知すると便利です。たとえば、イヤホンケースが開かれたときに、シーカーが個々のイヤホンとケース自体のバッテリー残量を知る必要がある場合などです。
これを実現するために、プロバイダは、アドバタイズ: 検出できない場合で説明されている Fast Pair アカウント データの上に構築された、追加情報をアドバタイズに含めることができます。
プロバイダは、アカウント データに加えて、バッテリー値を指定する追加のフィールドを含める必要があります。パケットには次のものが含まれます。
| オクテット | データ型 | 説明 | 値 | 必須かどうか |
|---|---|---|---|---|
| 0 | uint8 |
フラグ | 0x00 （すべてのビットは将来の使用のために予約済み） |
必須 |
| 1 - s | アカウントのキーデータ | 必須 | ||
| s + 1 | uint8 |
バッテリー残量の長さとタイプ 0bLLLLTTTT
|
0bLLLLTTTT
|
省略可 |
| s + 2、s + 3、s + 4 | uint8 |
バッテリーの値 0bSVVVVVVV
|
0bSVVVVVVV
|
省略可 |
改ざんを防ぐため、バッテリー値がアドバタイズメントに含まれる場合、上記のアカウント キーデータはバッテリー情報を含むようにわずかに変更されます。通常、アカウント キー フィルタを構築する際、アカウント キーとソルトを組み合わせて値 V が生成されます。代わりに、バッテリー情報もアドバタイズされている場合は、値 V を次のように構成する必要があります。
- 値 V を生成します。ここで、
- 最初の 16 バイトは K です。
- 次のバイトは Salt です。
- 残りのバイトはバッテリー情報です（上記の表の長さとタイプバイトを含む s + 1 から s + 4 まで）。
上記のバッテリーの長さとタイプ フィールドで説明したように、タイプは 0b0011 または 0b0100 のいずれかになります。
- 0b0011 - プロバイダがシーカーに UI でバッテリー値の表示を求める場合に使用します。
- 0b0100 - プロバイダが、すでに表示されている場合にシーカーにインジケーターを非表示にさせたいときに使用します。
一般的なユースケースとしては、ケースが開いたときに 0b0011 を使用し、イヤホンがケースから取り出されたときやケースが再び閉じられたときに 0b0100 を使用することがあります。
//The sample code demonstrates that the headset only reports the battery level.
#define FASTPAIR_ACCOUNT_KEY_SIZE 16
// In the sample code, the size of salt is 2 bytes.
#define SALT_SIZE 2
// 1st byte - Battery level length and type
// 2nd~4th bytes - Battery values
#define BAT_LEVEL_SIZE 3
uint8_t V[FASTPAIR_ACCOUNT_KEY_SIZE + SALT_SIZE + BAT_LEVEL_SIZE + 1] = {0};
int v_index = 0;
// The first 16 bytes are K.
uint8_t K[FASTPAIR_ACCOUNT_KEY_SIZE] = {0};
fastpair_get_account_key_by_index(keyIndex, K);
memcpy(V, K, FASTPAIR_ACCOUNT_KEY_SIZE);
v_index = v_index + FASTPAIR_ACCOUNT_KEY_SIZE;
// The next byte is the Salt.
uint8_t randomSalt = (uint8_t)rand();
V[v_index] = randomSalt;
v_index = v_index + SALT_SIZE;
// The remaining bytes are the battery information (from s + 1 to s + 4 including the length and type bytes).
uint8_t battery_level_len = 0;
uint8_t battery_level[BAT_LEVEL_SIZE] = {0};
fastpair_get_bat_level(&battery_level_len, battery_level);
// type = 0b0011 (show UI indication) or 0b0100 (hide UI indication)
V[v_index] = (battery_level_len << 4 | (is_show_ui ? 0x3 : 0x4));
v_index = v_index + 1;
for (int idx = 0; idx < battery_level_len; idx++) {
V[v_index++] = battery_level[idx];
}
トラッキングを防ぐため、プロバイダは常に広告に未加工のバッテリーデータを含めるべきではありません。代わりに、シーカーに接続されたときにメッセージ ストリーム経由で送信できます。メッセージ ストリーム: デバイス情報をご覧ください。