Notifica batteria

Quando un fornitore include più componenti, può essere utile informare il Ricerca del livello della batteria di ogni componente. Un esempio potrebbe essere quando una custodia per auricolari è aperta e il dispositivo di ricerca deve conoscere la batteria per ogni singolo auricolare e la custodia stessa.

A tal fine, un Fornitore può includere ulteriori informazioni nei basato sui dati dell'account per l'accoppiamento rapido descritti in Pubblicità: quando non rilevabile.

Oltre ai Dati dell'account, il Fornitore deve includere un campo aggiuntivo e specificare i valori della batteria. Il pacchetto deve contenere quanto segue:

Per impedire manomissioni, i dati chiave dell'account di cui sopra saranno leggermente modificato per includere le informazioni sulla batteria quando sono inclusi i valori della batteria nell'annuncio. Generalmente, durante la creazione della chiave dell'account , viene generato un valore V combinando l'account chiave con un sale. Invece, quando vengono pubblicizzate anche le informazioni sulla batteria, V deve essere costruito come segue:

1. Genera un valore V, dove:
   .
   1. I primi 16 byte sono K.
   2. I byte successivi sono il Salt.
   3. I byte restanti sono le informazioni sulla batteria (da s + 1 a s + 4 inclusi i byte di lunghezza e tipo della tabella precedente).

Come indicato nel campo relativo a durata e tipo di batteria sopra indicato, il tipo può essere 0b0011 o 0b0100.

• 0b0011 - Da usare quando il provider vuole che il ricercatore mostri un’indicazione nel UI dei valori della batteria;
• 0b0100 - Da utilizzare quando il provider vuole che il ricercatore nasconda l’indicazione se è già visualizzata.

Un caso d'uso comune è l'utilizzo di 0b0011 quando la richiesta è aperta e 0b0100 quando gli auricolari sono stati rimossi dalla custodia o chiusa di nuovo.

  //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 impedire il tracciamento, il fornitore non deve includere dati non elaborati sulla batteria nella con la pubblicità. Può invece essere inviato tramite RFCOMM quando connesso a in cerca di informazioni, consulta Stream di messaggi: Informazioni sul dispositivo.