電池通知

如果提供者含有多個元件，建議您通知 查看每個組件的電池電量。舉例來說 如果耳機盒打開了，而尋找人需要知道電池的電量， 包括個別耳機和充電盒本身。

要達到這個目的，供應商可以在 廣告，以如 廣告：不易找到。

除了帳戶資料外，「供應商」還應加入額外欄位 並指定電池的數值封包應包含下列項目：

八位元 資料類型 說明 值 必要？
0 uint8 旗幟 0x00
(保留所有位元，供日後使用)		 必填
1 - 秒 帳戶金鑰資料 必填
s + 1 uint8 電池電量長度和類型
0bLLTTTT
  • L = 電池數值
  • T = 類型
 0bLLTTT
  • 長度 = 0b0011 = 3 個電池值
  • type = 0b0011 (顯示 UI 指示) 或 0b0100 (隱藏 UI 指示)
 選用
s + 2、s + 3、s + 4 uint8 電池值
0bSVVVVVV
  • S = 狀態 (充電或未充電)
  • V = 值
  • 電池值應依左耳機 (s + 2)、右耳機 (s + 3) 和充電盒 (s + 4) 排列。
 0bSVVVVVV
  • status = 0b1 (充電) 或 0b0 (未充電)
  • 值 = 電池電量範圍介於 0 到 100% 之間，0bS1111111 (不明)。
 選用

為了防止竄改，請稍微「帳戶金鑰資料」 修改，在包含電池值時加入電池資訊 例如廣告中的特定位置通常在建立帳戶金鑰時 篩選器，值 V 是由合併帳戶所產生 加鹽的鍵相反地，如果同時宣傳電池資訊， 值 V 的建構方式如下：

  1. 產生 V 值，其中：
    1. 前 16 個位元組是 K。
    2. 下一個位元組是 Salt。
    3. 剩餘的位元組是電池資訊 (從 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];
  }

為了防止追蹤，「供應商」不應在 因此不會一直播放廣告可改用 RFCOMM 傳送 求職者請參閱 Message Stream：裝置資訊。