ব্যাটারি বিজ্ঞপ্তি
যখন কোনো প্রোভাইডার একাধিক উপাদান অন্তর্ভুক্ত করে, তখন প্রতিটি উপাদানের ব্যাটারির স্তর সম্পর্কে সিকারকে অবহিত করা উপযোগী হতে পারে। এর একটি উদাহরণ হতে পারে যখন একটি ইয়ারবাডের কেস খোলা হয় এবং সিকারের প্রতিটি বাড ও কেসটির নিজস্ব ব্যাটারির স্তর জানার প্রয়োজন হয়।
এটি সম্পন্ন করার জন্য, একজন প্রোভাইডার বিজ্ঞাপনে অতিরিক্ত তথ্য অন্তর্ভুক্ত করতে পারেন, যা "বিজ্ঞাপন: যখন আবিষ্কারযোগ্য নয় " অংশে বর্ণিত ফাস্ট পেয়ার অ্যাকাউন্ট ডেটার উপর ভিত্তি করে তৈরি।
অ্যাকাউন্ট ডেটার পাশাপাশি, প্রোভাইডারকে ব্যাটারির মান উল্লেখ করে একটি অতিরিক্ত ফিল্ড অন্তর্ভুক্ত করতে হবে। প্যাকেটটিতে নিম্নলিখিত বিষয়গুলো থাকবে:
| অক্টেট | ডেটা টাইপ | বর্ণনা | মূল্য | বাধ্যতামূলক? |
|---|---|---|---|---|
| ০ | uint8 | পতাকা | ০x০০ (সমস্ত অংশ ভবিষ্যৎ ব্যবহারের জন্য সংরক্ষিত) | বাধ্যতামূলক |
| ১ - এস | অ্যাকাউন্টের মূল তথ্য | বাধ্যতামূলক | ||
| s + 1 | uint8 | ব্যাটারির স্তরের দৈর্ঘ্য এবং প্রকার 0bLLLLTTTT
| 0bLLLLTTTT
| ঐচ্ছিক |
| s + 2 , s + 3 , s + 4 | uint8 | ব্যাটারির মান 0bSVVVVVVV
| 0bSVVVVVVV
| ঐচ্ছিক |
বিকৃতি রোধ করার জন্য, বিজ্ঞাপনে ব্যাটারির মান অন্তর্ভুক্ত করা হলে, উপরের অ্যাকাউন্ট কী ডেটা সামান্য পরিবর্তন করে তাতে ব্যাটারির তথ্যও যোগ করতে হবে। সাধারণত, অ্যাকাউন্ট কী ফিল্টার তৈরি করার সময়, অ্যাকাউন্ট কী-এর সাথে একটি সল্ট (salt) যুক্ত করে একটি ভ্যালু V তৈরি করা হয়। এর পরিবর্তে, যখন ব্যাটারির তথ্যও বিজ্ঞাপন করা হচ্ছে, তখন ভ্যালু V নিম্নলিখিতভাবে তৈরি করা উচিত:
- এমন একটি মান V তৈরি করুন, যেখানে:
- প্রথম ১৬ বাইট হলো 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];
}
ট্র্যাকিং প্রতিরোধ করার জন্য, প্রোভাইডারের বিজ্ঞাপনে সব সময় সরাসরি ব্যাটারির ডেটা অন্তর্ভুক্ত করা উচিত নয়। এর পরিবর্তে, কোনো সিকারের সাথে সংযুক্ত থাকাকালীন এটি মেসেজ স্ট্রিমের মাধ্যমে পাঠানো যেতে পারে; দেখুন মেসেজ স্ট্রিম: ডিভাইসের তথ্য ।