একটি ঘড়ির মুখে জটিলতা যোগ করুন

বিবরণ: এই ডকুমেন্টটিতে ওয়াচ ফেস ফরম্যাট ব্যবহার করে Wear OS-এ কীভাবে ওয়াচ ফেস কমপ্লিকেশন যোগ ও কনফিগার করতে হয় তা ব্যাখ্যা করা হয়েছে এবং এতে উপলব্ধ কমপ্লিকেশনের প্রকার ও তাদের ফিল্ডগুলো বিস্তারিতভাবে বর্ণনা করা হয়েছে। কীওয়ার্ড_পাবলিক: অ্যান্ড্রয়েড, Wear OS, ওয়াচ ফেস, কমপ্লিকেশন, ওয়াচ ফেস ফরম্যাট, কমপ্লিকেশন ডেটা, ডেটা সোর্স

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

ওয়াচ ফেস ফরম্যাট ব্যবহার করুন

Complication এলিমেন্টটি আপনাকে একটিমাত্র ওয়াচ ফেসে আটটি পর্যন্ত কমপ্লিকেশন নির্ধারণ করার সুযোগ দেয়। এই এলিমেন্টটি আপনাকে ওয়াচ ফেসের কোথায় প্রতিটি কমপ্লিকেশন প্রদর্শিত হবে, তাও নির্ধারণ করতে দেয়।

আরও তথ্যের জন্য, গিটহাবে থাকা WatchFaceFormat নমুনাটি দেখুন।

প্রকার এবং ক্ষেত্র

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





প্রকার প্রয়োজনীয় ক্ষেত্রসমূহ ঐচ্ছিক ক্ষেত্র নোট
SHORT_TEXT সংক্ষিপ্ত পাঠ্য আইকন
বার্ন-ইন সুরক্ষা আইকন
সংক্ষিপ্ত শিরোনাম
বিষয়বস্তুর বিবরণ

যদি আইকন বা সংক্ষিপ্ত শিরোনাম অথবা উভয়ই প্রদান করা হয়, তবে শুধুমাত্র একটি দেখানো হবে।
MONOCHROMATIC_IMAGE একরঙা ছবি
বার্ন-ইন সুরক্ষা আইকন
বিষয়বস্তুর বিবরণ

যখন লেখার প্রয়োজন হয় না তখন এটি ব্যবহৃত হয়। আইকনটি একরঙা হবে বলে আশা করা হচ্ছে এবং ওয়াচ ফেসের কারণে এতে হালকা আভা থাকতে পারে।
RANGED_VALUE মূল্য
সর্বনিম্ন মান
সর্বোচ্চ মান
একরঙা ছবি
বার্ন-ইন সুরক্ষা আইকন
সংক্ষিপ্ত পাঠ্য
সংক্ষিপ্ত শিরোনাম
রঙিন র‍্যাম্প
গতিশীল মান
বিষয়বস্তুর বিবরণ

আপনি যদি নিজের প্রোগ্রেস বার আঁকতে চান, তাহলে ComplicationDrawable ক্লাস দ্বারা প্রদত্ত প্রোগ্রেস বারটি লুকানোর জন্য isRangedValueProgressHidden() মেথডটি ব্যবহার করতে পারেন।
GOAL_PROGRESS মূল্য
লক্ষ্য মান
একরঙা ছবি
বার্ন-ইন সুরক্ষা আইকন
সংক্ষিপ্ত পাঠ্য
সংক্ষিপ্ত শিরোনাম
রঙিন র‍্যাম্প
গতিশীল মান
বিষয়বস্তুর বিবরণ

GOAL_PROGRESS-এর উদ্দেশ্য হলো পদক্ষেপ গণনার মতো বিষয়গুলোর জন্য, যেখানে মান শূন্য থেকে শুরু হয় এবং এটি লক্ষ্যমাত্রা (Target) অতিক্রম করতে পারে।
LONG_TEXT দীর্ঘ লেখা
দীর্ঘ শিরোনাম
একরঙা ছবি
বার্ন-ইন সুরক্ষা আইকন
ছোট ছবি
বিষয়বস্তুর বিবরণ
সম্পূর্ণ শিরোনাম দেওয়া থাকলে তা দেখানো হয়।
SMALL_IMAGE ছোট ছবি
বিষয়বস্তুর বিবরণ
একটি ছোট ইমেজের দুটি স্টাইলের মধ্যে একটি থাকে: ফটো স্টাইল বা আইকন স্টাইল । ফটো স্টাইলের অর্থ হলো এটি স্থানটি পূরণ করবে এবং ক্রপ করা যাবে। আইকন স্টাইলের অর্থ হলো এটি ক্রপ করা যাবে না এবং এর সাথে প্যাডিং যোগ করা যাবে। ইমেজের ভিন্নতার কারণে বার্ন-ইন প্রোটেকশন বা লো-বিট অ্যাম্বিয়েন্ট মোডযুক্ত ডিভাইসে অ্যাম্বিয়েন্ট মোডে প্রদর্শনের জন্য একটি অনুপযুক্ত ইমেজ তৈরি হতে পারে। যখন বার্ন-ইন প্রোটেকশন বা লো-বিট অ্যাম্বিয়েন্ট মোড সক্রিয় থাকে, তখন ওয়াচ ফেসটি বার্ন-ইন প্রোটেকশনের ছোট ইমেজটি ব্যবহার করতে পারে কারণ এটি নিরাপদ। অন্যথায়, যেহেতু একটি ওয়াচ ফেসের পক্ষে উপযুক্ততা নির্ধারণ করা কঠিন, তাই কোনো ইমেজ প্রদর্শন করা হয় না।
LARGE_IMAGE বড় ছবি
বিষয়বস্তুর বিবরণ
এই ছবিটি ওয়াচ ফেসটি পূরণ করার জন্য যথেষ্ট বড় হবে বলে আশা করা হচ্ছে। ছবির পরিবর্তনশীলতার কারণে বার্ন-ইন প্রোটেকশন বা লো-বিট অ্যাম্বিয়েন্ট মোডযুক্ত ডিভাইসগুলিতে অ্যাম্বিয়েন্ট মোডে প্রদর্শনের জন্য ছবিটি অনুপযুক্ত হতে পারে। যেহেতু একটি ওয়াচ ফেসের পক্ষে প্রদর্শনের উপযুক্ততা নির্ধারণ করা কঠিন, তাই বার্ন-ইন প্রোটেকশন বা লো-বিট অ্যাম্বিয়েন্ট সক্রিয় থাকলে ওয়াচ ফেসটি অ্যাম্বিয়েন্ট মোডে কোনো ছবি প্রদর্শন করে না।
WEIGHTED_ELEMENTS উপাদানের তালিকা
একরঙা ছবি
বার্ন-ইন সুরক্ষা আইকন
সংক্ষিপ্ত পাঠ্য
সংক্ষিপ্ত শিরোনাম
বিষয়বস্তুর বিবরণ
প্রতিটি এলিমেন্ট একটি রঙ এবং একটি ওজন (শূন্যের চেয়ে বেশি) নিয়ে গঠিত। রেন্ডার করার সময় এলিমেন্টটির আকার তার ওজনের সমানুপাতিক হওয়া উচিত। ওজনগুলোর যোগফল কোনো নির্দিষ্ট মানে পৌঁছানোর প্রয়োজন নেই। উল্লেখ্য, ওয়াচ ফেসগুলো ওজনযুক্ত এলিমেন্টগুলোর রঙ পরিবর্তন করতে পারে।

নিম্নলিখিত সারণীটি খালি ডেটার জন্য কমপ্লিকেশন টাইপগুলি বর্ণনা করে যা যেকোনো কমপ্লিকেশন স্লটের জন্য পাঠানো যেতে পারে। এই টাইপগুলির কোনো ফিল্ড নেই এবং সমর্থিত টাইপগুলির তালিকায় এগুলিকে অন্তর্ভুক্ত করার প্রয়োজন নেই। এই টাইপগুলি ওয়াচ ফেসগুলিকে নিম্নলিখিত তিনটি ক্ষেত্রের মধ্যে পার্থক্য করতে সক্ষম করে:

  • কোন উৎস নির্বাচন করা হয়নি
  • ব্যবহারকারী একটি স্লটের জন্য 'খালি' নির্বাচন করেছেন।
  • একটি উৎসের কাছে পাঠানোর মতো কোনো ডেটা নেই।

সোর্সগুলো আপডেট অনুরোধের জবাবে TYPE_EMPTY পাঠাতে পারে না। এর পরিবর্তে TYPE_NO_DATA পাঠান।

জটিলতার ধরণ বর্ণনা
TYPE_NOT_CONFIGURED যখন কোনো জটিলতা সক্রিয় হয় কিন্তু ব্যবহারকারী কোনো উৎস নির্বাচন করেননি এবং কোনো ডিফল্টও সেট করা হয়নি, তখন সিস্টেম থেকে এটি পাঠানো হয়।

উৎস থেকে পাঠানো যাবে না।

TYPE_EMPTY যখন কোনো কমপ্লিকেশন সক্রিয় হয় এবং ব্যবহারকারী সোর্সের পরিবর্তে 'খালি' (empty) নির্বাচন করেন, অথবা যখন ওয়াচ ফেস কোনো সোর্স নির্বাচন না করে এবং এই কমপ্লিকেশন টাইপটিকে ডিফল্ট হিসেবে বেছে নেয়, তখন সিস্টেম থেকে এটি পাঠানো হয়।

উৎস থেকে পাঠানো যাবে না।

TYPE_NO_DATA যখন কোনো উৎসযুক্ত জটিলতা সক্রিয় হয়, তখন উৎস থেকে প্রকৃত ডেটা পাওয়ার আগেই সেই জটিলতাটি দূর করার জন্য সিস্টেম থেকে এটি পাঠানো হয়।

উৎসগুলোর কাছে পাঠানোর মতো কোনো প্রকৃত ডেটা না থাকলে, তারা এটি পাঠাতে পারে।

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

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

  • যেসব ডিভাইসে Wear OS 4 বা তার পূর্ববর্তী সংস্করণ চলে।
  • যেসব ডিভাইস Wear OS 5-এ OTA আপগ্রেড পায়।

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

তবে, Wear OS 5 দিয়ে লঞ্চ হওয়া নতুন ঘড়িগুলিতে ওয়াচ ফেসে অবশ্যই ওয়াচ ফেস ফরম্যাট ব্যবহার করতে হবে। এই কারণে, আমরা আপনাকে ওয়াচ ফেস ফরম্যাট ব্যবহার শুরু করার পরামর্শ দিচ্ছি।

{% হুবহু %} {% endverbatim %} {% হুবহু %} {% endverbatim %}