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

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

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

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

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

1. จะสร้างค่า V โดยที่
   1. 16 ไบต์แรกคือ K
   2. ไบต์ถัดไปคือ Salt
   3. ไบต์ที่เหลือคือข้อมูลแบตเตอรี่ (ตั้งแต่ s + 1 ถึง s + 4 รวมทั้งความยาวและไบต์ประเภทจากตารางด้านบน)

ตามที่ระบุไว้ในช่องความยาวและประเภทแบตเตอรี่ด้านบน อาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้ 0b0011 หรือ 0b0100

• 0b0011 - ใช้เมื่อผู้ให้บริการต้องการให้ผู้ค้นหาแสดงตัวบ่งชี้ใน UI ค่าแบตเตอรี่
• 0b0100 - ใช้เมื่อผู้ให้บริการต้องการให้ Seeker ซ่อนตัวบ่งชี้หาก แสดงอยู่อยู่แล้ว

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