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

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

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

Complication উপাদানটি আপনাকে একটি একক ওয়াচফেসের মধ্যে আটটি জটিলতা সংজ্ঞায়িত করতে দেয়। এই উপাদানটি আপনাকে ঘড়ির মুখের কোথায় প্রতিটি জটিলতা প্রদর্শিত হবে তা নির্ধারণ করতেও দেয়।

আরও তথ্যের জন্য, GitHub-এ WatchFaceFormat নমুনাটি দেখুন।

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

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





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

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

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

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

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

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

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

আপডেট অনুরোধের প্রতিক্রিয়ায় উৎসগুলি TYPE_EMPTY পাঠাতে পারে না। পরিবর্তে TYPE_NO_DATA পাঠান।

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

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

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

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

TYPE_NO_DATA সিস্টেম দ্বারা প্রেরিত যখন একটি জটিলতা যার একটি উৎস আছে তা উৎস থেকে প্রকৃত তথ্য প্রাপ্তির আগে জটিলতাটি দূর করতে সক্রিয় হয়।

যদি উৎসের কাছে পাঠানোর জন্য প্রকৃত তথ্য না থাকে, তাহলে উৎস দ্বারা পাঠানো যেতে পারে।

কিছু ডিভাইসে, ঘড়ির মুখ এবং জটিলতাগুলির জন্য অবশ্যই ঘড়ির মুখের ফর্ম্যাট ব্যবহার করতে হবে

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

  • Wear OS 4 বা তার আগের ভার্সন চালানো ডিভাইস।
  • যেসব ডিভাইস Wear OS 5-এ OTA আপগ্রেড পেয়েছে।

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

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

{% অক্ষরে অক্ষরে %} {% এন্ডভারব্যাটিম %} {% অক্ষরে অক্ষরে %} {% এন্ডভারব্যাটিম %}