কম্পোজ দিয়ে এক হাতে অঙ্গভঙ্গি

Wear OS 7 (API লেভেল 37) থেকে শুরু করে, একটি এক-হাতের জেসচার ফ্রেমওয়ার্ক এবং Wear OS-এর জন্য Compose-এর অন্তর্ভুক্ত একটি API ব্যবহারকারীদের আপনার অ্যাপের সাথে স্পর্শ ছাড়াই ইন্টারঅ্যাক্ট করার সুযোগ দেয়।

প্রাথমিকভাবে পিক্সেল ওয়াচ ডিভাইসগুলোতে (পিক্সেল ওয়াচ ৩ এবং পরবর্তী সংস্করণ) সমর্থিত হলেও, এই ফ্রেমওয়ার্কটি এখন সকল OEM-এর জন্য উপলব্ধ। এই API গ্রহণ করার মাধ্যমে, হার্ডওয়্যার সাপোর্টের প্রসারের সাথে সাথে আপনার অ্যাপের জেসচার সাপোর্টও ইকোসিস্টেম জুড়ে স্বয়ংক্রিয়ভাবে প্রসারিত হয়।

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

সমর্থিত অঙ্গভঙ্গি এবং ক্রিয়া

Wear OS জেসচার ফ্রেমওয়ার্ক দুই ধরনের জেসচার সমর্থন করে:

• প্রাথমিক ক্রিয়া (ডাবল পিঞ্চ): স্ক্রিনের প্রধান ক্রিয়াকে বোঝায়, যেমন কল রিসিভ করা বা মিডিয়া প্লেব্যাক চালু বা বন্ধ করা।
• খারিজ করার ক্রিয়া (কব্জি ঘোরানো): এর মাধ্যমে পেছনে যাওয়া, কোনো ডায়ালগ খারিজ করা, বা কোনো প্রম্পট বাতিল করা যায়।

কম্পোজে অঙ্গভঙ্গি কনফিগার করুন

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

সাধারণ Compose বিহেভিয়ারের মতোই, আপনি মডিফায়ার ব্যবহার করে UI এলিমেন্টগুলিতে এক-হাতের জেসচার সক্রিয় করতে পারেন। আপনি যে কাজটি করতে চান—হয় প্রাইমারি অথবা ডিসমিস—এবং সিস্টেম-স্তরের ব্যবহারকারীর পছন্দ, যেমন হিন্ট প্রদর্শনের ছন্দ এবং ফ্রিকোয়েন্সি মিউটিং-এর সাথে সমন্বয় করার জন্য একটি gestureId ব্যবহার করে আপনার অ্যাপের জেসচারগুলি কনফিগার করেন। আপনি একটি OneHandedGestureConfiguration অবজেক্ট তৈরি করে এই কনফিগারেশনটি প্রকাশ করেন; আমরা এটি তৈরি করার জন্য rememberOneHandedGestureConfiguration ফাংশনটি ব্যবহার করার পরামর্শ দিই। OneHandedGestureConfiguration এই আপনি জেসচারের অগ্রাধিকারও নির্ধারণ করতে পারেন।

rememberOneHandedGestureConfiguration ফাংশনটি অ্যাপ্লিকেশনের স্টেট প্রকাশ না করেই রিকম্পোজিশন জুড়ে ব্যবহারকারীর ইন্টারঅ্যাকশনের ইতিহাস ট্র্যাক করে। আপনার অ্যাপ একবার কনফিগারেশনটি তৈরি করে ফেললে, সেটিকে আপনার ইন্টারেক্টিভ কম্পোজেবলের Modifier.oneHandedGesture ফাংশনে পাস করতে হবে।

ব্যবহারকারীদের উপলব্ধ জেসচারগুলো খুঁজে পেতে সাহায্য করার জন্য, লাইব্রেরিটি OneHandedGestureClickIndicator মেথডটি প্রদান করে। এই মেথডটি একটি র‍্যাপার হিসেবে কাজ করে যা এর অন্তর্নিহিত বিষয়বস্তুকে প্রতিস্থাপন করে ব্যবহারকারীকে জানিয়ে দেয় যে একটি জেসচার অ্যাকশন উপলব্ধ আছে।

ইন্টারেক্টিভ উপাদান

বাটনের মতো কোনো ইন্টারেক্টিভ কন্ট্রোলে জেসচার সক্রিয় করতে, OneHandedGestureAction.Primary উল্লেখ করে একটি কনফিগারেশন তৈরি করুন এবং oneHandedGesture মডিফায়ারটি প্রয়োগ করুন। কন্ট্রোল এবং মডিফায়ার উভয় ক্ষেত্রেই একই MutableInteractionSource পাস করুন, যাতে জেসচার ইভেন্টগুলো কন্ট্রোলে ভিজ্যুয়াল প্রেস ফিডব্যাক প্রদর্শন করে।

জেসচার ইন্ডিকেটরটি চালু করতে, OneHandedGestureClickIndicatorState এর একটি ইনস্ট্যান্স তৈরি করুন এবং সেটিকে মনে রাখুন। এরপর, ভিজ্যুয়াল ফিডব্যাক চালু করতে, oneHandedGesture মডিফায়ার দ্বারা প্রদত্ত onGestureAvailable কলব্যাকের মধ্যে showIndicator কল করুন, যা সিস্টেমকে একটি ইন্ডিকেশন ইভেন্ট ঘটার সংকেত দেয়। একবার কল করা হলে, কম্পোনেন্টটি অল্প সময়ের জন্য তার সাধারণ কন্টেন্টকে একটি জেসচার অ্যানিমেশন দিয়ে প্রতিস্থাপন করে।

var isPlaying by remember { mutableStateOf(false) }
val onClick = { isPlaying = !isPlaying }

val gestureConfig = rememberOneHandedGestureConfiguration(
    action = OneHandedGestureAction.Primary
)
val indicatorState = remember { OneHandedGestureClickIndicatorState() }
val coroutineScope = rememberCoroutineScope()
val interactionSource = remember { MutableInteractionSource() }

Button(
    onClick = onClick,
    interactionSource = interactionSource,
    modifier = Modifier
        .fillMaxWidth()
        .oneHandedGesture(
            gestureConfiguration = gestureConfig,
            interactionSource = interactionSource,
            onGestureLabel = if (isPlaying) "pause" else "play",
            onGestureAvailable = { coroutineScope.launch { indicatorState.showIndicator() } },
            onGesture = onClick
        )
) {
    OneHandedGestureClickIndicator(
        gestureConfiguration = gestureConfig,
        state = indicatorState
    ) {
        Text(if (isPlaying) "Pause" else "Play", modifier = Modifier.fillMaxWidth())
    }
}
OneHandedGestures.kt

স্ক্রোলযোগ্য কন্টেইনার

স্ক্রোলযোগ্য স্ক্রিন বা তালিকার জন্য, OneHandedGestureAction.Primary উল্লেখ করে একটি কনফিগারেশন তৈরি করুন এবং আপনার কন্টেইনারে oneHandedGesture মডিফায়ারটি প্রয়োগ করে scrollDown মতো একটি স্ক্রোলিং হেল্পার কল করুন।

স্ক্রলিং অ্যাকশনের জন্য ভিজ্যুয়াল ফিডব্যাক দিতে, আপনি OneHandedGestureScrollIndicator ব্যবহার করতে পারেন। এই কম্পোনেন্টটি একটি সাধারণ স্ক্রল ইন্ডিকেটর হিসেবে কাজ করে যা স্ক্রলের অবস্থান দেখায়, তবে এটি ব্যবহারকারীর জন্য একটি স্ক্রল জেসচার উপলব্ধ আছে তাও নির্দেশ করতে পারে। এই ইন্ডিকেটরটি সাধারণত একটি ScreenScaffold এর scrollIndicator স্লটে পাস করা হয় এবং এটি একটি স্ক্রলযোগ্য কন্টেইনারের (যেমন TransformingLazyColumn ) স্টেটের সাথে যুক্ত থাকে। এটি তার ভিজ্যুয়াল ট্রানজিশনগুলো পরিচালনা করার জন্য একটি OneHandedGestureScrollIndicatorState ও পর্যবেক্ষণ করে।

ভিজ্যুয়াল ফিডব্যাক চালু করতে, এই স্টেটে showIndicator কল করুন—সাধারণত oneHandedGesture মডিফায়ারের onGestureAvailable কলব্যাকের ভিতরে। একবার চালু হলে, ইন্ডিকেটরটি ব্যবহারকারীকে সতর্ক করার জন্য সাময়িকভাবে তার সাধারণ ভিজ্যুয়াল স্টেটকে একটি জেসচার অ্যানিমেশন সিকোয়েন্স দিয়ে প্রতিস্থাপন করে।

val scrollState = rememberTransformingLazyColumnState()
val gestureConfig = rememberOneHandedGestureConfiguration(
    action = OneHandedGestureAction.Primary,
    priority = OneHandedGesturePriority.Scrollable
)
val indicatorState = remember(gestureConfig) { OneHandedGestureScrollIndicatorState() }
val coroutineScope = rememberCoroutineScope()

ScreenScaffold(
    scrollState = scrollState,
    scrollIndicator = {
        OneHandedGestureScrollIndicator(
            gestureConfiguration = gestureConfig,
            indicatorState = indicatorState,
            scrollState = scrollState,
            modifier = Modifier.align(Alignment.CenterEnd)
        )
    }
) { contentPadding ->
    TransformingLazyColumn(
        state = scrollState,
        contentPadding = contentPadding,
        modifier = Modifier
            .fillMaxSize()
            .oneHandedGesture(
                gestureConfiguration = gestureConfig,
                onGestureLabel = "scroll",
                onGestureAvailable = {
                    coroutineScope.launch { indicatorState.showIndicator() }
                },
                onGesture = { OneHandedGestureDefaults.scrollDown(scrollState) }
            )
    ) {
        items(10) { index ->
            Text("Item $index", modifier = Modifier.padding(8.dp))
        }
    }
}
OneHandedGestures.kt

একাধিক অঙ্গভঙ্গি একত্রিত করুন

আপনার OneHandedGestureConfiguration অবজেক্টে gesturePriority যোগ করে আপনি একই প্রাথমিক অ্যাকশন দিয়ে স্ক্রোল জেসচার এবং ক্লিক জেসচার উভয়ই কনফিগার করতে পারেন:

• OneHandedGesturePriority.Clickable (সর্বোচ্চ): Button বা Card টাইপের মতো ইন্টারেক্টিভ কন্ট্রোলগুলিতে এটি নির্ধারণ করুন, যাতে স্ক্রিনে দৃশ্যমান হলে সেগুলি জেসচার গ্রহণ করতে পারে।
• OneHandedGesturePriority.Scrollable (মাঝারি): স্ক্রোলযোগ্য বা পেজযোগ্য কন্টেইনারে এটি প্রয়োগ করুন, যাতে সেগুলো ক্লিকযোগ্য চাইল্ড কন্টেইনারের জন্য জায়গা ছেড়ে দেয়, কিন্তু কোনো ক্লিকযোগ্য কন্ট্রোল দৃশ্যমান না থাকলে স্ক্রোল করে।
• OneHandedGesturePriority.Unspecified (সর্বনিম্ন): একটি অনির্ধারিত অগ্রাধিকার। যে জেসচারের কোনো priority সেট করা নেই, তার জন্য এটি ডিফল্ট মান।

একটি ভেতরের বাটনে priority = OneHandedGesturePriority.Clickable এবং এর প্যারেন্ট লিস্টে priority = OneHandedGesturePriority.Scrollable স্পষ্টভাবে সেট করার মাধ্যমে, সিস্টেম এই জেসচার-প্রায়োরিটি আচরণটি প্রদর্শন করতে পারে। যখন ব্যবহারকারী এক-হাতের জেসচারের মাধ্যমে মূল কাজটি ট্রিগার করেন, তখন এটি প্রথমে লিস্টটি নিচে স্ক্রল করতে থাকে যতক্ষণ না বাটনটি দৃশ্যমান হয়। তারপর, এটি বাটনটির ক্লিক অ্যাকশনটি ক্যাপচার করে।

ADB ব্যবহার করে অঙ্গভঙ্গি পরীক্ষা ও ডিবাগ করুন

আপনি অ্যান্ড্রয়েড ডিবাগ ব্রিজ ( adb ) এবং IWearGestureService সিস্টেম সার্ভিস ব্যবহার করে, কব্জির শারীরিক নড়াচড়া না করেই কোনো ফিজিক্যাল ডিভাইস বা এমুলেটরে এক হাতের জেসচার পরীক্ষা করতে পারেন।

অঙ্গভঙ্গি সিমুলেশন সক্ষম করুন

1. আপনার Wear OS ডিভাইসটিতে Wear OS 7 (API লেভেল 37) বা তার উচ্চতর সংস্করণ চলছে কিনা তা যাচাই করুন।
2. যদি কব্জিতে বা চার্জারে না থাকা কোনো ফিজিক্যাল ডিভাইসে পরীক্ষা করা হয়, তাহলে অফ-বডি সেন্সর স্টেটটি ওভাররাইড করুন যাতে ডিভাইসটি সক্রিয় থাকে:

adb shell cmd sensorservice set-off-body-state 0

ADB ব্যবহার করে অঙ্গভঙ্গি ইভেন্ট ট্রিগার করুন

ডাবল পিঞ্চ ( Primary ক্রিয়া) অঙ্গভঙ্গিটি অনুকরণ করতে, নিম্নলিখিত ADB শেল কমান্ডটি চালান:

adb shell cmd IWearGestureService gesture 1

রিস্ট টার্ন ( Dismiss অ্যাকশন) জেসচারটি সিমুলেট করতে, নিম্নলিখিত ADB শেল কমান্ডটি চালান:

adb shell cmd IWearGestureService gesture 2

অঙ্গভঙ্গি ইঙ্গিত ট্র্যাকিং রিসেট করুন

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

adb shell cmd IWearGestureService hint clear <your_package_name>

পরীক্ষা শেষ হলে অফ-বডি সেন্সর অবস্থা রিসেট করতে:

adb shell cmd sensorservice reset-off-body-state

অতিরিক্ত সম্পদ

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