Notifikasi Baterai

Jika Penyedia menyertakan beberapa komponen, sebaiknya beri tahu Pencari level baterai untuk setiap komponen. Salah satu contohnya adalah saat casing earbud dibuka dan Pencari Kerja perlu mengetahui baterainya setiap bud dan {i>casing<i} itu sendiri.

Untuk melakukannya, Penyedia dapat menyertakan informasi tambahan dalam iklan, yang dibuat berdasarkan Data Akun Sambungan Cepat yang dijelaskan di Iklan: Saat tidak dapat ditemukan.

Selain Data Akun, Penyedia harus menyertakan kolom tambahan yang menentukan nilai baterai. Paket harus berisi hal berikut:

Oktet Jenis data Deskripsi Nilai Wajib?
0 uint8 Flag 0x00
(semua bit dicadangkan untuk penggunaan pada masa mendatang)		 Wajib
1 - dtk Data Kunci Akun Wajib
s + 1 uint8 Panjang dan jenis level baterai
0bLLLLTTTT
  • L = Jumlah nilai baterai
  • T = jenis
 0bLLLLTTTT
  • panjang = 0b0011 = 3 nilai baterai
  • type = 0b0011 (tampilkan indikasi UI) atau 0b0100 (sembunyikan indikasi UI)
 Opsional
s + 2, s + 3, s + 4 uint8 Nilai baterai
0bSVVVVVVV
  • S = status (mengisi daya atau tidak mengisi daya)
  • V = nilai
  • Nilai baterai sebaiknya diurutkan sebagai bud kiri (s + 2), bud kanan (s + 3), dan casing (s + 4).
 0bSVVVVVVV
  • status = 0b1 (pengisian) atau 0b0 (tidak mengisi daya)
  • value = level baterai mulai dari 0 hingga 100 persen, 0bS1111111 untuk tidak diketahui.
 Opsional

Untuk mencegah sabotase, Data Kunci Akun di atas akan sedikit dimodifikasi untuk menyertakan informasi baterai saat nilai baterai disertakan dalam iklan. Biasanya, saat membuat kunci akun filter, nilai V dihasilkan dengan menggabungkan akun kunci dengan {i>salt<i}. Sebaliknya, ketika informasi baterai juga diiklankan, nilai V harus dibuat sebagai berikut:

  1. Menghasilkan nilai V, dengan:
    1. 16 byte pertama adalah K.
    2. Byte berikutnya adalah Salt.
    3. Byte yang tersisa adalah informasi baterai (dari s + 1 hingga s + 4 termasuk panjang dan jenis byte dari tabel di atas).

Seperti yang disebutkan dalam isian panjang dan jenis baterai di atas, jenisnya dapat berupa 0b0011 atau 0b0100.

  • 0b0011 - Gunakan bila Penyedia ingin Pencari menunjukkan indikasi di UI nilai baterai;
  • 0b0100 - Gunakan saat Penyedia ingin Pencari untuk menyembunyikan indikasi jika sudah ditampilkan.

Salah satu kasus penggunaan umum untuk ini adalah menggunakan 0b0011 saat kasus telah dibuka dan 0b0100 saat tunas telah dikeluarkan dari casing atau telah ditutup lagi.

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

Untuk mencegah pelacakan, Penyedia tidak boleh menyertakan data baterai mentah dalam iklan. Sebaliknya, ini dapat dikirim melalui RFCOMM ketika terhubung ke Pencari, lihat Aliran Pesan: Informasi Perangkat.