মিডিয়া সেশন ব্যবহার করা

মিডিয়া সেশন, অডিও বা ভিডিও প্লেয়ারের সাথে ইন্টার‍্যাক্ট করার একটি সর্বজনীন উপায় প্রদান করে। কোনও অ্যাপে মিডিয়া চলছে তা Android-কে জানানোর মাধ্যমে, প্লেব্যাক কন্ট্রোল অ্যাপে ডেলিগেট করা যেতে পারে। মিডিয়া সেশনের সাথে ইন্টিগ্রেট করার মাধ্যমে কোনও অ্যাপ এক্সটার্নালি মিডিয়া প্লেব্যাক বিজ্ঞাপন দেখাতে এবং এক্সটার্নাল সোর্স থেকে প্লেব্যাক কমান্ড পেতে পারে। এই সোর্সগুলি ফিজিক্যাল বোতাম (যেমন হেডসেট বা টিভি রিমোট কন্ট্রোলের প্লে বোতাম) বা পরোক্ষ কমান্ড (যেমন Google Assistant-কে "পজ" করার নির্দেশ দেওয়া) হতে পারে। মিডিয়া সেশন তখন এই কমান্ডগুলি সেই অ্যাপে ডেলিগেট করে যা মিডিয়া প্লেয়ারে সেগুলি প্রয়োগ করে, যার জন্য কমান্ডগুলি কোথা থেকে এসেছে তা স্পষ্ট হয়।

মিডিয়া সেশন যে প্লেয়ার ম্যানেজ করে তার সাথেই থাকে। আপনাকে মিডিয়া সেশন তৈরি ও শুরু করতে হবে। মিডিয়া সেশন ও তার সাথে যুক্ত প্লেয়ারের মালিকানা যে অ্যাক্টিভিটি বা পরিষেবার কাছে আছে, তার onCreate() পদ্ধতিতে এটি করতে হবে।

মিডিয়া সেশন শুরু করুন

নতুন তৈরি করা মিডিয়া সেশনের কোনও ক্ষমতা নেই। এইসব ধাপ অনুসরণ করে আপনাকে সেশন ইনিশিয়ালাইজ করতে হবে:

  • ফ্ল্যাগ সেট করুন যাতে মিডিয়া সেশন মিডিয়া কন্ট্রোলার ও মিডিয়া বোতাম থেকে কলব্যাক পেতে পারে।
  • PlaybackStateCompat-এর একটি ইনস্ট্যান্স তৈরি ও ইনিশিয়ালাইজ করুন এবং এটি সেশনে অ্যাসাইন করুন। সেশন চলাকালীন প্লেব্যাক স্টেট পরিবর্তিত হয়, তাই আমরা PlaybackStateCompat.Builder ক্যাশে করার সাজেশন দিই যাতে সেটি আবার ব্যবহার করা যায়।
  • MediaSessionCompat.Callback-এর একটি ইনস্ট্যান্স তৈরি করুন এবং এটি সেশনে অ্যাসাইন করুন (কলব্যাক সম্পর্কে নিচে আরও তথ্য দেওয়া আছে)।

যে অ্যাক্টিভিটি বা পরিষেবা সেশনের মালিক, তার onCreate() পদ্ধতিতে আপনাকে মিডিয়া সেশন তৈরি ও শুরু করতে হবে।

আপনার অ্যাপ নতুন করে শুরু (বা বন্ধ) করার সময় মিডিয়া বোতাম কাজ করার জন্য, মিডিয়া বোতাম যে ইনটেন্ট পাঠায় তার সাথে ম্যাচ করে এমন প্লে অ্যাকশন PlaybackState-এ থাকতে হবে। এই কারণেই, শুরু করার সময় সেশন স্ট্যাটাসে ACTION_PLAY অ্যাসাইন করা হয়। আরও তথ্যের জন্য, মিডিয়া বোতামে প্রতিক্রিয়া জানানো দেখুন।

প্লেব্যাক স্ট্যাটাস ও মেটাডেটা বজায় রাখা

দুটি ক্লাস আছে যা মিডিয়া সেশনের স্ট্যাটাস দেখায়।

PlaybackStateCompat ক্লাস প্লেয়ারের বর্তমান অপারেশনাল অবস্থা বর্ণনা করে। এর মধ্যে রয়েছে:

  • ট্রান্সপোর্ট স্টেট (প্লেয়ার ভিডিও চালাচ্ছে/পজ করেছে/বাফার করছে ইত্যাদি। getState() দেখুন)
  • প্রযোজ্য হলে, একটি ত্রুটি কোড এবং ঐচ্ছিক ত্রুটি মেসেজ। (নিচে getErrorCode() দেখুন এবং স্ট্যাটাস ও সমস্যা পড়ুন।)
  • প্লেয়ারের পজিশন
  • বর্তমান অবস্থায় যে কন্ট্রোলার অ্যাকশনগুলি পরিচালনা করা যেতে পারে

MediaMetadataCompat ক্লাসটি যে মেটেরিয়াল চালানো হচ্ছে তার বর্ণনা দেয়:

  • আর্টিস্ট, অ্যালবাম ও ট্র্যাকের নাম
  • ট্র্যাকের সময়সীমা
  • লক স্ক্রিনে দেখানোর জন্য অ্যালবাম আর্টওয়ার্ক। ছবিটি একটি বিটম্যাপ যার সর্বাধিক সাইজ ৩২০x৩২০ডিপি (এর থেকে বড় হলে, এটি স্কেল ডাউন করা হয়)।
  • ContentUris-এর একটি ইনস্ট্যান্স যা আর্টওয়ার্কের আরও বড় ভার্সন দেখায়

মিডিয়া সেশনের লাইফটাইম চলাকালীন প্লেয়ারের স্ট্যাটাস ও মেটাডেটা পরিবর্তন হতে পারে। প্রতিবার স্টেট বা মেটাডেটা পরিবর্তন হলে, আপনাকে প্রতিটি ক্লাসের জন্য সংশ্লিষ্ট বিল্ডার ব্যবহার করতে হবে, PlaybackStateCompat.Builder() বা MediaMetadataCompat.Builder(), এবং তারপর setPlaybackState() বা setMetaData() কল করে মিডিয়া সেশনে নতুন ইনস্ট্যান্স পাস করতে হবে। এইসব ঘন ঘন অপারেশন থেকে সামগ্রিক মেমরি ব্যবহার কমাতে, একবার বিল্ডার তৈরি করা এবং সেশনের পুরো সময় জুড়ে সেগুলি আবার ব্যবহার করা একটি ভালো ধারণা।

স্ট্যাটাস ও সমস্যা

মনে রাখবেন যে PlaybackState হল এমন একটি অবজেক্ট যাতে সেশনের প্লেব্যাক স্ট্যাটাস (getState()) এবং প্রয়োজন হলে, সংশ্লিষ্ট ত্রুটি কোড (getErrorCode())-এর জন্য আলাদা আলাদা ভ্যালু থাকে। ত্রুটি মারাত্মক বা মারাত্মক নয়, দুই ধরনেরই হতে পারে:

প্লেব্যাক বিঘ্নিত হলে, আপনাকে একটি মারাত্মক ত্রুটি তৈরি করতে হবে: ট্রান্সপোর্ট স্টেট STATE_ERROR-এ সেট করুন এবং setErrorMessage(int, CharSequence)-এর সাথে সংশ্লিষ্ট ত্রুটি উল্লেখ করুন। যতক্ষণ পর্যন্ত প্লেব্যাক সমস্যার কারণে ব্লক করা থাকবে, ততক্ষণ পর্যন্ত PlaybackState-কে STATE_ERROR এবং সমস্যা সম্পর্কে রিপোর্ট করা চালিয়ে যেতে হবে।

আপনার অ্যাপ কোনও অনুরোধ ম্যানেজ করতে না পারলে, কিন্তু প্লে করা চালিয়ে যেতে পারলে, একটি নন-ফেটাল সমস্যা হয়: ট্রান্সপোর্ট "স্বাভাবিক" অবস্থায় থাকে (যেমন STATE_PLAYING) কিন্তু PlaybackState-এ একটি সমস্যার কোড থাকে। যেমন, শেষ গানটি চলছে এবং ব্যবহারকারী পরবর্তী গানটি চালানোর অনুরোধ করলে, প্লেব্যাক চলতে পারে, তবে আপনাকে ত্রুটি কোড ERROR_CODE_END_OF_QUEUE সহ একটি নতুন PlaybackState তৈরি করতে হবে এবং তারপর setPlaybackState() কল করতে হবে। সেশনের সাথে অ্যাটাচ করা মিডিয়া কন্ট্রোলার কলব্যাক পাবে onPlaybackStateChanged() এবং ব্যবহারকারীকে কী হয়েছে তা ব্যাখ্যা করবে। একটি নন-ফেটাল সমস্যা শুধুমাত্র একবার রিপোর্ট করা উচিত, যখন এটি ঘটে। পরের বার সেশন PlaybackState আপডেট করার সময় একই নন-ফেটাল সমস্যা আবার সেট করবেন না (যদি না নতুন অনুরোধের উত্তরে সমস্যাটি ঘটে থাকে)।

মিডিয়া সেশন লক স্ক্রিন

Android 4.0 (API লেভেল ১৪) থেকে শুরু করে, সিস্টেম কোনও মিডিয়া সেশনের প্লেব্যাক স্ট্যাটাস ও মেটাডেটা অ্যাক্সেস করতে পারে। লক স্ক্রিন এইভাবে মিডিয়া কন্ট্রোল ও আর্টওয়ার্ক দেখাতে পারে। Android ভার্সনের উপর নির্ভর করে আচরণ আলাদা হয়।

অ্যালবাম আর্টওয়ার্ক

Android 4.0 (API লেভেল 14) থেকে Android 10 (API লেভেল 29) পর্যন্ত, লক স্ক্রিনের ব্যাকগ্রাউন্ডে আপনার অ্যালবাম আর্টওয়ার্ক দেখানো হয় - তবে মিডিয়া সেশন মেটাডেটায় ব্যাকগ্রাউন্ড বিটম্যাপ থাকলে তবেই এটি দেখানো হয়।

ট্রান্সপোর্ট কন্ট্রোল

Android 4.0 (API লেভেল 14) থেকে Android 4.4 (API লেভেল 19) পর্যন্ত, কোনও মিডিয়া সেশন অ্যাক্টিভ থাকলে এবং মিডিয়া সেশন মেটাডেটায় ব্যাকগ্রাউন্ড বিটম্যাপ অন্তর্ভুক্ত থাকলে, লক স্ক্রিনে অটোমেটিক ট্রান্সপোর্ট কন্ট্রোল দেখানো হয়।

Android 5.0 (API লেভেল 21) বা তার পরবর্তী ভার্সনে সিস্টেম লক স্ক্রিনে ট্রান্সপোর্ট কন্ট্রোল প্রদান করে না। পরিবর্তে, ট্রান্সপোর্ট কন্ট্রোল দেখানোর জন্য আপনার MediaStyle বিজ্ঞপ্তি ব্যবহার করা উচিত।

কাস্টম অ্যাকশন যোগ করুন

মিডিয়া অ্যাপ্লিকেশন কাস্টম অ্যাকশন নির্ধারণ করতে পারে; যেমন: থাম্বস-আপ, লাইক বা ৩০ সেকেন্ড রিওয়াইন্ড করা। কাস্টম অ্যাকশনের মাধ্যমে সম্পূর্ণ নতুন আচরণ প্রয়োগ করা উচিত। PlaybackStateCompat-এ সংজ্ঞায়িত স্ট্যান্ডার্ড ট্রান্সপোর্ট কন্ট্রোল অ্যাকশনের কোনও একটিকে প্রতিস্থাপন করতে কাস্টম অ্যাকশন ব্যবহার করবেন না।

addCustomAction()-এর মাধ্যমে কাস্টম অ্যাকশন যোগ করুন। নিম্নলিখিত উদাহরণে দেখানো হয়েছে কীভাবে থাম্বস-আপ অ্যাকশনের জন্য কন্ট্রোল যোগ করতে হয়:

Kotlin

stateBuilder.addCustomAction(
        PlaybackStateCompat.CustomAction.Builder(
                CUSTOM_ACTION_THUMBS_UP,
                resources.getString(R.string.thumbs_up),
                thumbsUpIcon
        ).run {
            setExtras(customActionExtras)
            build()
        }
)

জাভা

stateBuilder.addCustomAction(new PlaybackStateCompat.CustomAction.Builder(
    CUSTOM_ACTION_THUMBS_UP, resources.getString(R.string.thumbs_up), thumbsUpIcon)
    .setExtras(customActionExtras)
    .build());

সম্পূর্ণ উদাহরণ দেখতে Universal Music Player দেখুন।

আপনি onCustomAction()-এর মাধ্যমে অ্যাকশনের উত্তর দেন।

Kotlin

override fun onCustomAction(action: String, extras: Bundle?) {
    when(action) {
        CUSTOM_ACTION_THUMBS_UP -> {
            ...
        }
    }
}

জাভা

@Override
public void onCustomAction(@NonNull String action, Bundle extras) {
    if (CUSTOM_ACTION_THUMBS_UP.equals(action)) {
        ...
    }
}

এছাড়াও, Universal Music Player দেখুন।

মিডিয়া সেশন কলব্যাক

প্রধান মিডিয়া সেশন কলব্যাক পদ্ধতিগুলি হল onPlay(), onPause() এবং onStop()। আপনার প্লেয়ারকে নিয়ন্ত্রণ করে এমন কোড এখানে যোগ করতে হবে।

যেহেতু আপনি রানটাইমে ( onCreate()-এ) সেশনের কলব্যাক ইনস্ট্যানশিয়েট ও সেট করেন, তাই আপনার অ্যাপ বিকল্প কলব্যাক নির্ধারণ করতে পারে যা বিভিন্ন প্লেয়ার ব্যবহার করে এবং ডিভাইস ও সিস্টেম লেভেলের উপর নির্ভর করে কলব্যাক ও প্লেয়ারের উপযুক্ত কম্বিনেশন বেছে নেয়। আপনি অ্যাপের বাকি অংশ পরিবর্তন না করেই প্লেয়ার পরিবর্তন করতে পারবেন। যেমন, Android 4.1 (API লেভেল 16) বা তার পরবর্তী ভার্সনে চালানোর সময় আপনি ExoPlayer ব্যবহার করতে পারবেন এবং আগের সিস্টেমে MediaPlayer ব্যবহার করতে পারবেন।

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

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