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

หมายเหตุ: Google แนะนำให้ใช้กรอบการทดสอบวิทยาการเข้ารหัสลับเพื่อให้ยืนยันข้อกำหนดเหล่านี้ได้ง่ายขึ้น

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

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

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

อ็อกเท็ต	ประเภทข้อมูล	คำอธิบาย	ค่า	จำเป็นหรือไม่
0	uint8	ธง	0x00 (บิตทั้งหมดสงวนไว้สำหรับการใช้งานในอนาคต)	จำเป็น
1 - วินาที		ข้อมูลคีย์บัญชี	จำเป็น
วินาที + 1	uint8	ความยาวและประเภทแบตเตอรี่ 0bLLLLTT 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 สถานะ = 0b1 (กำลังชาร์จ) หรือ 0b0 (ไม่ได้ชาร์จ) value = ระดับแบตเตอรี่ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์และ 0bS1111111 สําหรับระดับที่ไม่รู้จัก	ไม่บังคับ

เพื่อเป็นการป้องกันการงัดแงะ ข้อมูลคีย์บัญชีข้างต้นจะต้องได้รับการแก้ไขเล็กน้อยให้รวมข้อมูลแบตเตอรี่ไว้ด้วยเมื่อค่าของแบตเตอรี่รวมอยู่ในโฆษณา โดยปกติ เมื่อสร้างตัวกรองคีย์บัญชี ระบบจะสร้างค่า V โดยรวมคีย์บัญชีกับ Salt เมื่อมีการโฆษณาข้อมูลแบตเตอรี่ด้วย ค่า 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 แทนเมื่อเชื่อมต่อกับผู้ร้องขอได้ โปรดดูสตรีมข้อความ: ข้อมูลอุปกรณ์