মিডিয়া প্লেব্যাক বার্তা, মিডিয়া প্লেব্যাক বার্তা

Google Cast প্রেরক অ্যাপ্লিকেশনগুলি রিসিভার অ্যাপ্লিকেশনে JSON ফর্ম্যাটে বার্তা পাঠিয়ে রিসিভার ডিভাইসে প্লেব্যাক নিয়ন্ত্রণ করে। একইভাবে, প্রাপক JSON-এও প্রেরকের কাছে বার্তা পাঠায়। বার্তাগুলি প্রেরকের কাছ থেকে আসা কমান্ড হতে পারে যা প্লেয়ারের অবস্থা পরিবর্তন করে, রিসিভারের কাছ থেকে সেই কমান্ডগুলির প্রতিক্রিয়া, বা ডেটা স্ট্রাকচার যা রিসিভার অ্যাপ্লিকেশনের জন্য মিডিয়া বর্ণনা করে।

Google Cast SDK অতিরিক্ত বিকাশকারী পরিষেবার শর্তাবলী অনুসরণ করে, একটি কাস্ট মিডিয়া অ্যাপ্লিকেশনকে অবশ্যই রিসিভারে মিডিয়া প্লেব্যাক নিয়ন্ত্রণ করতে এখানে সংজ্ঞায়িত এই বার্তাগুলি ব্যবহার করতে হবে৷ এটি করা মিডিয়া অ্যাপটিকে প্ল্যাটফর্ম জুড়ে একটি ধারাবাহিক ব্যবহারকারীর অভিজ্ঞতা প্রদান করে এবং এটি নিশ্চিত করে যে একটি কাস্ট অ্যাপ্লিকেশন নতুন এবং ভবিষ্যতের ব্যবহারের ক্ষেত্রে সমর্থন করবে। এই কাঠামোগুলি কাস্টম ডেটা সমর্থন করে, যেখানে উপযুক্ত, এবং একটি অ্যাপ্লিকেশন SDK দ্বারা সমর্থিত নয় এমন কমান্ডগুলির জন্য নিজস্ব বার্তাগুলিকে সংজ্ঞায়িত করতে পারে৷

মিডিয়া প্লেব্যাক বার্তাগুলির নামস্থান urn:x-cast:com.google.cast.media হিসাবে সংজ্ঞায়িত করা হয়েছে।

দ্রষ্টব্য: এই স্পেসিফিকেশনের বার্তা এবং কাঠামোর একটি অন্তর্নিহিত সর্বোচ্চ আকার একটি পরিবহন বার্তার সর্বোচ্চ আকার দ্বারা নির্ধারিত হয়, পৃথক ক্ষেত্রের জন্য কোন সীমা নেই। পরিবহন বার্তা সর্বাধিক আকার বর্তমানে 64 KBytes.

সাধারণ নামস্থান ডেটা স্ট্রাকচার

সমস্ত মিডিয়া নেমস্পেস আর্টিফ্যাক্ট দ্বারা ব্যবহৃত ডেটা স্ট্রাকচারের একটি সুপারসেট একটি সাধারণ নামস্থানে সংজ্ঞায়িত করা হয়।

ছবি

এটি একটি চিত্রের বিবরণ, প্রেরক অ্যাপ্লিকেশনটিকে ছবিগুলির পছন্দের অনুমতি দেওয়ার জন্য অল্প পরিমাণ মেটাডেটা সহ, এটি কীভাবে রেন্ডার করবে তার উপর নির্ভর করে৷

উচ্চতা এবং প্রস্থ চিত্রগুলির একটি অ্যারের মধ্যে শুধুমাত্র একটি আইটেমের জন্য ঐচ্ছিক। উদাহরণস্বরূপ, যদি একটি একক আইটেম ফেরত হয়, তাহলে সেগুলি ঐচ্ছিক; যদি দুটি আইটেম ফেরত দেওয়া হয়, একটি আইটেম অবশ্যই একটি উচ্চতা এবং প্রস্থ নির্দিষ্ট করতে হবে, তবে প্রেরক যদি নির্দিষ্ট পরামিতি সহ পাস করা একটি পছন্দ না করেন তবে প্রেরক "ডিফল্ট" বিকল্পটি বেছে নিতে পারেন।

নাম টাইপ বর্ণনা
url ইউআরআই ছবির জন্য URI
উচ্চতা পূর্ণসংখ্যা ছবির ঐচ্ছিক উচ্চতা
প্রস্থ পূর্ণসংখ্যা ছবির ঐচ্ছিক প্রস্থ

আয়তন

মিডিয়া স্ট্রিম ভলিউম। মিডিয়া স্ট্রীমে ফেড-ইন/ফেড-আউট প্রভাবের জন্য ব্যবহৃত হয়। (দ্রষ্টব্য: প্রেরক এপিআই ব্যবহার করে সিস্টেম ভলিউম পরিবর্তন করা হয়।) ডিভাইসের ভলিউম নিয়ন্ত্রণ করতে ভলিউম স্লাইডার বা ভলিউম বোতামের সাথে স্ট্রিম ভলিউম ব্যবহার করা উচিত নয়। স্ট্রিম ভলিউম পরিবর্তন করতে নিম্নলিখিত প্যারামগুলির মধ্যে অন্তত একটি পাস করতে হবে।

নাম টাইপ বর্ণনা
স্তর দ্বিগুণ 0.0 এবং 1.0 এর মধ্যে একটি মান হিসাবে ঐচ্ছিক বর্তমান স্ট্রিম ভলিউম স্তর যেখানে 1.0 হল সর্বাধিক ভলিউম।
নিঃশব্দ বুলিয়ান ঐচ্ছিক কাস্ট ডিভাইসটি নিঃশব্দ করা আছে কিনা, ভলিউম স্তর থেকে স্বাধীন

মিডিয়া নেমস্পেস ডেটা স্ট্রাকচার

এই বার্তাগুলি মিডিয়া প্লেয়ারের অবস্থা বর্ণনা করে। নামস্থান হল urn:x-cast:com.google.cast.media ।

মিডিয়া তথ্য

এই তথ্য কাঠামো একটি মিডিয়া স্ট্রিম বর্ণনা করে।

নাম টাইপ বর্ণনা
সামগ্রী আইডি স্ট্রিং বর্তমানে মিডিয়া প্লেয়ার দ্বারা লোড করা সামগ্রীর পরিষেবা-নির্দিষ্ট শনাক্তকারী৷ এটি একটি বিনামূল্যের ফর্ম স্ট্রিং এবং অ্যাপ্লিকেশনের জন্য নির্দিষ্ট। বেশিরভাগ ক্ষেত্রে, এটি মিডিয়ার URL হবে, তবে প্রেরক একটি স্ট্রিং পাস করতে বেছে নিতে পারেন যা প্রাপক সঠিকভাবে ব্যাখ্যা করতে পারে। সর্বোচ্চ দৈর্ঘ্য: 1k
স্ট্রিম টাইপ enum
(স্ট্রিং)

নিম্নলিখিতগুলির মধ্যে একটি হিসাবে মিডিয়া আর্টিফ্যাক্টের ধরণ বর্ণনা করে:

  • কোনটিই নয়
  • বাফার করা হয়েছে
  • লাইভ দেখান
বিষয়বস্তুর প্রকার স্ট্রিং মিডিয়ার MIME বিষয়বস্তুর ধরন চালানো হচ্ছে
মেটাডেটা বস্তু

ঐচ্ছিক মিডিয়া মেটাডেটা অবজেক্ট, নিম্নলিখিতগুলির মধ্যে একটি:

সময়কাল দ্বিগুণ সেকেন্ডে বর্তমানে বাজানো স্ট্রিমের ঐচ্ছিক সময়কাল
কাস্টম ডেটা বস্তু প্রেরক অ্যাপ্লিকেশন বা রিসিভার অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব

জেনেরিকমিডিয়া মেটাডেটা

একটি জেনেরিক মিডিয়া আর্টিফ্যাক্ট বর্ণনা করে।

নাম টাইপ বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা 0 (একমাত্র মান)
শিরোনাম স্ট্রিং বিষয়বস্তুর ঐচ্ছিক বর্ণনামূলক শিরোনাম। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
সাবটাইটেল স্ট্রিং বিষয়বস্তুর ঐচ্ছিক বর্ণনামূলক সাবটাইটেল। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
ছবি ছবি [] বিষয়বস্তুর সাথে যুক্ত একটি চিত্রের URL(গুলি) এর ঐচ্ছিক বিন্যাস৷ ক্ষেত্রের প্রাথমিক মান লোড বার্তায় প্রেরক দ্বারা প্রদান করা যেতে পারে। প্রস্তাবিত মাপ প্রদান করা উচিত
মুক্তির তারিখ স্ট্রিং (ISO 8601) ঐচ্ছিক ISO 8601 তারিখ এবং সময় এই বিষয়বস্তু প্রকাশ করা হয়েছে. প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে

মুভিমিডিয়া মেটাডেটা

একটি মুভি মিডিয়া আর্টিফ্যাক্ট বর্ণনা করে।

নাম টাইপ বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা 1 (একমাত্র মান)
শিরোনাম স্ট্রিং বিষয়বস্তুর ঐচ্ছিক বর্ণনামূলক শিরোনাম। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
সাবটাইটেল স্ট্রিং বিষয়বস্তুর ঐচ্ছিক বর্ণনামূলক সাবটাইটেল। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
স্টুডিও স্ট্রিং ঐচ্ছিক স্টুডিও যা বিষয়বস্তু প্রকাশ করেছে। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে স্টুডিও পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
ছবি ছবি [] বিষয়বস্তুর সাথে যুক্ত একটি চিত্রের URL(গুলি) এর ঐচ্ছিক বিন্যাস৷ ক্ষেত্রের প্রাথমিক মান লোড বার্তায় প্রেরক দ্বারা প্রদান করা যেতে পারে। প্রস্তাবিত মাপ প্রদান করা উচিত
মুক্তির তারিখ স্ট্রিং (ISO 8601) ঐচ্ছিক ISO 8601 তারিখ এবং সময় এই বিষয়বস্তু প্রকাশ করা হয়েছে. প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে

TvShowMediaMetadata

একটি টেলিভিশন শো এপিসোড মিডিয়া আর্টিফ্যাক্ট বর্ণনা করে।

নাম টাইপ বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা 2 (একমাত্র মান)
সিরিজ শিরোনাম স্ট্রিং টিভি সিরিজের ঐচ্ছিক বর্ণনামূলক শিরোনাম। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
সাবটাইটেল স্ট্রিং টিভি পর্বের ঐচ্ছিক বর্ণনামূলক সাবটাইটেল। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
মৌসম পূর্ণসংখ্যা টিভি শো এর ঐচ্ছিক সিজন নম্বর
পর্ব পূর্ণসংখ্যা টিভি শো এর ঐচ্ছিক পর্ব সংখ্যা (মৌসুমে)
ছবি ছবি [] বিষয়বস্তুর সাথে যুক্ত একটি চিত্রের URL(গুলি) এর ঐচ্ছিক বিন্যাস৷ ক্ষেত্রের প্রাথমিক মান লোড বার্তায় প্রেরক দ্বারা প্রদান করা যেতে পারে। প্রস্তাবিত মাপ প্রদান করা উচিত
আসল এয়ার ডেট স্ট্রিং (ISO 8601) ঐচ্ছিক ISO 8601 তারিখ এবং সময় এই পর্বটি প্রকাশিত হয়েছে। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে আসল এয়ারডেট পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরক দ্বারা দেওয়া যেতে পারে

MusicTrackMediaMetadata

একটি মিউজিক ট্র্যাক মিডিয়া আর্টিফ্যাক্ট বর্ণনা করে।

নাম টাইপ বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা 3 (একমাত্র মান)
অ্যালবামের নাম স্ট্রিং ঐচ্ছিক অ্যালবাম বা সংগ্রহ যা থেকে এই ট্র্যাক টানা হয়েছে। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে অ্যালবামের নাম পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরক দ্বারা দেওয়া যেতে পারে
শিরোনাম স্ট্রিং ট্র্যাকের ঐচ্ছিক নাম (উদাহরণস্বরূপ, গানের শিরোনাম)। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
অ্যালবাম শিল্পী স্ট্রিং এই ট্র্যাকটি বৈশিষ্ট্যযুক্ত অ্যালবামের সাথে যুক্ত শিল্পীর ঐচ্ছিক নাম৷ প্লেয়ার কনটেন্ট_আইডি ব্যবহার করে স্বাধীনভাবে অ্যালবাম আর্টিস্ট পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
শিল্পী স্ট্রিং মিডিয়া ট্র্যাকের সাথে যুক্ত শিল্পীর ঐচ্ছিক নাম। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিল্পী পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরক দ্বারা দেওয়া যেতে পারে
সুরকার স্ট্রিং মিডিয়া ট্র্যাকের সাথে যুক্ত সুরকারের ঐচ্ছিক নাম। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে সুরকার পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরক দ্বারা দেওয়া যেতে পারে
ট্র্যাক নম্বর পূর্ণসংখ্যা অ্যালবামে ট্র্যাকের ঐচ্ছিক সংখ্যা
ডিস্ক নম্বর পূর্ণসংখ্যা অ্যালবামের ভলিউমের ঐচ্ছিক সংখ্যা (উদাহরণস্বরূপ, একটি ডিস্ক)
ছবি ছবি [] বিষয়বস্তুর সাথে যুক্ত একটি চিত্রের URL(গুলি) এর ঐচ্ছিক বিন্যাস৷ ক্ষেত্রের প্রাথমিক মান লোড বার্তায় প্রেরক দ্বারা প্রদান করা যেতে পারে। প্রস্তাবিত মাপ প্রদান করা উচিত
মুক্তির তারিখ স্ট্রিং (ISO 8601) ঐচ্ছিক ISO 8601 তারিখ এবং সময় এই বিষয়বস্তু প্রকাশ করা হয়েছে. প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে মুক্তির তারিখ পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে

ফটোমিডিয়া মেটাডেটা

একটি ফটোগ্রাফিক মিডিয়া আর্টিফ্যাক্ট বর্ণনা করে।

নাম টাইপ বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা 4 (একমাত্র মান)
শিরোনাম স্ট্রিং ছবির ঐচ্ছিক শিরোনাম। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিরোনাম পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
শিল্পী স্ট্রিং ফটোগ্রাফারের ঐচ্ছিক নাম। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে শিল্পী পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরক দ্বারা দেওয়া যেতে পারে
অবস্থান স্ট্রিং ঐচ্ছিক মৌখিক অবস্থান যেখানে ছবি তোলা হয়েছিল; উদাহরণস্বরূপ, "মাদ্রিদ, স্পেন।" প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে অবস্থান পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
অক্ষাংশ দ্বিগুণ ঐচ্ছিক ভৌগলিক অক্ষাংশের মান যেখানে ছবি তোলা হয়েছে। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে অক্ষাংশ পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
দ্রাঘিমাংশ দ্বিগুণ ঐচ্ছিক ভৌগলিক দ্রাঘিমাংশের মান যেখানে ছবি তোলা হয়েছে। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে দ্রাঘিমাংশ পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে
প্রস্থ পূর্ণসংখ্যা ফটোগ্রাফের পিক্সেলে ঐচ্ছিক প্রস্থ। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে প্রস্থ পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরক দ্বারা দেওয়া যেতে পারে
উচ্চতা পূর্ণসংখ্যা ফটোগ্রাফের পিক্সেলে ঐচ্ছিক উচ্চতা। প্লেয়ার স্বাধীনভাবে content_id ব্যবহার করে উচ্চতা পুনরুদ্ধার করতে পারে বা এটি লোড বার্তায় প্রেরক দ্বারা দেওয়া যেতে পারে
সৃষ্টির তারিখের সময় স্ট্রিং (ISO 8601) ঐচ্ছিক ISO 8601 তারিখ এবং সময় এই ছবি তোলা হয়েছে. প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে CreationDateTime পুনরুদ্ধার করতে পারে অথবা এটি লোড বার্তায় প্রেরকের দ্বারা দেওয়া যেতে পারে

মিডিয়া স্ট্যাটাস

সেশনের সাপেক্ষে মিডিয়া আর্টিফ্যাক্টের বর্তমান অবস্থা বর্ণনা করে।

নাম টাইপ বর্ণনা
mediaSessionId পূর্ণসংখ্যা এই নির্দিষ্ট সেশনের প্লেব্যাকের জন্য অনন্য আইডি। এই আইডিটি LOAD এ রিসিভার দ্বারা সেট করা হয় এবং একটি প্লেব্যাকের একটি নির্দিষ্ট উদাহরণ সনাক্ত করতে ব্যবহার করা যেতে পারে। উদাহরণস্বরূপ, একই সেশনের মধ্যে "ইচ্ছা আপনি এখানে ছিলেন" এর দুটি প্লেব্যাকের প্রত্যেকটির একটি অনন্য mediaSessionId থাকবে৷
মিডিয়া মিডিয়া তথ্য ঐচ্ছিক (স্থিতি বার্তাগুলির জন্য) যে বিষয়বস্তুর পূর্ণ বিবরণ চালানো হচ্ছে। মিডিয়া ইনফরমেশন পরিবর্তিত হলেই শুধুমাত্র একটি স্থিতি বার্তায় ফেরত দেওয়া হবে।
প্লেব্যাক রেট ভাসা মিডিয়া সময় অগ্রগতি হয় কিনা, এবং কি হারে নির্দেশ করে। এটি প্লেয়ার স্টেট থেকে স্বাধীন যেহেতু মিডিয়া সময় যে কোনো রাজ্যে থামতে পারে। 1.0 হল নিয়মিত সময়, 0.5 হল ধীর গতি৷
প্লেয়ার স্টেট enum (স্ট্রিং)

নিম্নলিখিতগুলির মধ্যে একটি হিসাবে খেলোয়াড়ের অবস্থা বর্ণনা করে:

  • IDLE প্লেয়ার এখনও লোড করা হয়নি
  • প্লেয়িং প্লেয়ার সক্রিয়ভাবে বিষয়বস্তু খেলছে
  • বাফারিং প্লেয়ার প্লে মোডে আছে কিন্তু সক্রিয়ভাবে সামগ্রী চালাচ্ছে না (বর্তমান সময় পরিবর্তন হচ্ছে না)
  • পজড প্লেয়ার পজ করা হয়েছে
নিষ্ক্রিয় কারণ enum (স্ট্রিং)

ঐচ্ছিক যদি playerState IDLE হয় এবং এটি IDLE হওয়ার কারণ জানা থাকে, এই সম্পত্তি প্রদান করা হয়। যদি প্লেয়ারটি নিষ্ক্রিয় হয় কারণ এটি সবে শুরু হয়েছে, এই সম্পত্তি প্রদান করা হবে না; খেলোয়াড় অন্য কোন রাজ্যে থাকলে এই সম্পত্তি প্রদান করা উচিত নয়। নিম্নলিখিত মানগুলি প্রযোজ্য:

  • বাতিল করা হয়েছে একজন প্রেরক STOP কমান্ড ব্যবহার করে প্লেব্যাক বন্ধ করার অনুরোধ করেছেন
  • বাধাপ্রাপ্ত একজন প্রেরক LOAD কমান্ড ব্যবহার করে একটি ভিন্ন মিডিয়া চালানোর অনুরোধ করেছেন৷
  • সমাপ্ত মিডিয়া প্লেব্যাক সম্পন্ন হয়েছে
  • ত্রুটি একটি ত্রুটির কারণে মিডিয়া ব্যাহত হয়েছে; উদাহরণস্বরূপ, যদি প্লেয়ার নেটওয়ার্ক সমস্যার কারণে মিডিয়া ডাউনলোড করতে না পারে
বর্তমান সময় দ্বিগুণ কন্টেন্টের শুরু থেকে মিডিয়া প্লেয়ারের বর্তমান অবস্থান, সেকেন্ডে। যদি এটি একটি লাইভ স্ট্রিম বিষয়বস্তু হয়, তাহলে এই ক্ষেত্রটি ইভেন্টের শুরু থেকে সেকেন্ডের মধ্যে সময় উপস্থাপন করে যা প্লেয়ারের জানা উচিত।
সমর্থিত মিডিয়াকমান্ড পতাকা

মিডিয়া প্লেয়ার কোন মিডিয়া কমান্ড সমর্থন করে তা বর্ণনা করে পতাকা:

  • 1 বিরতি
  • 2 খোঁজ
  • 4 স্ট্রিম ভলিউম
  • 8 নিঃশব্দ প্রবাহ
  • 16 এড়িয়ে যান
  • 32 পিছনের দিকে এড়িয়ে যান

সংমিশ্রণগুলিকে সমষ্টি হিসাবে বর্ণনা করা হয়; উদাহরণস্বরূপ, Pause+Seek+StreamVolume+Mute == 15।

আয়তন আয়তন স্ট্রিম ভলিউম
কাস্টম ডেটা বস্তু রিসিভার অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব

প্রেরক থেকে প্রাপকের আদেশ

এই কমান্ডগুলি মিডিয়া প্লেয়ারকে নিয়ন্ত্রণ করে। নীচের বার্তাগুলিতে সমস্ত কাস্টমডেটা অবজেক্ট অবশ্যই ঐচ্ছিক হতে হবে (অর্থাৎ ডেটা পাস না হলে রিসিভারটি সঠিকভাবে হ্রাস পাবে)। এটি জেনেরিক রিমোট কন্ট্রোল অ্যাপগুলিকে সঠিকভাবে কাজ করার অনুমতি দেবে৷

বোঝা

মিডিয়া প্লেয়ারে নতুন সামগ্রী লোড করে।

নাম টাইপ বর্ণনা
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি, অনুরোধ এবং প্রতিক্রিয়া পারস্পরিক সম্পর্ক করতে
প্রকার স্ট্রিং লোড (শুধুমাত্র মান)
মিডিয়া মিডিয়া তথ্য লোড করার জন্য মিডিয়ার মেটাডেটা (contentId সহ)
স্বয়ংক্রিয় চালু বুলিয়ান

ঐচ্ছিক (ডিফল্ট সত্য) অটোপ্লে প্যারামিটার নির্দিষ্ট করা থাকলে, মিডিয়া প্লেয়ার লোড হয়ে গেলে বিষয়বস্তু প্লে করা শুরু করবে। অটোপ্লে নির্দিষ্ট না থাকলেও, মিডিয়া প্লেয়ার বাস্তবায়ন অবিলম্বে প্লেব্যাক শুরু করতে বেছে নিতে পারে। প্লেব্যাক শুরু হলে, প্রতিক্রিয়ায় প্লেয়ার স্টেট বাফারিং-এ সেট করা উচিত, অন্যথায় এটি পজড সেট করা উচিত

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

বিরতি

বর্তমান বিষয়বস্তুর প্লেব্যাক বিরতি দেয়। সমস্ত প্রেরক অ্যাপ্লিকেশনে একটি স্থিতি ইভেন্ট বিজ্ঞপ্তি ট্রিগার করে৷

নাম টাইপ বর্ণনা
mediaSessionId পূর্ণসংখ্যা মিডিয়া সেশনের আইডি পজ করা হবে
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি, অনুরোধ/প্রতিক্রিয়া সম্পর্কযুক্ত করতে ব্যবহার করতে
প্রকার স্ট্রিং বিরাম (শুধুমাত্র মান)
কাস্টম ডেটা বস্তু প্রেরক অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব
প্রতিক্রিয়া ট্রিগার সম্প্রচার ত্রুটি
কোনোটিই নয় রিসিভার রাষ্ট্র পরিবর্তন একটি মিডিয়া স্থিতি পরিবর্তন বার্তা অবৈধ প্লেয়ার স্টেট

খোঁজ

স্রোতে বর্তমান অবস্থান সেট করে। সমস্ত প্রেরক অ্যাপ্লিকেশনে একটি স্থিতি ইভেন্ট বিজ্ঞপ্তি ট্রিগার করে৷ যদি প্রদত্ত অবস্থানটি বর্তমান বিষয়বস্তুর জন্য বৈধ অবস্থানের সীমার বাইরে হয়, তাহলে প্লেয়ারকে যতটা সম্ভব অনুরোধ করা অবস্থানের কাছাকাছি একটি বৈধ অবস্থান বেছে নেওয়া উচিত।

নাম টাইপ বর্ণনা
mediaSessionId পূর্ণসংখ্যা মিডিয়া সেশনের আইডি যেখানে স্ট্রিমের অবস্থান সেট করা আছে
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি, অনুরোধ এবং প্রতিক্রিয়া পারস্পরিক সম্পর্ক করতে
প্রকার স্ট্রিং SEEK (শুধু মান)
resumeState enum (স্ট্রিং)

ঐচ্ছিক যদি এটি সেট করা না থাকে, প্লেব্যাকের স্থিতি পরিবর্তন হবে না; নিম্নলিখিত মান প্রযোজ্য:

  • PLAYBACK_START মিডিয়া শুরু করতে বাধ্য করে৷
  • PLAYBACK_PAUSE মিডিয়াকে বিরাম দিতে বাধ্য করে৷
বর্তমান সময় দ্বিগুণ বিষয়বস্তুর শুরু থেকে ঐচ্ছিক সেকেন্ড। বিষয়বস্তু লাইভ বিষয়বস্তু হলে, এবং অবস্থান নির্দিষ্ট না থাকলে, স্ট্রিমটি লাইভ অবস্থানে শুরু হবে
কাস্টম ডেটা বস্তু প্রেরক অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব
প্রতিক্রিয়া ট্রিগার সম্প্রচার ত্রুটি
কোনোটিই নয় রিসিভার রাষ্ট্র পরিবর্তন একটি মিডিয়া স্থিতি পরিবর্তন বার্তা অবৈধ প্লেয়ার স্টেট

থামো

বর্তমান সামগ্রীর প্লেব্যাক বন্ধ করে। সমস্ত প্রেরক অ্যাপ্লিকেশনে একটি স্থিতি ইভেন্ট বিজ্ঞপ্তি ট্রিগার করে৷ এই কমান্ডের পরে বিষয়বস্তু আর লোড হবে না এবং mediaSessionId অবৈধ হয়ে গেছে।

নাম টাইপ বর্ণনা
mediaSessionId পূর্ণসংখ্যা কন্টেন্ট বন্ধ করার জন্য মিডিয়া সেশনের আইডি
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি, অনুরোধ এবং প্রতিক্রিয়া পারস্পরিক সম্পর্ক করতে
প্রকার স্ট্রিং STOP (শুধুমাত্র মান)
কাস্টম ডেটা বস্তু প্রেরক অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব
প্রতিক্রিয়া ট্রিগার সম্প্রচার ত্রুটি
কোনোটিই নয় রিসিভার রাষ্ট্র পরিবর্তন একটি মিডিয়া স্থিতি পরিবর্তন বার্তা অবৈধ প্লেয়ার স্টেট

খেলা

লোড কলের সাথে লোড হওয়া সামগ্রীর প্লেব্যাক শুরু হয়, বর্তমান সময়ের অবস্থান থেকে প্লেব্যাক চালিয়ে যাওয়া হয়।

নাম টাইপ বর্ণনা
mediaSessionId পূর্ণসংখ্যা কন্টেন্ট প্লে করার জন্য মিডিয়া সেশনের আইডি
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি, অনুরোধ এবং প্রতিক্রিয়া পারস্পরিক সম্পর্ক করতে
প্রকার স্ট্রিং খেলুন (শুধুমাত্র মান)
কাস্টম ডেটা বস্তু প্রেরক অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব
প্রতিক্রিয়া ট্রিগার সম্প্রচার ত্রুটি
কোনোটিই নয় রিসিভার রাষ্ট্র পরিবর্তন একটি মিডিয়া স্থিতি পরিবর্তন বার্তা অবৈধ প্লেয়ার স্টেট

স্ট্যাটাস পান

মিডিয়া স্ট্যাটাস পুনরুদ্ধার করে।

নাম টাইপ বর্ণনা
mediaSessionId পূর্ণসংখ্যা মিডিয়ার ঐচ্ছিক মিডিয়া সেশন আইডি যার জন্য মিডিয়া স্ট্যাটাস ফেরত দেওয়া উচিত। যদি কোনটি প্রদান করা না হয়, তাহলে সমস্ত মিডিয়া সেশন আইডিগুলির জন্য স্ট্যাটাস প্রদান করা হবে৷
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি, অনুরোধ এবং প্রতিক্রিয়া পারস্পরিক সম্পর্ক করতে
প্রকার স্ট্রিং GET_STATUS (শুধুমাত্র মান)
কাস্টম ডেটা বস্তু প্রেরক অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব
প্রতিক্রিয়া ট্রিগার সম্প্রচার ত্রুটি
প্রেরকের কাছে মিডিয়া স্ট্যাটাস বার্তা যা অনুরোধ করেছে কোনোটিই নয় কোনোটিই নয় কোনোটিই নয়

সেট ভলিউম

মিডিয়া স্ট্রিম ভলিউম সেট করে। মিডিয়া স্ট্রীমে ফেড-ইন/ফেড-আউট প্রভাবের জন্য ব্যবহৃত হয়। (দ্রষ্টব্য: ওয়েব প্রেরক সেট ভলিউম ব্যবহার করে রিসিভার ভলিউম পরিবর্তন করা হয়।) ডিভাইসের ভলিউম নিয়ন্ত্রণ করতে ভলিউম স্লাইডার বা ভলিউম বোতামের সাথে স্ট্রিম ভলিউম ব্যবহার করা উচিত নয়। স্ট্রিম ভলিউমের পরিবর্তন রিসিভারে কোনো UI ট্রিগার করবে না।

নাম টাইপ বর্ণনা
mediaSessionId পূর্ণসংখ্যা মিডিয়া সেশন আইডি যার জন্য স্ট্রিম ভলিউম পরিবর্তন করা হয়েছে
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি, অনুরোধ এবং প্রতিক্রিয়া পারস্পরিক সম্পর্ক করতে
প্রকার স্ট্রিং ভলিউম (শুধুমাত্র মান)
আয়তন আয়তন স্ট্রিম ভলিউম
কাস্টম ডেটা বস্তু প্রেরক অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব
প্রতিক্রিয়া ট্রিগার সম্প্রচার ত্রুটি
কোনোটিই নয় রিসিভার রাষ্ট্র পরিবর্তন একটি মিডিয়া স্থিতি পরিবর্তন বার্তা অবৈধ প্লেয়ার স্টেট

রিসিভার থেকে প্রেরকের কাছে বার্তা

রিসিভার দুই ধরনের বার্তা পাঠায়:

  • ত্রুটি: একটি প্রেরকের অনুরোধে একটি ত্রুটি প্রতিক্রিয়া হলে ইউনিকাস্ট বার্তা পাঠানো হয়।
  • স্থিতি: সম্প্রচার বার্তা.
    • প্রেরক-সূচিত কর্মের ফলাফল। যে অনুরোধটি পরিবর্তন করেছে তার অনুরোধের আইডি থাকবে।
    • স্বতঃস্ফূর্ত: উদাহরণস্বরূপ, রিসিভার অ্যাপ্লিকেশন দ্বারা ট্রিগার হওয়া পরিবর্তনের কারণে। RequestId হবে 0।

ত্রুটি: অবৈধ প্লেয়ার স্টেট

প্লেয়ারটি বৈধ অবস্থায় না থাকার কারণে প্রেরকের অনুরোধটি পূরণ করা না গেলে পাঠানো হয়। উদাহরণস্বরূপ, যদি অ্যাপ্লিকেশনটি এখনও একটি মিডিয়া উপাদান তৈরি না করে থাকে।

নাম টাইপ বর্ণনা
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি যা এই ত্রুটি তৈরি করেছে
প্রকার স্ট্রিং INVALID_PLAYER_STATE (শুধুমাত্র মান)
কাস্টম ডেটা বস্তু রিসিভার অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব

ত্রুটি: লোড ব্যর্থ হয়েছে৷

লোডের অনুরোধ ব্যর্থ হলে পাঠানো হয়েছে। প্লেয়ার স্টেট আইডিএল হবে।

নাম টাইপ বর্ণনা
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি যা এই ত্রুটি তৈরি করেছে
প্রকার স্ট্রিং LOAD_FAILED (শুধুমাত্র মান)
কাস্টম ডেটা বস্তু রিসিভার অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব

ত্রুটি: লোড বাতিল করা হয়েছে৷

লোড অনুরোধ বাতিল হলে পাঠানো হয়েছে (একটি দ্বিতীয় লোড অনুরোধ গৃহীত হয়েছে)।

নাম টাইপ বর্ণনা
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি যা এই ত্রুটি তৈরি করেছে
প্রকার স্ট্রিং LOAD_CANCELLED (শুধুমাত্র মান)
কাস্টম ডেটা বস্তু রিসিভার অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব

ত্রুটি: অবৈধ অনুরোধ

অনুরোধটি অবৈধ হলে পাঠানো হয় (উদাহরণস্বরূপ একটি অজানা অনুরোধের ধরন)।

নাম টাইপ বর্ণনা
অনুরোধ আইডি পূর্ণসংখ্যা অনুরোধের আইডি যা এই ত্রুটি তৈরি করেছে
প্রকার স্ট্রিং INVALID_REQUEST (শুধুমাত্র মান)
কারণ এনাম (স্ট্রিং)

মান:

  • INVALID_COMMAND কমান্ডটি সমর্থিত নয়৷
  • DUPLICATE_REQUESTID অনুরোধ আইডিটি অনন্য নয় (প্রাপক একই আইডি দিয়ে একটি অনুরোধ প্রক্রিয়া করছে)
কাস্টম ডেটা বস্তু রিসিভার অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব

মিডিয়া স্ট্যাটাস

একটি রাষ্ট্র পরিবর্তন বা একটি মিডিয়া স্ট্যাটাস অনুরোধের পরে পাঠানো হয়েছে. শুধুমাত্র MediaStatus অবজেক্টগুলি যা পরিবর্তিত হয়েছে বা অনুরোধ করা হয়েছে তা পাঠানো হবে।

নাম টাইপ বর্ণনা
অনুরোধ আইডি পূর্ণসংখ্যা আইডি এই স্ট্যাটাস প্রতিক্রিয়ার সাথে সম্পর্কযুক্ত করতে ব্যবহৃত হয় যে অনুরোধটি এটির উদ্ভব হয়েছিল বা 0 যদি স্ট্যাটাস বার্তাটি স্বতঃস্ফূর্ত হয় (প্রেরকের অনুরোধ দ্বারা ট্রিগার করা হয় না)। প্রেরক অ্যাপ্লিকেশনগুলি একটি র্যান্ডম নম্বর নির্বাচন করে এবং ক্রমাগত এটিকে বাড়িয়ে অনন্য অনুরোধ আইডি তৈরি করবে (তারা 0 ব্যবহার করবে না)।
প্রকার স্ট্রিং MEDIA_STATUS (শুধুমাত্র মান)
অবস্থা মিডিয়া স্ট্যাটাস [] মিডিয়া স্ট্যাটাস অবজেক্টের অ্যারে। দ্রষ্টব্য: MediaStatus-এর মিডিয়া উপাদান শুধুমাত্র পরিবর্তন করা হলেই ফেরত দেওয়া হবে।
কাস্টম ডেটা বস্তু রিসিভার অ্যাপ্লিকেশন দ্বারা সংজ্ঞায়িত ডেটার ঐচ্ছিক অ্যাপ্লিকেশন-নির্দিষ্ট ব্লব