Powiadomienie o baterii
Jeśli Dostawca składa się z wielu elementów, warto powiadomić Sprawdzanie poziomu baterii każdego komponentu. Przykładem może być: gdy otwarte jest etui na słuchawki, a Seeker musi znać poziom baterii każdą słuchawkę i sam etui.
W tym celu Dostawca może dołączyć dodatkowe informacje w reklamy, zbudowanej na podstawie Danych konta Szybkiego parowania, które opisano w Reklamy: gdy nie można ich znaleźć.
Oprócz Danych konta Dostawca powinien uwzględnić dodatkowe pole i określania wartości baterii. Pakiet powinien zawierać:
Oktet | Typ danych | Opis | Wartość | Obowiązkowe? |
---|---|---|---|---|
0 | uint8 |
Flagi | 0x00 (wszystkie bity zarezerwowane do użycia w przyszłości) |
Obowiązkowe |
1–s | Dane klucza konta | Obowiązkowe | ||
S + 1 | uint8 |
Długość i typ baterii 0bLLLLTTTT
|
0bLLLLTTTT
|
Opcjonalnie |
S + 2, S + 3, S + 4 | uint8 |
Wartości baterii 0bSVVVVVVV
|
0bSVVVVVVV
|
Opcjonalnie |
Aby zapobiec manipulacjom, widoczne powyżej Dane klucza konta będą nieznacznie zmodyfikowany tak, by uwzględniał informacje o baterii razem z wartościami baterii w reklamie. Zwykle podczas tworzenia klucza konta filtr, to wartość V powstaje dzięki połączeniu konta klucz z solą. Zamiast tego, gdy są również rozgłaszane informacje o baterii, wartość V powinna być skonstruowana w ten sposób:
- Podaje wartość V, gdzie:
- Pierwsze 16 bajtów to K.
- Kolejne bajty to Sól.
- Pozostałe bajty to informacje o baterii (od s + 1 do s + 4 m.in. z długością i typem bajtów z tabeli powyżej).
Jak wspomnieliśmy w sekcji dotyczącej długości i typu baterii powyżej, typ to:
0b0011
lub 0b0100
.
- 0b0011 – należy użyć, gdy Dostawca chce, aby Poszukiwacz umieszczał wskazanie w Interfejs przedstawiający wartości baterii.
- 0b0100 – należy użyć, gdy dostawca chce ukryć oznaczenie, jeśli dostawca już jest wyświetlany.
Częstym zastosowaniem tego rozwiązania jest użycie funkcji 0b0011
po otwarciu zgłoszenia,
0b0100
po wyjęciu słuchawek z etui lub jego ponownym zamknięciu.
//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];
}
Aby zapobiec śledzeniu, Dostawca nie powinien umieszczać danych dotyczących nieprzetworzonych danych baterii w przez cały czas rośnie. Może zostać natomiast wysłana przez RFCOMM po połączeniu z szukającym. Więcej informacji znajdziesz w artykule Strumień wiadomości: informacje z urządzenia.