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
|
0bLLTTTT
|
Opcional |
s + 2, s + 3, s + 4 | uint8 |
Valores da bateria 0bSVVVVVVV
|
0bSVVVVVV
|
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:
- Produza um valor V, em que:
- Os primeiros 16 bytes são K.
- Os próximos bytes são o Sal.
- 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.