Notificação da bateria

Quando um provedor inclui vários componentes, pode ser útil notificar o Buscador sobre o nível de bateria de cada componente. Um exemplo disso seria quando um estojo para fones de ouvido é aberto e a pessoa precisa saber a bateria de cada fone e do estojo.

Para isso, um provedor pode incluir mais informações na divulgação, criadas com base nos dados da conta de Pareamento rápido descritos em Publicidade: quando não detectável.

Além dos dados da conta, o provedor precisa incluir um outro campo para especificar os valores da bateria. O pacote precisa conter o seguinte:

Octeto Tipo de dados Descrição Valor Obrigatório?
0 uint8 Flags 0x00
(todos os bits reservados para uso futuro)		 Obrigatório
1 - s Dados da chave da conta Obrigatório
s + 1 uint8 Duração e tipo do nível da bateria
0bLLLLTTTT
  • L = número de valores de bateria
  • T = tipo
 0bLLTTTT
  • comprimento = 0b0011 = 3 valores de bateria
  • type = 0b0011 (mostrar indicação da IU) ou 0b0100 (ocultar indicação da IU)
 Opcional
s + 2, s + 3, s + 4 uint8 Valores da bateria
0bSVVVVVVV
  • S = status (carregando ou não carregando)
  • V = valor
  • Os valores da bateria devem ser ordenados como fone de ouvido esquerdo (s + 2), fone direito (s + 3) e capa (s + 4).
 0bSVVVVVV
  • status = 0b1 (carregando) ou 0b0 (sem carregamento)
  • valor = nível de bateria que vai de 0 a 100%, 0bS1111111 para desconhecido.
 Opcional

Para evitar adulterações, os dados da chave da conta acima vão ser ligeiramente modificados para incluir informações sobre a bateria quando os valores da bateria estiverem no anúncio. Normalmente, ao criar o filtro de chave de conta, um valor V é produzido combinando a chave da conta com um sal. Em vez disso, quando as informações da bateria também forem anunciadas, o valor V precisa ser criado da seguinte maneira:

  1. Produza um valor V, em que:
    1. Os primeiros 16 bytes são K.
    2. Os próximos bytes são o Sal.
    3. Os bytes restantes são as informações da bateria, de s + 1 a s + 4, incluindo o comprimento e o tipo de byte da tabela acima.

Conforme observado no campo de duração da bateria e de tipo acima, o tipo pode ser 0b0011 ou 0b0100.

  • 0b0011: use quando o provedor quiser que o buscador mostre uma indicação na IU dos valores da bateria.
  • 0b0100: use quando o provedor quiser que o buscador oculte a indicação se ela já estiver sendo exibida.

Um caso de uso comum para isso é usar 0b0011 quando o estojo for aberto e 0b0100 quando os fones forem removidos ou fechados novamente.

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

Para evitar o rastreamento, o Provedor não pode incluir dados brutos da bateria no anúncio o tempo todo. Em vez disso, ele pode ser enviado por RFCOMM quando conectado a um buscador. Consulte Fluxo de mensagens: informações do dispositivo.