Уведомление о состоянии батареи

Когда в устройстве используется несколько компонентов, может быть полезно уведомлять пользователя об уровне заряда батареи каждого компонента. Например, когда открывается чехол для наушников, пользователю необходимо знать уровень заряда батареи каждого отдельного наушника и самого чехла.

Для этого поставщик услуг может включить в рекламное объявление дополнительную информацию, основанную на данных учетной записи Fast Pair, описанных в разделе «Реклама: когда информация недоступна для обнаружения» .

В дополнение к данным учетной записи, поставщик услуг должен включить дополнительное поле с указанием значений параметров батареи. Пакет документов должен содержать следующее:

Во избежание подделки, приведенные выше данные ключа учетной записи следует немного изменить, чтобы включить информацию о батарее, если значения батареи включены в рекламное сообщение. Обычно при формировании фильтра ключа учетной записи значение V формируется путем объединения ключа учетной записи с солью. Вместо этого, если также рекламируется информация о батарее, значение V следует формировать следующим образом:

1. Выведите значение V , где:
   1. Первые 16 байтов — это K.
   2. Следующие байты — это соль .
   3. Оставшиеся байты содержат информацию о батарее (от s + 1 до s + 4, включая байты длины и типа из приведенной выше таблицы).

Как указано в поле «Длина и тип батареи» выше, тип может быть либо 0b0011 , либо 0b0100 .

• 0b0011 — Используется, когда провайдер хочет, чтобы пользователь отображал в пользовательском интерфейсе индикатор уровня заряда батареи;
• 0b0100 — Используется, когда поставщик хочет, чтобы пользователь скрыл индикатор, если он уже отображается.

Один из распространенных вариантов использования — это присвоение значения 0b0011 , когда кейс открыт, и 0b0100 , когда наушники извлечены из кейса или он снова закрыт.

  //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];
  }

Чтобы предотвратить отслеживание, провайдер не должен постоянно включать необработанные данные о состоянии батареи в рекламное сообщение. Вместо этого их можно отправлять через поток сообщений при подключении к устройству Seeker (см. Поток сообщений: Информация об устройстве) .