电池通知

当提供方包含多个组件时，通知寻求方每个组件的电池电量可能很有用。一个示例是，当入耳式耳机充电盒打开时，寻求方需要知道每个耳机和充电盒本身的电池电量。

为此，提供方可以在 广告中添加额外的信息，这些信息基于 广告：无法被发现中所述的 Fast Pair 账号数据。

除了账号数据之外，提供方还应添加一个额外字段来指定电池值。数据包应包含以下内容：

八位字节 数据类型 说明 值 是否为必填项？
0 uint8 标志 0x00
（所有位均预留以供日后使用）		 必填
1 - s 账号密钥数据 必填
s + 1 uint8 电池电量长度和类型
0bLLLLTTTT
  • L = 电池值的数量
  • T = 类型
 0bLLLLTTTT
  • length = 0b0011 = 3 个电池值
  • type = 0b0011（显示界面指示）或 0b0100（隐藏界面指示）
 可选
s + 2、s + 3、s + 4 uint8 电池值
0bSVVVVVVV
  • S = 状态（充电或未充电）
  • V = 值
  • 电池值应按左侧耳机 (s + 2)、右侧耳机 (s + 3) 和充电盒 (s + 4) 的顺序排列。
 0bSVVVVVVV
  • status = 0b1（充电）或 0b0（未充电）
  • value = 电池电量，范围为 0% 到 100%，未知时为 0bS1111111。
 可选

为防止篡改，当广告中包含电池值时，应略微修改上述账号密钥数据以包含电池信息。通常，在构建账号密钥 过滤器时，系统会通过将账号 密钥与盐值相结合来生成值V。不过，当同时宣传电池信息时，应按如下方式构造值 V：

  1. 生成值 V，其中：
    1. 前 16 个字节是 K。
    2. 接下来的字节是盐值。
    3. 剩余的字节是电池信息（从 s + 1 到 s + 4，包括上表中的长度和类型字节）。

如上文电池长度和类型字段中所述，类型可以是 0b0011 或 0b0100。

  • 0b0011 - 当提供方希望寻求方在界面中显示电池值的指示时使用；
  • 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];
  }

为防止跟踪，提供方不应始终在广告中包含原始电池数据。相反，当 连接到寻求方时，可以通过消息流发送这些数据，请参阅消息流：设备信息。