バッテリー通知

プロバイダに複数のコンポーネントを含める場合は、 各コンポーネントのバッテリー残量を確認する。たとえば イヤホン ケースを開けたときに、シーカーのバッテリー残量が 本体とイヤホン本体が入っています。

これを実現するため、プロバイダは これは、 広告: 検出できない場合

アカウント データに加えて、プロバイダは追加のフィールドを含める必要があります。 電池の値を指定します。このパケットには以下が含まれます。

オクテット データ型 説明 必須かどうか
0 uint8 フラグ 0x00
(すべてのビットが将来の使用のために予約)
必須
1 ~ アカウントキー データ 必須
s + 1 uint8 電池残量の長さと種類
0bLLTTTT
  • L = 電池の値の数
  • T = 型
0bLLLLTTTT
  • 長さ = 0b0011 = 3 個のバッテリー値
  • type = 0b0011(UI インジケータを表示)または 0b0100(UI インジケータを非表示)
省略可
s + 2s + 3s + 4 uint8 バッテリー値
0bSVVVVVVV
  • S = ステータス(充電中または充電中)
  • V = 値
  • 電池の金額は、左のイヤホン(s + 2)、右のイヤホン(s + 3)、ケース(s + 4)の順で注文します。
0bSVVVVVVV
  • status = 0b1(充電中)または 0b0(充電中)
  • value = 電池残量は 0 ~ 100%の範囲で、不明の場合は 0bS1111111。
省略可

改ざんを防ぐため、上記のアカウントキーデータは、 電池の値が含まれる場合に電池情報が含まれるように修正 広告にあります通常、アカウント キーを フィルタの場合、値 V は、 鍵をかけてソルトします。代わりに、電池情報もアドバタイズされているときに、 値 V は次のように構成します。

  1. ここで、値 V を生成します。 <ph type="x-smartling-placeholder">
      </ph>
    1. 最初の 16 バイトは K です。
    2. 次のバイトはソルトです。
    3. 残りのバイトはバッテリー情報です(s + 1s + 4)。 (上記の表の長さと型のバイトを含む)。

上記のバッテリーの長さと種類に関する項目に記載されているように、種類は次のいずれかになります。 0b0011 または 0b0100

  • 0b0011 - プロバイダが、シーカーに指示を表示させたい場合に使用します。 バッテリー値の UI
  • 0b0100 - プロバイダがシーカーにインジケーターを非表示にするよう求める場合に使用 すでに表示されています。

一般的なユースケースの 1 つは、ケースが開かれて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];
  }

トラッキングを防止するため、プロバイダは未加工のバッテリー データを 見てきました。その代わりに RFCOMM 経由で、Google Cloud の シーカーについては、メッセージ ストリーム: デバイス情報をご覧ください。