Notifica della batteria
Quando un fornitore include più componenti, può essere utile notificare al richiedente il livello batteria di ciascun componente. Un esempio è quando viene aperta una custodia per auricolari e il richiedente deve conoscere la batteria di ogni singolo auricolare e della custodia stessa.
Per farlo, un fornitore può includere informazioni aggiuntive nell' annuncio, basate sui dati dell'account Accoppiamento rapido descritti in Annunci: quando non è rilevabile.
Oltre ai dati dell'account, il fornitore deve includere un campo aggiuntivo che specifichi i valori della batteria. Il pacchetto deve contenere quanto segue:
| Ottetto | Tipo di dati | Descrizione | Valore | Obbligatorio? |
|---|---|---|---|---|
| 0 | uint8 |
Bandiere | 0x00 (tutti i bit riservati per l'uso futuro) |
Obbligatorio |
| 1 - s | Dati della chiave dell'account | Obbligatorio | ||
| s + 1 | uint8 |
Lunghezza e tipo del livello batteria 0bLLLLTTTT
|
0bLLLLTTTT
|
Facoltativo |
| s + 2, s + 3, s + 4 | uint8 |
Valori della batteria 0bSVVVVVVV
|
0bSVVVVVVV
|
Facoltativo |
Per evitare manomissioni, i dati della chiave dell'account sopra riportati devono essere leggermente modificati per includere le informazioni sulla batteria quando i valori della batteria sono inclusi nell'annuncio. In genere, quando si crea il filtro della chiave dell'account, viene prodotto un valore V combinando la chiave dell'account con un salt. Quando vengono pubblicizzate anche le informazioni sulla batteria, il valore V deve essere costruito come segue:
- Produci un valore V, dove:
- I primi 16 byte sono K.
- I byte successivi sono il Salt.
- I byte rimanenti sono le informazioni sulla batteria (da s + 1 a s + 4 , incluso il byte di lunghezza e tipo della tabella sopra).
Come indicato nel campo relativo alla lunghezza e al tipo della batteria sopra, il tipo può essere 0b0011 o 0b0100.
- 0b0011: da utilizzare quando il fornitore vuole che il richiedente mostri un'indicazione dei valori della batteria nell'interfaccia utente.
- 0b0100: da utilizzare quando il fornitore vuole che il richiedente nasconda l'indicazione, se è già visualizzata.
Un caso d'uso comune è utilizzare 0b0011 quando la custodia è stata aperta e 0b0100 quando gli auricolari sono stati rimossi dalla custodia o è stata richiusa.
//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];
}
Per evitare il monitoraggio, il fornitore non deve includere sempre i dati della batteria non elaborati nell'annuncio. Può invece essere inviato tramite Message Stream quando connesso a un richiedente, vedi Message Stream: informazioni sul dispositivo.