জটিলতা সম্পর্কে

কমপ্লিকেশন হল এমন যেকোনও ফিচার যা ওয়াচফেসে সময় ছাড়াও দেখানো হয়। যেমন, ব্যাটারি ইন্ডিকেটর হল একটি জটিলতা। Complications API ওয়াচফেস ও ডেটা সোর্স অ্যাপ, দুটির জন্যই ব্যবহার করা হয়।

এই ডকুমেন্টের বাকি অংশে ডেটা সোর্স, ওয়াচফেস এবং কমপ্লিকেশন টাইপ সম্পর্কে বর্ণনা করা হয়েছে।

কমপ্লিকেশন ডেটা সোর্স

যেসব অ্যাপ ব্যাটারি লেভেল, আবহাওয়া বা স্টেপ কাউন্টের মতো ডেটা কমপ্লিকেশনের জন্য ওয়াচ ফেসে প্রদান করে, সেগুলিকে কমপ্লিকেশন ডেটা সোর্স বলা হয়। এইসব ডেটা সোর্স 'র' ডেটা সরবরাহ করে এবং ওয়াচফেসে কীভাবে তাদের ডেটা রেন্ডার করা হবে তা নিয়ন্ত্রণ করার জন্য দায়িত্বপ্রাপ্ত নয়। ওয়াচফেসে ডেটা প্রদান করে এমন অ্যাপ লেখার ব্যাপারে জানতে, কমপ্লিকেশনে ডেটা দেখানো দেখুন।

নিচের ডায়াগ্রাম থেকে বোঝা যাবে যে Wear OS by Google কীভাবে সোর্স থেকে ওয়াচফেসে ডেটা ফ্লো করে।

কমপ্লিকেশন ডেটা ফ্লো
ছবি ১. কমপ্লিকেশন ডেটার ফ্লো।

ওয়াচফেসে কমপ্লিকেশন

ওয়াচফেস জটিল ডেটা সোর্স থেকে ডেটা গ্রহণ করে, যা তাদের অন্তর্নিহিত ডেটা পাওয়ার জন্য কোডের প্রয়োজন ছাড়াই জটিলতা অন্তর্ভুক্ত করতে দেয়। ওয়াচফেস ডেটা কীভাবে রেন্ডার করা হবে তার উপর নিয়ন্ত্রণ বজায় রাখে, যাতে তারা ডেটা স্বাভাবিকভাবে তাদের ডিজাইনের সাথে ইন্টিগ্রেট করতে পারে। আরও তথ্যের জন্য, কমপ্লিকেশন সম্পর্কে ডিজাইন গাইড দেখুন।

ওয়াচফেসে কীভাবে কমপ্লিকেশন যোগ করতে হয় তা জানতে, ওয়াচফেসে কমপ্লিকেশন যোগ করুন দেখুন।

জটিলতার ধরন

কমপ্লিকেশন বা ডেটা সোর্স থেকে পাওয়া ডেটা কী ধরনের হবে তা কমপ্লিকেশনের ধরন থেকে বোঝা যায়। যেমন, ডেটাতে মূলত ছোট স্ট্রিং থাকলে SHORT_TEXT টাইপ ব্যবহার করুন। একটি ComplicationData অবজেক্টে সবসময় একটিই কমপ্লিকেশন টাইপ থাকে যা প্রয়োজনীয় ও ঐচ্ছিক ফিল্ড নির্ধারণ করে। ফাঁকা রাখা যাবে না এমন ফিল্ড ডেটার প্রাথমিক অংশকে দেখায়; বেশিরভাগ ধরন ফাঁকা রাখা যাবে না এমন ফিল্ড থেকে তাদের নাম নেয়।

ডেটা সোর্স ওয়াচফেসের থেকে আলাদাভাবে কমপ্লিকেশন টাইপ ব্যবহার করে:

  • ডেটা সোর্স, সরবরাহ করার জন্য জটিল ডেটার ধরন বেছে নেয়, যার মধ্যে রয়েছে, সরবরাহ করার জন্য সেই ধরনের কোন ঐচ্ছিক ফিল্ড এবং কতগুলি বিভিন্ন ধরন সাপোর্ট করা যেতে পারে। যেমন, স্টেপ-কাউন্ট সোর্স RANGED_VALUE এবং SHORT_TEXT ধরনের ডেটা সাপোর্ট করতে পারে, এবং পরবর্তী-মিটিং সোর্স SHORT_TEXT এবং LONG_TEXT ধরনের ডেটা সাপোর্ট করতে পারে।
  • আপনার ওয়াচফেসে কতগুলি কমপ্লিকেশন অন্তর্ভুক্ত করবেন এবং কোন ধরনের কমপ্লিকেশন সাপোর্ট করবে তা বেছে নিতে পারবেন। যেমন, ওয়াচফেসে ডায়াল কমপ্লিকেশন SHORT_TEXT, SMALL_IMAGE এবং RANGED_VALUE ধরনের হতে পারে। ওয়াচফেসের গেজ শুধুমাত্র RANGED_VALUE ধরনের হতে পারে।

বিভিন্ন ধরনের জটিলতা এবং প্রতিটি ধরনের দ্বারা সমর্থিত ফিল্ড সম্পর্কে আরও জানতে, জটিলতার ধরন দেখুন।