Notifikasi Baterai
Jika Penyedia menyertakan beberapa komponen, sebaiknya beri tahu Pencarian tentang level baterai untuk setiap komponen. Salah satu contohnya adalah saat casing earbud dibuka dan Pencari perlu mengetahui baterai untuk setiap bud dan casing itu sendiri.
Untuk melakukannya, Penyedia dapat menyertakan informasi tambahan dalam iklan, yang dibuat berdasarkan Data Akun Sambungan Cepat yang dijelaskan dalam Iklan: Saat tidak dapat ditemukan.
Selain Data Akun, Penyedia harus menyertakan kolom tambahan yang menentukan nilai baterai. Paket tersebut akan berisi hal berikut:
Oktet | Jenis data | Deskripsi | Nilai | Wajib? |
---|---|---|---|---|
0 | uint8 |
Tanda | 0x00 (semua bit dicadangkan untuk penggunaan mendatang) |
Wajib |
1 - d | Data Kunci Akun | Wajib | ||
s + 1 | uint8 |
Panjang dan jenis level baterai 0bLLTTTT
|
0bLLTTTT
|
Opsional |
s + 2, s + 3, s + 4 | uint8 |
Nilai baterai 0bSVVVVVVV
|
0bSVVVVVVV
|
Opsional |
Untuk mencegah modifikasi, Data Kunci Akun di atas harus sedikit dimodifikasi untuk menyertakan informasi baterai saat nilai baterai disertakan dalam iklan. Biasanya, saat membuat filter kunci akun, nilai V akan dihasilkan dengan menggabungkan kunci akun dengan salt. Sebagai gantinya, jika informasi baterai juga diiklankan, nilai V harus dibuat sebagai berikut:
- Berikan nilai V, dengan:
- 16 byte pertama adalah K.
- Byte berikutnya adalah Salt.
- Byte yang tersisa adalah informasi baterai (dari s + 1 hingga s + 4 termasuk panjang dan jenis byte dari tabel di atas).
Seperti yang disebutkan dalam kolom jenis dan panjang baterai di atas, jenisnya dapat berupa
0b0011
atau 0b0100
.
- 0b0011 - Gunakan saat Penyedia ingin Pencari Kerja menampilkan indikasi di UI nilai baterai;
- 0b0100 - Gunakan saat Penyedia ingin Pencari Kerja menyembunyikan indikasi jika indikasi sudah ditampilkan.
Salah satu kasus penggunaan yang umum untuk hal ini adalah menggunakan 0b0011
saat casing terbuka dan
0b0100
saat buds dikeluarkan dari casing atau telah ditutup lagi.
//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];
}
Untuk mencegah pelacakan, Penyedia tidak boleh menyertakan data baterai mentah dalam iklan sepanjang waktu. Sebagai gantinya, pesan dapat dikirim melalui RFCOMM saat terhubung ke Pencari Kerja. Lihat Aliran Pesan: Informasi Perangkat.