การแจ้งเตือนแบตเตอรี่

เมื่อผู้ให้บริการมีคอมโพเนนต์หลายรายการ การแจ้งระดับแบตเตอรี่ของแต่ละคอมโพเนนต์ให้ผู้ขอทราบอาจเป็นประโยชน์ ตัวอย่างหนึ่งของกรณีนี้คือ เมื่อเปิดเคสหูฟังเอียร์บัดและ Seeker ต้องการทราบแบตเตอรี่ของ หูฟังแต่ละข้างและเคสเอง

หากต้องการดำเนินการนี้ ผู้ให้บริการสามารถใส่ข้อมูลเพิ่มเติมในโฆษณาที่สร้างขึ้นจากข้อมูลบัญชี Fast Pair ที่อธิบายไว้ในการโฆษณา: เมื่อค้นหาไม่พบ

นอกจากข้อมูลบัญชีแล้ว ผู้ให้บริการควรใส่ช่องเพิ่มเติม ที่ระบุค่าแบตเตอรี่ แพ็กเก็ตต้องมีข้อมูลต่อไปนี้

Octet ประเภทข้อมูล คำอธิบาย ค่า ต้องระบุหรือไม่
0 uint8 ธง 0x00
(บิตทั้งหมดสงวนไว้สำหรับการใช้งานในอนาคต)		 บังคับ
1 - s ข้อมูลคีย์บัญชี บังคับ
s + 1 uint8 ความยาวและประเภทของระดับแบตเตอรี่
0bLLLLTTTT
  • L = จำนวนค่าแบตเตอรี่
  • T = ประเภท
 0bLLLLTTTT
  • length = 0b0011 = 3 ค่าแบตเตอรี่
  • type = 0b0011 (แสดงข้อบ่งชี้ UI) หรือ 0b0100 (ซ่อนข้อบ่งชี้ UI)
 ไม่บังคับ
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 โดยการรวมคีย์บัญชี กับ Salt แต่เมื่อมีการโฆษณาข้อมูลแบตเตอรี่ด้วย ค่า V ควรสร้างดังนี้

  1. สร้างค่า V โดยมีเงื่อนไขดังนี้
    1. 16 ไบต์แรกคือ K
    2. ไบต์ถัดไปคือเกลือ
    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];
  }

ผู้ให้บริการไม่ควรรวมข้อมูลแบตเตอรี่ดิบไว้ใน โฆษณาทุกครั้งเพื่อป้องกันการติดตาม แต่จะส่งผ่านสตรีมข้อความแทนได้เมื่อเชื่อมต่อกับ Seeker โปรดดูสตรีมข้อความ: ข้อมูลอุปกรณ์