ওয়াচ ফেস ফরম্যাট সেটআপ

দ্রষ্টব্য : এই পৃষ্ঠাটি আপনাকে আপনার ঘড়ির মুখের কনফিগারেশন ম্যানুয়ালি পরিচালনা করার প্রক্রিয়ার একটি ধাপ দেখায়। আপনি যদি পরিবর্তে একটি WYSIWYG (আপনি যা দেখেন তাই আপনি যা পান) স্টাইলের টুল ব্যবহার করে আপনার ঘড়ির মুখ ডিজাইন করতে চান, প্রথমে ওয়াচ ফেস স্টুডিও গাইডগুলি দেখুন।

ওয়াচ ফেস ফরম্যাট ব্যবহার করে একটি ঘড়ির মুখ কনফিগার করার জন্য আপনাকে যে সরঞ্জামগুলির প্রয়োজন, প্রকল্পের কাঠামোর উপর কিছু পরামর্শ এবং সেই কাঠামো তৈরি করতে সরঞ্জামগুলি প্রয়োগ করার জন্য একটি ধাপে ধাপে নির্দেশিকা এই নির্দেশিকাটিতে রয়েছে৷

পূর্বশর্ত

ওয়াচ ফেস ফরম্যাট ব্যবহার করার জন্য আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট প্রস্তুত করতে, নিম্নলিখিত সেটআপ ধাপগুলি সম্পূর্ণ করুন:

  1. Android 14 (API লেভেল 34) বা তার বেশির জন্য SDK ইনস্টল করুন। যদি আপনার ঘড়ির মুখটি সংস্করণ 2 এর জন্য নির্দিষ্ট বৈশিষ্ট্য বা আচরণের উপর নির্ভর না করে, তাহলে আপনি পরিবর্তে Android 13 (API স্তর 33) এর জন্য SDK ইনস্টল করতে পারেন।

    SDK-এ aapt2 এবং android.jar সহ অন্যান্য প্রয়োজনীয় টুল রয়েছে।

  2. বিকল্পভাবে , Android স্টুডিও ইনস্টল করুন, যা এই সরঞ্জামগুলিও প্রদান করতে পারে৷

প্রকল্প কাঠামো

আপনি যখন ওয়াচ ফেস ফর্ম্যাট ব্যবহার করে এমন একটি কাস্টম ওয়াচ ফেস তৈরি করেন, তখন কাস্টম ওয়াচ ফেস ফাইলটি অন্তর্ভুক্ত করে এমন অ্যান্ড্রয়েড অ্যাপ বান্ডেল অবশ্যই আপনার Wear OS অ্যাপের যুক্তিযুক্ত Android অ্যাপ বান্ডেল থেকে সম্পূর্ণ আলাদা হতে হবে। Google Play সহ কিছু অ্যাপ স্টোর আপনাকে একটি Android অ্যাপ বান্ডেল আপলোড করতে বাধা দেয় যাতে Wear OS লজিক এবং একটি কাস্টম ঘড়ির মুখ উভয়ই রয়েছে।

ঘড়ির মুখের বান্ডিল তৈরি করুন

একটি ওয়াচ ফেস ফাইলের বৈশিষ্ট্যযুক্ত একটি অ্যান্ড্রয়েড অ্যাপ বান্ডেল তৈরি করতে, নিম্নলিখিত বিভাগে দেখানো পদক্ষেপগুলি সম্পূর্ণ করুন৷

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

আপনার নতুন অ্যাপের ম্যানিফেস্ট ফাইলে ( AndroidManifest.xml ), একটি অ্যাপ্লিকেশন প্রপার্টি যোগ করুন যা আপনার ওয়াচ ফেস ফরম্যাটের ব্যবহার নির্দেশ করে। আপনি Wear OS 5 বা উচ্চতর ডিভাইসের জন্য আপনার ঘড়ির মুখের অ্যাক্সেস সীমাবদ্ধ করতে না চাইলে, 2টি ভিন্ন ওয়াচ ফেস APK তৈরি করুন, একটি যেটি সংস্করণ 2 সমর্থন করে এবং একটি সংস্করণ 1 সমর্থন করে। আপনার অ্যাপের সংস্করণগুলি কীভাবে কনফিগার করবেন সে সম্পর্কে আরও জানুন।

<manifest ...>
    <!--
        Use SDK version 34 for version 2 of WFF, and SDK version 33 for version
        1 of WFF
    -->
    <uses-sdk
        android:minSdkVersion="34"
        android:targetSdkVersion="34" />

    <!--
        WFF is a resource-only format, so the hasCode attribute should be set to
        false to reflect this.
    -->
    <application
        android:label="@string/watch_face_name"
        android:hasCode="false"
        ...>
        <meta-data android:name="com.google.android.wearable.standalone"
            android:value="true" />
        <property
            android:name="com.google.wear.watchface.format.version"
            android:value="2" />
    </application>
</manifest>

ঘড়ির মুখের মেটাডেটা ঘোষণা করুন

আপনার অ্যাপের res/xml রিসোর্স ডিরেক্টরিতে, watch_face_info.xml নামে একটি নতুন ফাইল তৈরি করুন। এখানে আপনি আপনার ঘড়ির মুখের মেটাডেটা সংজ্ঞায়িত করেন:

<?xml version="1.0" encoding="utf-8"?>
<WatchFaceInfo>

    <Preview value="@drawable/watch_face_preview" />
    <Category value="CATEGORY_EMPTY" />
    <AvailableInRetail value="true" />
    <MultipleInstancesAllowed value="true" />
    <Editable value="true" />
</WatchFaceInfo>

এই ফাইলের ক্ষেত্রগুলি নিম্নলিখিত বিবরণগুলি উপস্থাপন করে:

Preview
ঘড়ির মুখের একটি প্রিভিউ ইমেজ ধারণ করে এমন অঙ্কনযোগ্য উল্লেখ করে।
Category

ঘড়ির মুখের বিভাগ সংজ্ঞায়িত করে। একটি স্ট্রিং বা একটি স্ট্রিংয়ের একটি রেফারেন্স হতে হবে, যেমন @string/ref_name । প্রতিটি ডিভাইস প্রস্তুতকারক ঘড়ির মুখের বিভাগগুলির নিজস্ব সেট সংজ্ঞায়িত করতে পারে।

ডিফল্ট মান: empty_category_meta , যা ঘড়ির মুখ চয়নকারী দৃশ্যের নীচে অন্যান্য "খালি বিভাগ" ঘড়ির মুখগুলির সাথে এই ঘড়িটির মুখকে একত্রিত করে৷

AvailableInRetail

ঘড়ির মুখ ডিভাইসের খুচরা ডেমো মোডে উপলব্ধ কিনা। একটি বুলিয়ান মান বা একটি বুলিয়ান মানের রেফারেন্স হতে হবে যেমন @bool/watch_face_available_in_retail ।

ডিফল্ট মান: false

MultipleInstancesAllowed

ঘড়ির মুখে একাধিক পছন্দ থাকতে পারে কিনা। একটি বুলিয়ান মান, অথবা @bool/watch_face_multiple_instances_allowed এর মতো একটি বুলিয়ান মানের রেফারেন্স হতে হবে।

ডিফল্ট মান: false

Editable

ঘড়ির মুখটি সম্পাদনাযোগ্য কিনা, যার অর্থ ঘড়ির মুখের একটি সেটিং বা কমপক্ষে একটি অ-নির্ধারিত জটিলতা রয়েছে। এটি পছন্দের তালিকায় ঘড়ির মুখের জন্য সম্পাদনা বোতামটি দেখানো বা লুকানোর জন্য ব্যবহৃত হয়।

ডিফল্ট মান: মিথ্যা

ঘড়ির মুখের নাম ঘোষণা করুন

আপনার অ্যাপের ম্যানিফেস্ট ফাইলে ( AndroidManifest.xml ), আপনার ঘড়ির মুখের নামের সাথে android:label অ্যাট্রিবিউট সেট করুন:

<application android:label="@string/watch_face_name" >

ঘড়ির মুখের বিবরণ ঘোষণা করুন

একটি মৌলিক WFF ঘড়ির মুখের নথির গঠন নিম্নরূপ:

<WatchFace width="450" height="450">
  <Scene>
    <!-- Content to be rendered -->
  </Scene>
</WatchFace>

আপনার ঘড়ির মুখ তৈরি করার সময় এই XML ফাইলটি res/raw/watchface.xml হিসাবে তৈরি করুন, যদি একটি একক ঘড়ির মুখ দিয়ে কাজ করেন। বিভিন্ন স্ক্রিনের আকার এবং মাপ সমর্থন করতে, একাধিক আকার এবং আকারের জন্য সমর্থন ঘোষণা করুন ৷

মূল উপাদানটি সর্বদা WatchFace । height এবং width আপনার ঘড়ির মুখে ব্যবহারের জন্য স্থানাঙ্কের স্থানের সীমা নির্ধারণ করে এবং ঘড়ির মুখটি যে ডিভাইসে ব্যবহার করা হচ্ছে তার সাথে মানানসই করার জন্য স্কেল করা হয়; height এবং width প্রকৃত পিক্সেল প্রতিনিধিত্ব করে না।

ওয়াচ ফেস ফরম্যাট আপনার ঘড়ির মুখ সম্পর্কে বিভিন্ন বিবরণ সংগঠিত করে:

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

বৈশিষ্ট্যগুলি দৃঢ়ভাবে টাইপ করা হয় এবং একটি ঘড়ির মুখ তৈরি করার সময় বেশিরভাগ ত্রুটির উত্স এড়াতে ফ্রিকোয়েন্সি এবং বৈধ মানগুলির জন্য নির্দেশিকা রয়েছে৷

ঘড়ির মুখের আকারের জন্য সমর্থন ঘোষণা করুন (ঐচ্ছিক)

আপনি বিভিন্ন আকারের ঘড়ির মুখের জন্য ভিন্ন আচরণ সমর্থন করতে চাইলেই এই পদক্ষেপটি প্রয়োজনীয়। আপনি যদি ঘড়ির আকারের সাথে আপনার ঘড়ির মুখের আকারের জন্য খুশি হন তবে আপনি এই পদক্ষেপটি এড়িয়ে যেতে পারেন।

আপনার অ্যাপের res/xml রিসোর্স ডিরেক্টরিতে, আপনি watch_face_shapes.xml এ সমর্থন করেন এমন ঘড়ির মুখের আকারের সেট ঘোষণা করুন :

<WatchFaces>

    <WatchFace shape="CIRCLE" width="300" height="300"
               file="@raw/watchface"/>
    <WatchFace shape="CIRCLE" width="450" height="450"
               file="@raw/watchface_large_circle"/>

    <!-- Remove any references to rectangular watch faces -->
    <WatchFace shape="RECTANGLE" width="380" height="400"
               file="@raw/watchface_rectangle"/>
</WatchFaces>

তারপর, প্রতিটি ঘড়ির মুখের আকারের জন্য আপনার ঘড়ির মুখের চেহারা এবং আচরণ সংজ্ঞায়িত করুন। আপনি যদি একটি আকার ফাইল সংজ্ঞায়িত না করেন, তাহলে আপনাকে শুধুমাত্র একটি ফাইল তৈরি করতে হবে, watchface.xml ।

এই বিভাগ থেকে উদাহরণ ব্যবহার করে, কাঁচা XML ফাইলগুলি হবে:

  • res/raw/watchface.xml
  • res/raw/watchface_large_circle.xml
  • res/raw/watchface_rectangle.xml

ঘড়ির মুখ প্রকাশক শনাক্ত করুন (ঐচ্ছিক)

ঐচ্ছিকভাবে, আপনার অ্যাপের ম্যানিফেস্ট ফাইলে, একটি নির্বিচারে স্ট্রিং ঘোষণা করুন যা আপনি ঘড়ির মুখের প্রকাশক, বা আপনি যে টুলের নাম এবং সংস্করণটি ব্যবহার করছেন তা সনাক্ত করতে ব্যবহার করতে পারেন:

<application ...>
    ...
    <property
        android:name="com.google.wear.watchface.format.publisher"
        android:value="<var>{toolName}-{toolVersion}</var>" />
</application>

আপনার ঘড়ির মুখের সঠিকতা এবং কর্মক্ষমতা পরীক্ষা করুন

ডেভেলপমেন্টের সময়, এবং Google Play-তে আপলোড করার আগে, আপনার ঘড়ির মুখটি ত্রুটিমুক্ত কিনা এবং এটি মেমরি ব্যবহারের সুপারিশগুলি মেনে চলছে কিনা তা পরীক্ষা করতে যাচাইকারী সরঞ্জামগুলি ব্যবহার করুন৷

আপনার ওয়াচ ফেস অ্যাপ বান্ডিল তৈরি করুন

আপনার ঘড়ির মুখ ধারণ করে এমন Android অ্যাপ বান্ডেল তৈরি করতে, গ্রেডল বিল্ড সিস্টেম ব্যবহার করুন। Gradle ব্যবহার করে কীভাবে একটি অ্যাপ তৈরি করবেন সে সম্পর্কে আরও জানুন।

এটি GitHub নমুনাগুলিতে প্রদর্শিত হয়।

{% শব্দার্থে %} {% endverbatim %} {% শব্দার্থে %} {% endverbatim %}