এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

অ্যাপ্লিকেশান এবং সিস্টেম অ্যাম্বিয়েন্ট মোড সর্বদা চালু থাকে৷

এই নির্দেশিকায় ব্যাখ্যা করা হয়েছে কীভাবে আপনার অ্যাপকে সর্বদা-চালু (always-on) রাখবেন, পাওয়ার স্টেট পরিবর্তনে কীভাবে প্রতিক্রিয়া জানাবেন, এবং ব্যাটারি সাশ্রয়ের পাশাপাশি ব্যবহারকারীকে একটি ভালো অভিজ্ঞতা দেওয়ার জন্য অ্যাপ্লিকেশনের আচরণ কীভাবে পরিচালনা করবেন।

কোনো অ্যাপকে ক্রমাগত দৃশ্যমান রাখলে তা ব্যাটারির আয়ুর ওপর উল্লেখযোগ্য প্রভাব ফেলে, তাই এই ফিচারটি যোগ করার সময় এর বিদ্যুৎ খরচের বিষয়টি বিবেচনা করুন।

মূল ধারণা

যখন একটি Wear OS অ্যাপ পূর্ণ স্ক্রিনে প্রদর্শিত হয়, তখন এটি দুটি পাওয়ার স্টেটের একটিতে থাকে:

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

অপারেটিং সিস্টেম এই অবস্থাগুলোর মধ্যে পরিবর্তন নিয়ন্ত্রণ করে।

অলওয়েজ-অন অ্যাপ হলো এমন একটি অ্যাপ্লিকেশন যা ইন্টারেক্টিভ এবং অ্যাম্বিয়েন্ট উভয় অবস্থাতেই কন্টেন্ট প্রদর্শন করে।

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

সিস্টেম পরিবর্তন এবং ডিফল্ট আচরণ

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

টাইমআউট #১: ইন্টারেক্টিভ থেকে অ্যাম্বিয়েন্ট অবস্থায়: ব্যবহারকারী কিছুক্ষণ নিষ্ক্রিয় থাকার পর, ডিভাইসটি অ্যাম্বিয়েন্ট অবস্থায় প্রবেশ করে।
টাইমআউট #২: ওয়াচ ফেসে প্রত্যাবর্তন: আরও কিছুক্ষণ নিষ্ক্রিয় থাকার পর, সিস্টেম বর্তমান অ্যাপটি লুকিয়ে ওয়াচ ফেস প্রদর্শন করতে পারে।

সিস্টেমটি প্রথমবার অ্যাম্বিয়েন্ট স্টেটে প্রবেশ করার ঠিক পরেই, এর ডিফল্ট আচরণ Wear OS ভার্সন এবং আপনার অ্যাপের কনফিগারেশনের উপর নির্ভর করে:

Wear OS 5 এবং এর পূর্ববর্তী সংস্করণগুলিতে , সিস্টেম আপনার পজ করা অ্যাপ্লিকেশনের একটি ঝাপসা স্ক্রিনশট প্রদর্শন করে, যার উপরে সময়টি বসানো থাকে। নিম্নলিখিত ফ্লোচার্টে "AOD Lite" নোড দ্বারা এই অবস্থাটি দেখানো হয়েছে।
Wear OS 6 এবং এর পরবর্তী সংস্করণগুলিতে , যদি কোনো অ্যাপ SDK 36 বা তার নতুন সংস্করণকে টার্গেট করে, তবে সেটিকে অলওয়েজ-অন (always-on) হিসেবে গণ্য করা হয়। ডিসপ্লেটি অনুজ্জ্বল হয়ে যায়, কিন্তু অ্যাপ্লিকেশনটি চলতে থাকে এবং দৃশ্যমান থাকে। (আপডেটগুলি প্রতি মিনিটে একবারের মতো বিরলও হতে পারে।) এই অবস্থাটি নিম্নলিখিত ফ্লোচার্টে "Global AOD" নোড দ্বারা উপস্থাপিত হয়েছে।

পারিপার্শ্বিক অবস্থার জন্য আচরণ কাস্টমাইজ করুন

ডিফল্ট সিস্টেম আচরণ নির্বিশেষে, সমস্ত Wear OS সংস্করণে আপনি Ambient অবস্থায় থাকাকালীন Jetpack Compose on Wear OS-এ LocalAmbientModeManager ব্যবহার করে স্টেট ট্রানজিশন পর্যবেক্ষণ করার মাধ্যমে আপনার অ্যাপের চেহারা বা আচরণ কাস্টমাইজ করতে পারেন। এই স্টেটটি নিম্নলিখিত ফ্লোচার্টে "Ambiactive Mode" নোড দ্বারা উপস্থাপিত হয়।

পারিপার্শ্বিক অবস্থা পর্যবেক্ষণ করুন

Wear OS-এ Jetpack Compose-এ অ্যাম্বিয়েন্ট মোড ইভেন্টগুলিতে প্রতিক্রিয়া জানাতে:

সিস্টেমের অ্যাম্বিয়েন্ট মোড স্ট্যাটাসের পরিবর্তন পর্যবেক্ষণ করতে এবং সেই অনুযায়ী আপনার কম্পোজেবলগুলো সামঞ্জস্য করতে LocalAmbientModeManager ব্যবহার করুন। আপনার কম্পোনেন্টটিকে AmbientMode.Ambient স্টেটে একটি কম-পাওয়ার মোডে সামঞ্জস্য করতে এবং AmbientMode.Interactive স্টেটে এটিকে একটি সম্পূর্ণ ইন্টারেক্টিভ ডিসপ্লেতে ফিরিয়ে আনতে কনফিগার করুন।

// In a production application, the AmbientModeManager should be instantiated and provided at
// the highest level of the Compose hierarchy (typically in the host Activity's setContent
// block) using a CompositionLocalProvider. This ensures proper lifecycle management and
// broad accessibility.

// For this self-contained demo, AmbientModeManager is created and provided locally:
val activityAmbientModeManager = rememberAmbientModeManager()
CompositionLocalProvider(LocalAmbientModeManager provides activityAmbientModeManager) {
    val ambientModeManager = LocalAmbientModeManager.current
    val ambientMode = ambientModeManager?.currentAmbientMode

    if (ambientModeManager != null) {
        ambientModeManager.AmbientTickEffect {
            // While device is in ambient mode, update properties every minute or so
            // ...
        }
    }

    // ...
        val ambientModeName =
            when (ambientMode) {
                is AmbientMode.Interactive -> "Interactive"
                is AmbientMode.Ambient -> "Ambient"
                else -> "Unknown"
            }

        Text(text = "$ambientModeName Mode")
        // ...
}LocalAmbientModeManager.kt

যেসব ডেভেলপার Jetpack Compose ব্যবহার করেন, তারা LocalAmbientModeManager ব্যবহার করুন, যা এই প্যাটার্নটির বাস্তবায়নকে সহজ করে তোলে।

পারিপার্শ্বিক আচরণের ফ্লোচার্ট

নিম্নলিখিত ফ্লোচার্টটি ব্যাখ্যা করে যে, ডিভাইসের Wear OS সংস্করণ, আপনার অ্যাপের targetSdkVersion এবং এটি AmbientLifecycleCallback প্রয়োগ করে কিনা, তার উপর ভিত্তি করে সিস্টেমটি কীভাবে পারিপার্শ্বিক আচরণ নির্ধারণ করে।

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

স্ক্রিন চালু থাকার সময়কাল নিয়ন্ত্রণ করুন

আপনার অ্যাপটি স্ক্রিনে কতক্ষণ থাকবে তা কীভাবে নিয়ন্ত্রণ করবেন, তা নিম্নলিখিত বিভাগগুলিতে বর্ণনা করা হয়েছে।

চলমান কার্যকলাপ বা লাইভ আপডেট চলাকালীন ওয়াচ ফেসে ফিরে আসা প্রতিরোধ করুন।

অ্যাম্বিয়েন্ট স্টেটে (টাইমআউট #২) একটি নির্দিষ্ট সময় থাকার পর, সিস্টেমটি সাধারণত ওয়াচ ফেসে ফিরে আসবে। ব্যবহারকারী সিস্টেম সেটিংসে টাইমআউটের সময়কাল নির্ধারণ করতে পারেন। কিছু নির্দিষ্ট ব্যবহারের ক্ষেত্রে, যেমন কোনো ব্যবহারকারীর ওয়ার্কআউট ট্র্যাক করার জন্য, একটি অ্যাপকে আরও বেশি সময় ধরে দৃশ্যমান থাকার প্রয়োজন হতে পারে।

Wear OS 5 এবং এর পরবর্তী সংস্করণগুলিতে, আপনি একটি 'Ongoing Activity' প্রয়োগ করে এটি প্রতিরোধ করতে পারেন। যদি আপনার অ্যাপ কোনো চলমান ইউজার টাস্ক, যেমন একটি ওয়ার্কআউট সেশন, সম্পর্কে তথ্য প্রদর্শন করে, তবে টাস্কটি শেষ না হওয়া পর্যন্ত আপনার অ্যাপটিকে দৃশ্যমান রাখতে আপনি 'Ongoing Activity' API ব্যবহার করতে পারেন। যদি কোনো ইউজার নিজে থেকে ওয়াচফেসে ফিরে আসেন, তবে 'Ongoing Activity' ইন্ডিকেটরটি তাদের জন্য এক-ট্যাপে আপনার অ্যাপে ফিরে আসার একটি উপায় প্রদান করে।

বিকল্পভাবে, Wear OS 7 এবং এর পরবর্তী সংস্করণগুলিতে, আপনি Ongoing Activity-এর পরিবর্তে Live Update ব্যবহার করতে পারেন। পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যতা বজায় রাখার জন্য, Wear OS 6 বা তার পূর্ববর্তী সংস্করণ চালিত ডিভাইসগুলিতে Ongoing Activity সমর্থন করা অব্যাহত রাখুন।

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

  

     

   

//

    



val activityIntent = Intent(this, AlwaysOnActivity::class.java).apply { flags = Intent.FLAG_ACTIVITY_SINGLE_TOP } >val pendingIntent = PendingIntent.getActivity( this, 0, activityIntent, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE, ) >val notificationBuilder = NotificationCompat.Builder(this, CHANNEL_ID) // ... // ... .setOngoing(true) ... >val ongoingActivity = OngoingActivity.Builder(applicationContext, NOTIFICATION_ID, notificationBuilder) // ... // ... .setTouchIntent(pendingIntent) .build() ongoingActivity.apply(applicationContext) >val notification = notificationBuilder.build()AlwaysOnService.kt

স্ক্রিন চালু রাখুন এবং পারিপার্শ্বিক অবস্থা প্রতিরোধ করুন

বিরল ক্ষেত্রে, ডিভাইসটিকে অ্যাম্বিয়েন্ট স্টেটে প্রবেশ করা থেকে সম্পূর্ণভাবে বিরত রাখার প্রয়োজন হতে পারে। অর্থাৎ, টাইমআউট #১ এড়ানোর জন্য। এটি করার জন্য, আপনি keepScreenOn মডিফায়ারটি ব্যবহার করতে পারেন। এটি একটি ওয়েক লক হিসেবে কাজ করে, যা ডিভাইসটিকে ইন্টারেক্টিভ স্টেটে রাখে। এটি অত্যন্ত সতর্কতার সাথে ব্যবহার করুন, কারণ এটি ব্যাটারির আয়ুকে মারাত্মকভাবে প্রভাবিত করে।

অ্যাম্বিয়েন্ট মোডের জন্য সুপারিশসমূহ

অ্যাম্বিয়েন্ট মোডে সেরা ব্যবহারকারীর অভিজ্ঞতা প্রদান করতে এবং শক্তি সাশ্রয় করতে, এই ডিজাইন নির্দেশিকাগুলো অনুসরণ করুন। এই সুপারিশগুলো বিভ্রান্তিকর তথ্য প্রতিরোধ করে ও দৃশ্যমান জঞ্জাল কমিয়ে একটি সুস্পষ্ট ব্যবহারকারীর অভিজ্ঞতাকে অগ্রাধিকার দেয় এবং একই সাথে ডিসপ্লের শক্তি অপ্টিমাইজ করে।

ভিজ্যুয়াল জঞ্জাল কমান এবং ডিসপ্লে পাওয়ার সাশ্রয় করুন। একটি পরিচ্ছন্ন, মিনিমালিস্ট ইউআই ব্যবহারকারীকে সংকেত দেয় যে অ্যাপটি কম-পাওয়ার অবস্থায় আছে এবং উজ্জ্বল পিক্সেল সীমিত করার মাধ্যমে উল্লেখযোগ্য পরিমাণে ব্যাটারি সাশ্রয় করে।
- স্ক্রিনের কমপক্ষে ৮৫% কালো রাখুন।
- শুধুমাত্র সবচেয়ে গুরুত্বপূর্ণ তথ্য দেখান এবং গৌণ বিবরণ ইন্টারেক্টিভ ডিসপ্লেতে সরিয়ে দিন।
- বড় আইকন বা বাটনের ক্ষেত্রে সলিড ফিলের পরিবর্তে আউটলাইন ব্যবহার করুন।
- একরঙা বড় ব্লক এবং অকার্যকর ব্র্যান্ডিং বা ব্যাকগ্রাউন্ড ছবি পরিহার করুন।
পুরনো ডাইনামিক ডেটা পরিচালনা করুন
- শক্তি সাশ্রয়ের জন্য AmbientTickEffect কলব্যাকটি শুধুমাত্র নির্দিষ্ট সময় পর পর—সাধারণত প্রতি মিনিটে একবার—চালু করা হয়। এই সীমাবদ্ধতার কারণে, যে কোনো ডেটা যা ঘন ঘন পরিবর্তিত হয়—যেমন স্টপওয়াচ, হার্ট রেট বা ওয়ার্কআউটের দূরত্ব—তা আপডেটের মধ্যবর্তী সময়ে পুরনো হয়ে যায়। বিভ্রান্তিকর এবং ভুল তথ্য প্রদর্শন এড়াতে, এই লাইভ মানগুলিকে স্ট্যাটিক প্লেসহোল্ডার কন্টেন্ট দিয়ে প্রতিস্থাপন করুন, যেমন -- ।
একটি সামঞ্জস্যপূর্ণ বিন্যাস বজায় রাখুন
- একটি মসৃণ রূপান্তর তৈরি করতে ইন্টারেক্টিভ এবং অ্যাম্বিয়েন্ট মোড জুড়ে উপাদানগুলিকে একই অবস্থানে রাখুন।
- সর্বদা সময় দেখান।
প্রসঙ্গ সম্পর্কে সচেতন হন
- ডিভাইসটি অ্যাম্বিয়েন্ট মোডে প্রবেশ করার সময় যদি ব্যবহারকারী কোনো সেটিংস বা কনফিগারেশন স্ক্রিনে থাকেন, তাহলে সেটিংস ভিউয়ের পরিবর্তে আপনার অ্যাপ থেকে আরও প্রাসঙ্গিক একটি স্ক্রিন দেখানোর কথা বিবেচনা করুন।
ডিভাইস-নির্দিষ্ট প্রয়োজনীয়তাগুলি পরিচালনা করুন
- currentAmbientMode থেকে ফেরত আসা AmbientMode অবজেক্টে:
  - যদি isLowBitAmbientSupported true হয়, তাহলে যেখানে সম্ভব অ্যান্টি-অ্যালিয়াসিং নিষ্ক্রিয় করুন।
  - যদি isBurnInProtectionRequired true হয়, তাহলে স্ক্রিন বার্ন-ইন প্রতিরোধ করতে UI এলিমেন্টগুলোকে পর্যায়ক্রমে সামান্য সরান এবং নিরেট সাদা অংশ পরিহার করুন।

ডিবাগিং এবং টেস্টিং

ডিভাইস অ্যাম্বিয়েন্ট মোডে থাকাকালীন আপনার অ্যাপটি কীভাবে আচরণ করে, তা তৈরি বা পরীক্ষা করার সময় এই adb কমান্ডগুলো কাজে লাগতে পারে:

# put device in ambient mode if the always on display is enabled in settings
# (and not disabled by other settings, such as theatre mode)
$ adb shell input keyevent KEYCODE_SLEEP

# put device in interactive mode
$ adb shell input keyevent KEYCODE_WAKEUP

উদাহরণ: ওয়ার্কআউট অ্যাপ

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

এটি অর্জন করতে, ডেভেলপারকে নিম্নলিখিত কাজগুলো করতে হবে:

ইন্টারেক্টিভ এবং অ্যাম্বিয়েন্ট অবস্থার মধ্যে UI পরিবর্তন, যেমন স্ক্রিন ম্লান করা এবং অপ্রয়োজনীয় ডেটা মুছে ফেলার জন্য LocalAmbientModeManager ব্যবহার করুন।
সর্বোত্তম অনুশীলন অনুসরণ করে অ্যাম্বিয়েন্ট স্টেটের জন্য একটি নতুন স্বল্প-শক্তিসম্পন্ন লেআউট তৈরি করুন।
ওয়ার্কআউট চলাকালীন সিস্টেমকে ওয়াচ ফেসে ফিরে আসা থেকে বিরত রাখতে অনগোয়িং অ্যাক্টিভিটি এপিআই (অথবা Wear OS 7 এবং তার পরবর্তী সংস্করণগুলোতে লাইভ আপডেট ) ব্যবহার করুন।

সম্পূর্ণ বাস্তবায়নের জন্য, গিটহাবে থাকা কম্পোজ-ভিত্তিক এক্সারসাইজ স্যাম্পলটি দেখুন। এই স্যাম্পলটি কম্পোজে অ্যাম্বিয়েন্ট মোড হ্যান্ডলিং সহজ করার জন্য LocalAmbientModeManager কম্পোজেবলটির ব্যবহারও প্রদর্শন করে।