การแจ้งเตือนแบตเตอรี่
เมื่อผู้ให้บริการมีคอมโพเนนต์หลายรายการ การแจ้งผู้ที่มองหาระดับแบตเตอรี่ของแต่ละคอมโพเนนต์อาจมีประโยชน์ ตัวอย่างหนึ่งก็คือเมื่อมีการเปิดกล่องหูฟังเอียร์บัดไว้และ Seeker จำเป็นต้องรู้แบตเตอรี่ของหูฟังเอียร์บัดแต่ละข้างและตัวกล่อง
ในการดำเนินการดังกล่าว ผู้ให้บริการสามารถใส่ข้อมูลเพิ่มเติมในโฆษณา ซึ่งสร้างขึ้นจากข้อมูลบัญชีการจับคู่ด่วนซึ่งอธิบายไว้ในการโฆษณา: เมื่อค้นพบไม่ได้
นอกเหนือจากข้อมูลบัญชีแล้ว ผู้ให้บริการควรใส่ช่องเพิ่มเติมที่ระบุค่าแบตเตอรี่ด้วย แพ็กเก็ตจะต้องประกอบด้วยข้อมูลต่อไปนี้
อ็อกเท็ต | ประเภทข้อมูล | คำอธิบาย | ค่า | จำเป็นหรือไม่ |
---|---|---|---|---|
0 | uint8 |
ธง | 0x00 (บิตทั้งหมดสงวนไว้สำหรับการใช้งานในอนาคต) |
จำเป็น |
1 - วินาที | ข้อมูลคีย์บัญชี | จำเป็น | ||
วินาที + 1 | uint8 |
ความยาวและประเภทแบตเตอรี่ 0bLLLLTT
|
0bLLLLTTTT
|
ไม่บังคับ |
s + 2, s + 3, s + 4 | uint8 |
ค่าแบตเตอรี่ 0bSVVVVVVV
|
0bSVVVVVVV
|
ไม่บังคับ |
เพื่อเป็นการป้องกันการงัดแงะ ข้อมูลคีย์บัญชีข้างต้นจะต้องได้รับการแก้ไขเล็กน้อยให้รวมข้อมูลแบตเตอรี่ไว้ด้วยเมื่อค่าของแบตเตอรี่รวมอยู่ในโฆษณา โดยปกติ เมื่อสร้างตัวกรองคีย์บัญชี ระบบจะสร้างค่า V โดยรวมคีย์บัญชีกับ Salt เมื่อมีการโฆษณาข้อมูลแบตเตอรี่ด้วย ค่า V ควรสร้างขึ้นดังนี้
- สร้างค่า V ซึ่งมีลักษณะดังนี้
- 16 ไบต์แรกคือ K
- ไบต์ถัดไปคือ Salt
- ไบต์ที่เหลือเป็นข้อมูลแบตเตอรี่ (ตั้งแต่ 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 แทนเมื่อเชื่อมต่อกับผู้ร้องขอได้ โปรดดูสตรีมข้อความ: ข้อมูลอุปกรณ์