پیام های پخش رسانه

برنامه‌های فرستنده Google Cast با ارسال پیام‌هایی با فرمت JSON به برنامه گیرنده، پخش را در دستگاه گیرنده کنترل می‌کنند. به همین ترتیب، گیرنده پیام‌ها را به فرستنده باز می‌فرستد، همچنین در JSON. پیام‌ها ممکن است دستوراتی از فرستنده باشند که وضعیت پخش‌کننده را تغییر می‌دهند، پاسخ‌هایی به آن دستورات از گیرنده یا ساختارهای داده‌ای که رسانه را برای برنامه گیرنده توصیف می‌کنند.

به دنبال شرایط سرویس برنامه‌نویس اضافی Google Cast SDK ، یک برنامه رسانه Cast باید از این پیام‌ها همانطور که در اینجا تعریف شده است برای کنترل پخش رسانه در گیرنده استفاده کند. انجام این کار، تجربه کاربری ثابتی را در سراسر پلتفرم‌ها به برنامه رسانه ارائه می‌کند و تضمین می‌کند که برنامه Cast از موارد استفاده جدید و آینده پشتیبانی می‌کند. این ساختارها همچنین در صورت لزوم از داده های سفارشی پشتیبانی می کنند و یک برنامه کاربردی ممکن است پیام های خود را برای دستوراتی که توسط SDK پشتیبانی نمی شوند تعریف کند.

فضای نام پیام های پخش رسانه به صورت urn:x-cast:com.google.cast.media تعریف می شود.

توجه: پیام ها و ساختارهای موجود در این مشخصات دارای حداکثر اندازه ضمنی هستند که با حداکثر اندازه پیام انتقال تعیین می شود، هیچ محدودیتی برای فیلدهای جداگانه وجود ندارد. حداکثر اندازه پیام انتقال در حال حاضر 64 کیلوبایت است.

ساختارهای داده فضای نام رایج

ابرمجموعه ای از ساختارهای داده که توسط تمام مصنوعات فضای نام رسانه استفاده می شود در یک فضای نام مشترک تعریف شده است.

تصویر

این توصیف یک تصویر است، از جمله مقدار کمی فراداده که به برنامه فرستنده امکان انتخاب تصاویر را می دهد، بسته به اینکه چگونه آنها را ارائه می دهد.

ارتفاع و عرض فقط برای یک مورد در آرایه ای از تصاویر اختیاری است. به عنوان مثال، اگر یک مورد واحد برگردانده شده باشد، آنها اختیاری هستند. اگر دو مورد برگردانده شده باشد، یک مورد باید ارتفاع و عرض را مشخص کند، اما فرستنده می‌تواند گزینه «پیش‌فرض» را انتخاب کند، اگر گزینه ارسال شده با پارامترهای خاص را دوست نداشته باشد.

نام تایپ کنید شرح
آدرس اینترنتی URI URI برای تصویر
ارتفاع عدد صحیح ارتفاع تصویر اختیاری
عرض عدد صحیح عرض تصویر اختیاری

جلد

حجم جریان رسانه برای جلوه های محو و محو در جریان رسانه استفاده می شود. (توجه: حجم سیستم با استفاده از APIهای فرستنده تغییر می کند.) میزان صدای جریان نباید همراه با لغزنده صدا یا دکمه های صدا برای کنترل میزان صدای دستگاه استفاده شود. حداقل یکی از پارامترهای زیر باید برای تغییر حجم جریان ارسال شود.

نام تایپ کنید شرح
مرحله دو برابر اختیاری سطح حجم جریان فعلی به عنوان مقداری بین 0.0 و 1.0 که در آن 1.0 حداکثر حجم است.
خاموش بولی اختیاری آیا دستگاه Cast، مستقل از سطح صدا، بی‌صدا است

ساختارهای داده فضای نام رسانه

این پیام ها وضعیت پخش کننده رسانه را توصیف می کنند. فضای نام urn:x-cast:com.google.cast.media است .

رسانه اطلاعات

این ساختار داده یک جریان رسانه ای را توصیف می کند.

نام تایپ کنید شرح
شناسه محتوا رشته شناسه خاص سرویس محتوایی که در حال حاضر توسط پخش کننده رسانه بارگیری شده است. این یک رشته فرم رایگان است و مختص برنامه است. در بیشتر موارد، این نشانی اینترنتی رسانه خواهد بود، اما فرستنده می تواند رشته ای را ارسال کند که گیرنده بتواند به درستی آن را تفسیر کند. حداکثر طول: 1k
نوع جریان enum
(رشته)

نوع مصنوع رسانه ای را به عنوان یکی از موارد زیر توصیف می کند:

  • هیچ یک
  • بافر شده
  • زنده
نوع محتوا رشته نوع محتوای MIME رسانه در حال پخش
فراداده هدف - شی

اختیاری شی فوق داده رسانه، یکی از موارد زیر:

مدت زمان دو برابر اختیاری مدت زمان پخش فعلی بر حسب ثانیه
داده های سفارشی هدف - شی اختیاری حباب داده خاص برنامه که توسط برنامه فرستنده یا گیرنده تعریف شده است

GenericMediaMatadata

یک مصنوع رسانه ای عمومی را توصیف می کند.

نام تایپ کنید شرح
نوع فراداده عدد صحیح 0 (تنها مقدار)
عنوان رشته عنوان اختیاری توصیفی محتوا Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
عنوان فرعی رشته زیرنویس اختیاری توصیفی محتوا. Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
تصاویر تصویر [] آرایه اختیاری URL(ها) به یک تصویر مرتبط با محتوا. مقدار اولیه فیلد می تواند توسط فرستنده در پیام Load ارائه شود. باید اندازه های توصیه شده را ارائه دهد
تاریخ انتشار رشته (ISO 8601) تاریخ و زمان اختیاری ISO 8601 این محتوا منتشر شد. Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود

MovieMediaMetadata

یک مصنوع رسانه فیلم را توصیف می کند.

نام تایپ کنید شرح
نوع فراداده عدد صحیح 1 (تنها مقدار)
عنوان رشته عنوان اختیاری توصیفی محتوا Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
عنوان فرعی رشته زیرنویس اختیاری توصیفی محتوا. Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
استودیو رشته استودیو اختیاری که محتوا را منتشر کرد. Player می تواند به طور مستقل استودیو را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
تصاویر تصویر [] آرایه اختیاری URL(ها) به یک تصویر مرتبط با محتوا. مقدار اولیه فیلد می تواند توسط فرستنده در پیام Load ارائه شود. باید اندازه های توصیه شده را ارائه دهد
تاریخ انتشار رشته (ISO 8601) تاریخ و زمان اختیاری ISO 8601 این محتوا منتشر شد. Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود

TvShowMediaMetadata

مصنوع رسانه ای قسمت نمایش تلویزیونی را توصیف می کند.

نام تایپ کنید شرح
نوع فراداده عدد صحیح 2 (تنها مقدار)
عنوان سریال رشته عنوان اختیاری توصیفی سریال تلویزیونی Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
عنوان فرعی رشته اختیاری زیرنویس توصیفی قسمت تلویزیونی. Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
فصل عدد صحیح شماره فصل اختیاری نمایش تلویزیونی
قسمت عدد صحیح شماره قسمت اختیاری (در فصل) برنامه تلویزیونی
تصاویر تصویر [] آرایه اختیاری URL(ها) به یک تصویر مرتبط با محتوا. مقدار اولیه فیلد می تواند توسط فرستنده در پیام Load ارائه شود. باید اندازه های توصیه شده را ارائه دهد
تاریخ هوای اصلی رشته (ISO 8601) تاریخ و زمان اختیاری ISO 8601 این قسمت منتشر شد. پخش کننده می تواند به طور مستقل originalAirDate را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود.

MusicTrackMediaMetadata

مصنوع رسانه ای آهنگ موسیقی را توصیف می کند.

نام تایپ کنید شرح
نوع فراداده عدد صحیح 3 (تنها مقدار)
نام آلبوم رشته آلبوم یا مجموعه اختیاری که این آهنگ از آن گرفته شده است. پخش کننده می تواند به طور مستقل نام آلبوم را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود.
عنوان رشته اختیاری نام آهنگ (به عنوان مثال، عنوان آهنگ). Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
آلبوم هنرمند رشته اختیاری نام هنرمند مرتبط با آلبوم دارای این آهنگ. پخش کننده می تواند به طور مستقل آلبومArtist را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود.
هنرمند رشته اختیاری نام هنرمند مرتبط با آهنگ رسانه. پخش کننده می تواند به طور مستقل هنرمند را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود
آهنگساز رشته اختیاری نام آهنگساز مرتبط با آهنگ رسانه. پخش کننده می تواند به طور مستقل آهنگساز را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود.
شماره پیگیری عدد صحیح اختیاری تعداد آهنگ در آلبوم
شماره دیسک عدد صحیح اختیاری تعداد حجم (مثلاً یک دیسک) آلبوم
تصاویر تصویر [] آرایه اختیاری URL(ها) به یک تصویر مرتبط با محتوا. مقدار اولیه فیلد می تواند توسط فرستنده در پیام Load ارائه شود. باید اندازه های توصیه شده را ارائه دهد
تاریخ انتشار رشته (ISO 8601) تاریخ و زمان اختیاری ISO 8601 این محتوا منتشر شد. پخش کننده می تواند به طور مستقل تاریخ انتشار را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود.

PhotoMediaMatadata

یک مصنوع رسانه عکاسی را توصیف می کند.

نام تایپ کنید شرح
نوع فراداده عدد صحیح 4 (تنها مقدار)
عنوان رشته عنوان اختیاری عکس Player می تواند به طور مستقل عنوان را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
هنرمند رشته اختیاری نام عکاس پخش کننده می تواند به طور مستقل هنرمند را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود
محل رشته اختیاری مکان شفاهی که در آن عکس گرفته شده است. به عنوان مثال، "مادرید، اسپانیا." پخش کننده می تواند به طور مستقل موقعیت مکانی را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
عرض جغرافیایی دو برابر مقدار عرض جغرافیایی اختیاری برای مکانی که عکس گرفته شده است. پخش کننده می تواند به طور مستقل عرض جغرافیایی را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود.
طول جغرافیایی دو برابر مقدار طول جغرافیایی اختیاری برای مکانی که عکس گرفته شده است. پخش کننده می تواند به طور مستقل طول جغرافیایی را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام بارگذاری داده شود.
عرض عدد صحیح عرض اختیاری بر حسب پیکسل عکس. پخش کننده می تواند به طور مستقل عرض را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
ارتفاع عدد صحیح ارتفاع اختیاری در پیکسل عکس. پخش کننده می تواند به طور مستقل ارتفاع را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود
CreationDateTime رشته (ISO 8601) تاریخ و زمان انتخابی ISO 8601 که این عکس گرفته شده است. پخش کننده می تواند به طور مستقل CreationDateTime را با استفاده از content_id بازیابی کند یا می تواند توسط فرستنده در پیام Load داده شود.

وضعیت رسانه

وضعیت فعلی مصنوع رسانه را با توجه به جلسه توضیح می دهد.

نام تایپ کنید شرح
mediaSessionId عدد صحیح شناسه منحصر به فرد برای پخش این جلسه خاص. این شناسه توسط گیرنده در LOAD تنظیم می شود و می تواند برای شناسایی یک نمونه خاص از یک پخش استفاده شود. به عنوان مثال، دو بار پخش "Wish you are here" در یک جلسه هر کدام یک mediaSessionId منحصر به فرد دارند.
رسانه ها رسانه اطلاعات اختیاری (برای پیام های وضعیت) شرح کامل محتوایی که در حال پخش است. فقط در صورتی که MediaInformation تغییر کرده باشد در پیام های وضعیت بازگردانده می شود.
میزان پخش شناور نشان می دهد که آیا زمان رسانه در حال پیشرفت است و با چه سرعتی. این مستقل از وضعیت پخش کننده است زیرا زمان رسانه می تواند در هر حالتی متوقف شود. 1.0 زمان معمولی است، 0.5 حرکت آهسته است
بازیکن ایالت enum (رشته)

وضعیت بازیکن را به عنوان یکی از موارد زیر توصیف می کند:

  • IDLE Player هنوز بارگیری نشده است
  • PLAYING Player به طور فعال محتوا را پخش می کند
  • پخش کننده BUFFERING در حالت PLAY است اما به طور فعال محتوا را پخش نمی کند (زمان فعلی تغییر نمی کند)
  • PAUSED پخش کننده متوقف شده است
idleReason enum (رشته)

اختیاری اگر playerState IDLE باشد و دلیل تبدیل شدن آن به IDLE مشخص باشد، این ویژگی ارائه می شود. اگر پخش کننده IDLE باشد زیرا به تازگی شروع شده است، این ویژگی ارائه نخواهد شد. اگر بازیکن در هر حالت دیگری باشد، این ویژگی نباید ارائه شود. مقادیر زیر اعمال می شود:

  • لغو یک فرستنده درخواست توقف پخش را با استفاده از دستور STOP کرد
  • INTERRUPTED یک فرستنده با استفاده از دستور LOAD درخواست پخش یک رسانه دیگر را کرد
  • FINISHED پخش رسانه تکمیل شد
  • ERROR رسانه به دلیل یک خطا قطع شد. به عنوان مثال، اگر پخش کننده به دلیل مشکلات شبکه نتوانست رسانه را دانلود کند
زمان جاری دو برابر موقعیت فعلی پخش کننده رسانه از ابتدای محتوا، در چند ثانیه. اگر این یک محتوای پخش زنده است، پس این فیلد زمانی را بر حسب ثانیه از ابتدای رویداد نشان می‌دهد که باید برای بازیکن شناخته شود.
Commands Media پشتیبانی کرد پرچم ها

پرچم‌هایی که نشان می‌دهند از کدام دستورات رسانه‌ای پشتیبانی می‌کند:

  • 1 مکث
  • 2 جستجو کنید
  • 4 حجم جریان
  • 8 استریم بی صدا
  • 16 به جلو پرش کنید
  • 32 به عقب پرش کنید

ترکیب ها به عنوان جمع توصیف می شوند. برای مثال، Pause+Seek+StreamVolume+Mute == 15.

جلد جلد حجم جریان
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه گیرنده

دستورات از فرستنده به گیرنده

این دستورات پخش کننده رسانه را کنترل می کنند. همه اشیاء customData در پیام‌های زیر باید اختیاری باشند (یعنی در صورت عدم ارسال داده، گیرنده باید به‌درستی کاهش یابد). این به برنامه های کنترل از راه دور عمومی اجازه می دهد تا به درستی کار کنند.

بار

محتوای جدید را در پخش کننده رسانه بارگیری می کند.

نام تایپ کنید شرح
درخواست شناسه عدد صحیح شناسه درخواست، برای ارتباط درخواست و پاسخ
نوع رشته LOAD (فقط مقدار)
رسانه ها رسانه اطلاعات فراداده (از جمله contentId) رسانه برای بارگیری
پخش خودکار بولی

اختیاری (پیش‌فرض درست است) اگر پارامتر پخش خودکار مشخص شده باشد، پخش‌کننده رسانه پس از بارگیری محتوا، پخش آن را آغاز می‌کند. حتی اگر پخش خودکار مشخص نشده باشد، اجرای پخش کننده رسانه ممکن است انتخاب کند که پخش بلافاصله شروع شود. اگر پخش شروع شود، وضعیت پخش در پاسخ باید روی BUFFERING و در غیر این صورت باید روی PAUSED تنظیم شود.

زمان جاری دو برابر اختیاری چند ثانیه از آغاز محتوا. اگر محتوا محتوای زنده باشد و موقعیت مشخص نشده باشد، پخش جریانی از موقعیت زنده شروع می شود
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه فرستنده
واکنش محرک ها پخش می شود خطاها
هیچ یک تغییر وضعیت گیرنده یک پیام تغییر وضعیت رسانه وضعیت بازیکن نامعتبر است
بارگیری انجام نشد
بار لغو شد

مکث کنید

پخش محتوای فعلی را متوقف می کند. یک اعلان رویداد STATUS را برای همه برنامه های فرستنده فعال می کند.

نام تایپ کنید شرح
mediaSessionId عدد صحیح شناسه جلسه رسانه که باید متوقف شود
درخواست شناسه عدد صحیح شناسه درخواست، برای استفاده برای ارتباط درخواست/پاسخ
نوع رشته مکث (فقط مقدار)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه فرستنده
واکنش محرک ها پخش می شود خطاها
هیچ یک تغییر وضعیت گیرنده یک پیام تغییر وضعیت رسانه وضعیت بازیکن نامعتبر است

جستجو کنید

موقعیت فعلی را در جریان تنظیم می کند. یک اعلان رویداد STATUS را برای همه برنامه های فرستنده فعال می کند. اگر موقعیت ارائه شده خارج از محدوده موقعیت های معتبر برای محتوای فعلی باشد، بازیکن باید موقعیت معتبری را تا حد امکان نزدیک به موقعیت درخواستی انتخاب کند.

نام تایپ کنید شرح
mediaSessionId عدد صحیح شناسه جلسه رسانه ای که موقعیت جریان در آن تنظیم شده است
درخواست شناسه عدد صحیح شناسه درخواست، برای ارتباط درخواست و پاسخ
نوع رشته جستجو (فقط ارزش)
ResumeState enum (رشته)

اختیاری اگر این تنظیم نشده باشد، وضعیت پخش تغییر نخواهد کرد. مقادیر زیر اعمال می شود:

  • PLAYBACK_START رسانه را مجبور به شروع می‌کند
  • PLAYBACK_PAUSE رسانه را مجبور به توقف موقت می‌کند
زمان جاری دو برابر اختیاری چند ثانیه از آغاز محتوا. اگر محتوا محتوای زنده باشد و موقعیت مشخص نشده باشد، پخش جریانی از موقعیت زنده شروع می شود
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه فرستنده
واکنش محرک ها پخش می شود خطاها
هیچ یک تغییر وضعیت گیرنده یک پیام تغییر وضعیت رسانه وضعیت بازیکن نامعتبر است

متوقف کردن

پخش محتوای فعلی را متوقف می کند. یک اعلان رویداد STATUS را برای همه برنامه های فرستنده فعال می کند. پس از این دستور محتوا دیگر بارگذاری نمی شود و mediaSessionId نامعتبر می شود.

نام تایپ کنید شرح
mediaSessionId عدد صحیح شناسه جلسه رسانه برای توقف محتوا
درخواست شناسه عدد صحیح شناسه درخواست، برای ارتباط درخواست و پاسخ
نوع رشته STOP (فقط مقدار)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه فرستنده
واکنش محرک ها پخش می شود خطاها
هیچ یک تغییر وضعیت گیرنده یک پیام تغییر وضعیت رسانه وضعیت بازیکن نامعتبر است

بازی

پخش محتوایی را که با تماس بارگذاری بارگذاری شده است آغاز می کند، پخش از موقعیت زمانی فعلی ادامه می یابد.

نام تایپ کنید شرح
mediaSessionId عدد صحیح شناسه جلسه رسانه برای محتوایی که باید پخش شود
درخواست شناسه عدد صحیح شناسه درخواست، برای ارتباط درخواست و پاسخ
نوع رشته PLAY (فقط مقدار)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه فرستنده
واکنش محرک ها پخش می شود خطاها
هیچ یک تغییر وضعیت گیرنده یک پیام تغییر وضعیت رسانه وضعیت بازیکن نامعتبر است

وضعیت را دریافت کنید

وضعیت رسانه را بازیابی می کند.

نام تایپ کنید شرح
mediaSessionId عدد صحیح شناسه جلسه رسانه اختیاری رسانه ای که وضعیت رسانه باید برای آن بازگردانده شود. اگر هیچ کدام ارائه نشد، وضعیت همه شناسه‌های جلسه رسانه ارائه می‌شود.
درخواست شناسه عدد صحیح شناسه درخواست، برای ارتباط درخواست و پاسخ
نوع رشته GET_STATUS (فقط مقدار)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه فرستنده
واکنش محرک ها پخش می شود خطاها
پیام MediaStatus به فرستنده ای که آن را درخواست کرده است هیچ یک هیچ یک هیچ یک

تنظیم حجم

حجم جریان رسانه را تنظیم می کند. برای جلوه های محو و محو در جریان رسانه استفاده می شود. (توجه: میزان صدای گیرنده با استفاده از فرستنده وب setVolume تغییر می کند.) میزان صدای جریان نباید همراه با لغزنده صدا یا دکمه های صدا برای کنترل میزان صدای دستگاه استفاده شود. تغییر در حجم پخش هیچ رابط کاربری در گیرنده ایجاد نمی کند.

نام تایپ کنید شرح
mediaSessionId عدد صحیح شناسه جلسه رسانه رسانه ای که حجم پخش برای آن تغییر کرده است
درخواست شناسه عدد صحیح شناسه درخواست، برای ارتباط درخواست و پاسخ
نوع رشته VOLUME (فقط مقدار)
جلد جلد حجم جریان
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه فرستنده
واکنش محرک ها پخش می شود خطاها
هیچ یک تغییر وضعیت گیرنده یک پیام تغییر وضعیت رسانه وضعیت بازیکن نامعتبر است

پیام از گیرنده به فرستنده

گیرنده دو نوع پیام ارسال می کند:

  • خطاها: پیام‌های Unicast زمانی ارسال می‌شوند که به درخواست فرستنده پاسخ خطایی داده شود.
  • وضعیت: پیام های پخش شده.
    • پیامد اقدامی که توسط فرستنده آغاز شده است. حاوی requestId درخواستی است که باعث تغییر شده است.
    • خود به خود: به عنوان مثال، به دلیل تغییری که توسط برنامه گیرنده ایجاد شده است. RequestId 0 خواهد بود.

خطا: وضعیت بازیکن نامعتبر است

زمانی ارسال می شود که درخواست فرستنده قابل انجام نباشد زیرا بازیکن در وضعیت معتبری نیست. به عنوان مثال، اگر برنامه هنوز یک عنصر رسانه ایجاد نکرده باشد.

نام تایپ کنید شرح
درخواست شناسه عدد صحیح شناسه درخواستی که این خطا را ایجاد کرده است
نوع رشته INVALID_PLAYER_STATE (فقط مقدار)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه گیرنده

خطا: بارگیری انجام نشد

زمانی ارسال شد که درخواست بارگیری ناموفق بود. حالت پخش کننده IDLE خواهد بود.

نام تایپ کنید شرح
درخواست شناسه عدد صحیح شناسه درخواستی که این خطا را ایجاد کرده است
نوع رشته LOAD_FAILED (فقط مقدار)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه گیرنده

خطا: بارگذاری لغو شد

هنگامی که درخواست بار لغو شد (یک درخواست بار دوم دریافت شد) ارسال شد.

نام تایپ کنید شرح
درخواست شناسه عدد صحیح شناسه درخواستی که این خطا را ایجاد کرده است
نوع رشته LOAD_CANCELLED (فقط مقدار)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه گیرنده

خطا: درخواست نامعتبر است

زمانی ارسال می‌شود که درخواست نامعتبر باشد (مثلاً یک نوع درخواست ناشناخته).

نام تایپ کنید شرح
درخواست شناسه عدد صحیح شناسه درخواستی که این خطا را ایجاد کرده است
نوع رشته INVALID_REQUEST (فقط مقدار)
دلیل Enum (رشته)

ارزش های:

  • INVALID_COMMAND این فرمان پشتیبانی نمی شود
  • DUPLICATE_REQUESTID شناسه درخواست منحصر به فرد نیست (گیرنده در حال پردازش درخواستی با همان شناسه است)
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه گیرنده

وضعیت رسانه

پس از تغییر وضعیت یا پس از درخواست وضعیت رسانه ارسال شد. فقط اشیاء MediaStatus که تغییر کرده اند یا درخواست شده اند ارسال خواهند شد.

نام تایپ کنید شرح
درخواست شناسه عدد صحیح شناسه برای ارتباط این پاسخ وضعیت با درخواستی که آن را ایجاد کرده است یا 0 در صورتی که پیام وضعیت خودبخودی باشد (با درخواست فرستنده ایجاد نمی شود) استفاده می شود. برنامه‌های فرستنده با انتخاب یک عدد تصادفی و افزایش مداوم آن، شناسه‌های درخواست منحصربه‌فرد تولید می‌کنند (از 0 استفاده نمی‌کنند).
نوع رشته MEDIA_STATUS (فقط مقدار)
وضعیت وضعیت رسانه [] آرایه ای از اشیاء وضعیت رسانه. توجه: عنصر رسانه در MediaStatus تنها در صورتی برگردانده می شود که تغییر کرده باشد.
داده های سفارشی هدف - شی اختیاری حباب خاص برنامه کاربردی تعریف شده توسط برنامه گیرنده