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

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

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

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

দ্রষ্টব্য: এই স্পেসিফিকেশনের মেসেজ এবং স্ট্রাকচারগুলোর একটি অন্তর্নিহিত সর্বোচ্চ আকার রয়েছে, যা একটি ট্রান্সপোর্ট মেসেজের সর্বোচ্চ আকার দ্বারা নির্ধারিত হয়; স্বতন্ত্র ফিল্ডের জন্য কোনো সীমা নেই। ট্রান্সপোর্ট মেসেজের সর্বোচ্চ আকার বর্তমানে ৬৪ কিলোবাইট।

সাধারণ নেমস্পেস ডেটা কাঠামো

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

ছবি

এটি একটি ছবির বিবরণ, যার সাথে অল্প পরিমাণ মেটাডেটাও অন্তর্ভুক্ত থাকে, যাতে প্রেরক অ্যাপ্লিকেশনটি ছবিগুলো কীভাবে রেন্ডার করবে তার উপর নির্ভর করে বিভিন্ন ছবির মধ্য থেকে বেছে নিতে পারে।

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

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

ভলিউম

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

নাম প্রকার বর্ণনা
স্তর দ্বিগুণ ঐচ্ছিক: বর্তমান স্ট্রিমের ভলিউম লেভেল, যার মান ০.০ থেকে ১.০-এর মধ্যে হতে হবে, যেখানে ১.০ হলো সর্বোচ্চ ভলিউম।
নিঃশব্দ বুলিয়ান ঐচ্ছিক: ভলিউম লেভেল নির্বিশেষে কাস্ট ডিভাইসটি মিউট করা হবে কিনা।

মিডিয়া নেমস্পেস ডেটা কাঠামো

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

মিডিয়া তথ্য

এই ডেটা স্ট্রাকচারটি একটি মিডিয়া স্ট্রিম বর্ণনা করে।

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

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

  • কেউ না
  • বাফারযুক্ত
  • সরাসরি
বিষয়বস্তুর ধরণ স্ট্রিং প্লে করা মিডিয়ার MIME কন্টেন্ট টাইপ
মেটাডেটা বস্তু

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

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

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

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

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

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

চলচ্চিত্রের একটি মিডিয়া নিদর্শনের বর্ণনা দেয়।

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

টিভি শো মিডিয়া মেটাডেটা

একটি টেলিভিশন অনুষ্ঠানের পর্বের মিডিয়া নিদর্শন বর্ণনা করে।

নাম প্রকার বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা ২ (একমাত্র মান)
সিরিজের শিরোনাম স্ট্রিং টিভি সিরিজের ঐচ্ছিক বর্ণনামূলক শিরোনাম। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে শিরোনামটি সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।
উপশিরোনাম স্ট্রিং টিভি পর্বের ঐচ্ছিক বর্ণনামূলক সাবটাইটেল। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে টাইটেলটি সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।
মৌসুম পূর্ণসংখ্যা টিভি শো-টির সিজন নম্বর (ঐচ্ছিক)
পর্ব পূর্ণসংখ্যা টিভি শো-টির (সিজনের) ঐচ্ছিক পর্ব নম্বর
ছবি ছবি [] কন্টেন্টের সাথে যুক্ত ছবির URL-গুলোর একটি ঐচ্ছিক অ্যারে। এই ফিল্ডের প্রাথমিক মান প্রেরক ' লোড' মেসেজে প্রদান করতে পারেন। প্রস্তাবিত মাপগুলো প্রদান করা উচিত।
মূল সম্প্রচারের তারিখ স্ট্রিং (আইএসও ৮৬০১) এই পর্বটি যে তারিখে ও সময়ে প্রকাশিত হয়েছিল, তার ঐচ্ছিক ISO 8601 তারিখ ও সময়। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে originalAirDate সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।

মিউজিকট্র্যাকমিডিয়ামেটাডেটা

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

নাম প্রকার বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা ৩ (একমাত্র মান)
অ্যালবামের নাম স্ট্রিং ঐচ্ছিক অ্যালবাম বা সংগ্রহ যেখান থেকে এই ট্র্যাকটি নেওয়া হয়েছে। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে albumName সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।
শিরোনাম স্ট্রিং ট্র্যাকের ঐচ্ছিক নাম (যেমন, গানের শিরোনাম)। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে শিরোনামটি সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।
অ্যালবাম শিল্পী স্ট্রিং এই ট্র্যাকটি যে অ্যালবামে রয়েছে, তার সাথে যুক্ত শিল্পীর নাম (ঐচ্ছিক )। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে albumArtist খুঁজে নিতে পারে অথবা প্রেরক লোড মেসেজে এই নামটি দিতে পারেন।
শিল্পী স্ট্রিং মিডিয়া ট্র্যাকের সাথে যুক্ত শিল্পীর নাম (ঐচ্ছিক )। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে শিল্পীকে খুঁজে নিতে পারে অথবা প্রেরক লোড মেসেজে এই নামটি দিতে পারেন।
সুরকার স্ট্রিং মিডিয়া ট্র্যাকের সাথে যুক্ত সুরকারের নাম (ঐচ্ছিক) । প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে সুরকারকে খুঁজে নিতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারে।
ট্র্যাক নম্বর পূর্ণসংখ্যা অ্যালবামে ট্র্যাকের ঐচ্ছিক নম্বর
ডিস্ক নম্বর পূর্ণসংখ্যা অ্যালবামের ভলিউমের (যেমন, একটি ডিস্ক) ঐচ্ছিক নম্বর
ছবি ছবি [] কন্টেন্টের সাথে যুক্ত ছবির URL-গুলোর একটি ঐচ্ছিক অ্যারে। এই ফিল্ডের প্রাথমিক মান প্রেরক ' লোড' মেসেজে প্রদান করতে পারেন। প্রস্তাবিত মাপগুলো প্রদান করা উচিত।
মুক্তির তারিখ স্ট্রিং (আইএসও ৮৬০১) এই কন্টেন্টটি প্রকাশের ঐচ্ছিক ISO 8601 তারিখ এবং সময়। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে releaseDate সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।

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

একটি আলোকচিত্র মাধ্যম নিদর্শনের বর্ণনা।

নাম প্রকার বর্ণনা
মেটাডেটা টাইপ পূর্ণসংখ্যা ৪ (একমাত্র মান)
শিরোনাম স্ট্রিং ছবির ঐচ্ছিক শিরোনাম। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে শিরোনামটি সংগ্রহ করতে পারে অথবা প্রেরক লোড বার্তায় এটি প্রদান করতে পারেন।
শিল্পী স্ট্রিং ফটোগ্রাফারের নাম (ঐচ্ছিক )। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে শিল্পীকে খুঁজে নিতে পারে অথবা প্রেরক লোড মেসেজে এই নামটি দিতে পারেন।
অবস্থান স্ট্রিং ছবিটি কোথায় তোলা হয়েছে তার ঐচ্ছিক মৌখিক অবস্থান; উদাহরণস্বরূপ, "মাদ্রিদ, স্পেন"। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে অবস্থানটি খুঁজে নিতে পারে অথবা প্রেরক লোড মেসেজে এটি দিয়ে দিতে পারেন।
অক্ষাংশ দ্বিগুণ ছবিটি তোলার স্থানের জন্য ঐচ্ছিক ভৌগোলিক অক্ষাংশের মান। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে অক্ষাংশ সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।
দ্রাঘিমাংশ দ্বিগুণ ছবিটি তোলার স্থানের জন্য ঐচ্ছিক ভৌগোলিক দ্রাঘিমাংশের মান। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে দ্রাঘিমাংশ সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।
প্রস্থ পূর্ণসংখ্যা ছবিটির ঐচ্ছিক প্রস্থ (পিক্সেল এককে)। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে প্রস্থ সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।
উচ্চতা পূর্ণসংখ্যা ঐচ্ছিক: ছবিটির পিক্সেল-এ উচ্চতা। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে উচ্চতা সংগ্রহ করতে পারে অথবা প্রেরক লোড বার্তায় এটি প্রদান করতে পারে।
তৈরির তারিখ ও সময় স্ট্রিং (আইএসও ৮৬০১) এই ছবিটি তোলার ঐচ্ছিক ISO 8601 তারিখ এবং সময়। প্লেয়ার content_id ব্যবহার করে স্বাধীনভাবে creationDateTime সংগ্রহ করতে পারে অথবা প্রেরক লোড মেসেজে এটি প্রদান করতে পারেন।

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

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

নাম প্রকার বর্ণনা
মিডিয়া সেশন আইডি পূর্ণসংখ্যা এই নির্দিষ্ট সেশনের প্লেব্যাকের জন্য অনন্য আইডি। এই আইডিটি রিসিভার দ্বারা লোড (LOAD) করার সময় সেট করা হয় এবং এটি কোনো প্লেব্যাকের একটি নির্দিষ্ট দৃষ্টান্ত শনাক্ত করতে ব্যবহার করা যেতে পারে। উদাহরণস্বরূপ, একই সেশনের মধ্যে "Wish you were here"-এর দুটি প্লেব্যাকের প্রতিটির একটি অনন্য mediaSessionId থাকবে।
মিডিয়া মিডিয়া তথ্য ঐচ্ছিক (স্ট্যাটাস মেসেজের জন্য) যে কন্টেন্টটি প্লেব্যাক করা হচ্ছে তার সম্পূর্ণ বিবরণ। শুধুমাত্র মিডিয়া ইনফরমেশন পরিবর্তিত হলেই এটি স্ট্যাটাস মেসেজে দেখানো হবে।
প্লেব্যাক রেট ভাসতে মিডিয়া টাইম এগোচ্ছে কিনা এবং কী হারে এগোচ্ছে, তা নির্দেশ করে। এটি প্লেয়ারের অবস্থার ওপর নির্ভরশীল নয়, কারণ মিডিয়া টাইম যেকোনো অবস্থায় থেমে যেতে পারে। ১.০ হলো সাধারণ সময়, ০.৫ হলো স্লো মোশন।
খেলোয়াড়ের অবস্থা এনাম (স্ট্রিং)

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

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

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

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

মিডিয়া প্লেয়ারটি কোন কোন মিডিয়া কমান্ড সমর্থন করে, তা বর্ণনা করে এমন ফ্ল্যাগসমূহ:

  • ১ << ০ বিরতি
  • ১ << ১ সন্ধান করুন
  • ১ << ২ স্ট্রিম ভলিউম
  • ১ << ৩ স্ট্রিম মিউট
  • ১ << ৪ সামনে এগিয়ে যান (অপ্রচলিত)
  • ১ << ৫ পিছনে যান (অপ্রচলিত)
  • ১ << ৬ পরবর্তী সারিতে
  • ১ << ৭ পূর্ববর্তী সারি
  • ১ << ৮ সারি এলোমেলো করা
  • ১ << ৯ বিজ্ঞাপন এড়িয়ে যান
  • ১ << ১০ কিউতে সবগুলোর পুনরাবৃত্তি
  • ১ << ১১ কিউতে এক পুনরাবৃত্তি
  • ১ << ১২ ট্র্যাক সম্পাদনা করুন
  • ১ << ১৩ প্লেব্যাক রেট
  • ১ << ১৪ লাইক
  • ১ << ১৫ অপছন্দ
  • ১ << ১৬ অনুসরণ করুন
  • ১ << ১৭ আনফলো

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

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

প্রেরক থেকে প্রাপকের কাছে নির্দেশাবলী

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

লোড

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

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

ঐচ্ছিক (ডিফল্ট হলো true) যদি autoplay প্যারামিটারটি নির্দিষ্ট করা থাকে, তাহলে মিডিয়া প্লেয়ারটি কন্টেন্ট লোড হওয়ার সাথে সাথেই তা চালানো শুরু করবে। autoplay নির্দিষ্ট করা না থাকলেও, মিডিয়া প্লেয়ারের ইমপ্লিমেন্টেশন তাৎক্ষণিকভাবে প্লেব্যাক শুরু করার সিদ্ধান্ত নিতে পারে। যদি প্লেব্যাক শুরু হয়, তাহলে রেসপন্সে প্লেয়ারের স্টেট BUFFERING-এ সেট করা উচিত, অন্যথায় এটি PAUSED-এ সেট করা উচিত।

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

বিরতি

বর্তমান কন্টেন্টের প্লেব্যাক থামিয়ে দেয়। সকল প্রেরক অ্যাপ্লিকেশনে একটি স্ট্যাটাস ইভেন্ট নোটিফিকেশন পাঠায়।

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

অনুসন্ধান করুন

স্ট্রিমে বর্তমান অবস্থান নির্ধারণ করে। সমস্ত প্রেরক অ্যাপ্লিকেশনে একটি স্ট্যাটাস ইভেন্ট নোটিফিকেশন পাঠায়। যদি প্রদত্ত অবস্থানটি বর্তমান কন্টেন্টের জন্য বৈধ অবস্থানের পরিসরের বাইরে হয়, তাহলে প্লেয়ারটি অনুরোধ করা অবস্থানের যতটা সম্ভব কাছাকাছি একটি বৈধ অবস্থান বেছে নেবে।

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

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

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

থামুন

বর্তমান কন্টেন্টের প্লেব্যাক বন্ধ করে দেয়। সমস্ত প্রেরক অ্যাপ্লিকেশনে একটি STATUS ইভেন্ট নোটিফিকেশন পাঠায়। এই কমান্ডের পর কন্টেন্টটি আর লোড হবে না এবং mediaSessionId-টি অবৈধ হয়ে যাবে।

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

খেলা

লোড কলের মাধ্যমে লোড করা কন্টেন্টের প্লেব্যাক শুরু হয় এবং বর্তমান সময় থেকে তা চলতে থাকে।

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

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

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

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

সেটভলিউম

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

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

প্রাপক থেকে প্রেরকের কাছে বার্তা

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

  • ত্রুটি: প্রেরকের অনুরোধে কোনো ত্রুটিপূর্ণ প্রতিক্রিয়া এলে পাঠানো ইউনিকাস্ট বার্তা।
  • অবস্থা: সম্প্রচারিত বার্তা।
    • প্রেরকের দ্বারা শুরু করা কোনো পদক্ষেপের ফলাফল। এতে সেই অনুরোধের requestId থাকবে যার কারণে পরিবর্তনটি ঘটেছে।
    • স্বতঃস্ফূর্ত: উদাহরণস্বরূপ, প্রাপক অ্যাপ্লিকেশন দ্বারা চালিত কোনো পরিবর্তনের কারণে। RequestId-এর মান হবে ০।

ত্রুটি: খেলোয়াড়ের অবস্থা অবৈধ

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

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

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

লোড অনুরোধ ব্যর্থ হলে এটি পাঠানো হয়। প্লেয়ারের অবস্থা নিষ্ক্রিয় (IDLE) থাকবে।

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

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

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

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

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

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

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

মানসমূহ:

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

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

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

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