Powiadomienie o baterii

Jeśli dostawca zawiera wiele komponentów, warto powiadomić poszukującego o poziomie baterii każdego z nich. Przykładem może być sytuacja, gdy otwierasz etui słuchawek dousznych, a urządzenie wysyłające musi znać poziom baterii każdej słuchawki i samego etui.

Aby to zrobić, Dostawca może umieścić w reklamie dodatkowe informacje oparte na danych konta Fast Pair opisanych w sekcji Reklamy: gdy urządzenie nie jest wykrywalne.

Oprócz danych konta dostawca powinien uwzględnić dodatkowe pole określające wartości baterii. Pakiet powinien zawierać:

Aby zapobiec manipulacjom, powyższe dane klucza konta zostaną nieznacznie zmodyfikowane w celu uwzględnienia informacji o baterii, gdy wartości baterii zostaną uwzględnione w reklamie. Zwykle podczas tworzenia filtra klucza konta wartość V jest generowana przez połączenie klucza konta z wartością salt. Jeśli jednak reklamowane są też informacje o baterii, wartość V powinna być skonstruowana w ten sposób:

1. Wygeneruj wartość V, gdzie:
   1. Pierwsze 16 bajtów to K.
   2. Kolejne bajty to sól.
   3. Pozostałe bajty to informacje o baterii (od s + 1 do s + 4, w tym bajt długości i typu z tabeli powyżej).

Jak wspomnieliśmy powyżej w polu dotyczącym długości i typu baterii, typ może być oznaczony symbolem0b0011 lub 0b0100.

• 0b0011 – użyj, gdy dostawca chce, aby poszukujący wyświetlał w interfejsie użytkownika wskaźnik wartości baterii;
• 0b0100 – używane, gdy dostawca chce, aby poszukujący ukrył wskaźnik, jeśli jest on już wyświetlany.

Jednym z częstych przypadków użycia jest użycie 0b0011, gdy etui jest otwarte, i 0b0100, gdy słuchawki zostały wyjęte z etui lub etui zostało ponownie zamknięte.

  //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 stale uwzględniać w reklamie surowych danych o baterii. Zamiast tego można go wysłać za pomocą strumienia wiadomości, gdy jest połączony z wyszukiwarką. Więcej informacji znajdziesz w sekcji Strumień wiadomości: informacje o urządzeniu.