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:

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:

1. Produci un valore V, dove:
   1. I primi 16 byte sono K.
   2. I byte successivi sono il Salt.
   3. 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.