배터리 알림
공급자가 여러 구성요소를 포함하는 경우 각 구성요소의 배터리 잔량을 탐색자에게 알리는 것이 유용할 수 있습니다. 예를 들어 이어폰 케이스가 열려 있고 탐색자가 각 이어폰과 케이스 자체의 배터리 잔량을 알아야 하는 경우입니다.
이를 위해 공급자는 탐색 가능하지 않은 경우의 광고에 설명된 빠른 페어링 계정 데이터를 기반으로 광고에 추가 정보를 포함할 수 있습니다.
계정 데이터 외에도 공급자는 배터리 값을 지정하는 추가 필드를 포함해야 합니다. 패킷에는 다음이 포함되어야 합니다.
| 옥텟 | 데이터 유형 | 설명 | 값 | 필수? |
|---|---|---|---|---|
| 0 | uint8 |
플래그 | 0x00 (모든 비트는 나중에 사용하기 위해 예약됨) |
필수 |
| 1 - s | 계정 키 데이터 | 필수 | ||
| s + 1 | uint8 |
배터리 잔량 길이 및 유형 0bLLLLTTTT
|
0bLLLLTTTT
|
선택사항 |
| s + 2, s + 3, s + 4 | uint8 |
배터리 값 0bSVVVVVVV
|
0bSVVVVVVV
|
선택사항 |
변조를 방지하기 위해 배터리 값이 광고에 포함된 경우 위의 계정 키 데이터는 배터리 정보를 포함하도록 약간 수정되어야 합니다. 일반적으로 계정 키 필터를 빌드할 때 계정 키와 솔트를 결합하여 값 V가 생성됩니다. 대신 배터리 정보도 광고되는 경우 값 V 는 다음과 같이 구성되어야 합니다.
- 다음과 같은 값 V를 생성합니다.
- 처음 16바이트는 K 입니다.
- 다음 바이트는 솔트입니다.
- 나머지 바이트는 배터리 정보입니다 (위 표의 길이 및 유형 바이트를 포함하여 s + 1에서 s + 4까지).
위의 배터리 길이 및 유형 필드에 설명된 대로 유형은 0b0011 또는 0b0100일 수 있습니다.
- 0b0011 - 공급자가 탐색자에게 배터리 값의 표시를 UI에 표시하도록 하려는 경우 사용합니다.
- 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];
}
추적을 방지하기 위해 공급자는 항상 광고에 원시 배터리 데이터를 포함해서는 안 됩니다. 대신 탐색자에 연결된 경우 메시지 스트림을 통해 전송할 수 있습니다. 메시지 스트림: 기기 정보를 참고하세요.