رسائل تشغيل الوسائط

تتحكم تطبيقات المُرسِلين في Google Cast في التشغيل على جهاز المُستلِم من خلال إرسال الرسائل بتنسيق JSON إلى تطبيق المُستلِم. وبالمثل، يرسل المُستلِم الرسائل مرة أخرى إلى المُرسِل بتنسيق JSON أيضًا. قد تكون الرسائل أوامر من المرسل تغيّر حالة المشغِّل أو ردودًا على هذه الأوامر من المتلقي أو بُنى بيانات تصف الوسائط لتطبيق جهاز الاستقبال.

وفقًا لبنود الخدمة الإضافية لمطوّري تطبيقات Google Cast SDK، يجب أن يستخدم تطبيق وسائط البث هذه الرسائل على النحو المحدّد هنا للتحكّم في تشغيل الوسائط على جهاز الاستقبال. يؤدي ذلك إلى تزويد تطبيق الوسائط بتجربة مستخدم متّسقة على مختلف المنصات، بالإضافة إلى ضمان أن يتوافق تطبيق Cast مع حالات الاستخدام الجديدة والمستقبلية. تدعم هذه البنى أيضًا البيانات المخصصة، حيثما كان ذلك مناسبًا، وقد يحدد تطبيق رسائله الخاصة للأوامر التي لا تتوافق مع حزمة SDK.

يتم تحديد مساحة الاسم لرسائل تشغيل الوسائط على النحو التالي: urn:x-cast:com.google.cast.media.

ملاحظة: الرسائل والبنى في هذه المواصفات لها حد أقصى ضمني للحجم يتم تحديده من خلال الحد الأقصى لحجم رسالة النقل، وليس هناك حد أقصى للحقول الفردية. يبلغ الحد الأقصى لحجم رسالة النقل حاليًا 64 كيلوبايت.

بُنى بيانات مساحة الاسم الشائعة

يتم تحديد مجموعة كبيرة من بُنى البيانات التي تستخدمها جميع عناصر مساحة اسم الوسائط في مساحة اسم مشتركة.

صورة

هذا هو وصف الصورة الذي يتضمن قدرًا صغيرًا من البيانات الوصفية للسماح لتطبيق المرسِل باختيار الصور بناءً على طريقة عرضها.

الارتفاع والعرض اختياريان في عنصر واحد فقط في مصفوفة من الصور. على سبيل المثال، إذا كان هناك عنصر واحد تم إرجاعه، فهي تكون اختيارية؛ فإذا كان هناك عنصران تم إرجاعهما، يجب أن يحدد عنصر واحد الارتفاع والعرض، لكن يمكن للمرسل أن يختار استخدام الخيار "default" إذا كان لا يتناسب مع العنصر الذي تم تمريره بمعلمات محددة.

الاسم Type الوصف
عنوان URL معرّف الموارد المنتظم (URI) معرّف الموارد المنتظم (URI) للصورة
الارتفاع عدد صحيح اختياري  ارتفاع الصورة
العرض عدد صحيح اختيارية  عرض الصورة

الصوت

مستوى صوت بث الوسائط يُستخدم لتأثيرات التلاشي/الاختفاء التدريجي في بث الوسائط. (ملاحظة: يتم تغيير مستوى صوت النظام باستخدام واجهات برمجة تطبيقات المُرسِل). يجب عدم استخدام مستوى صوت البث مع شريط تمرير مستوى الصوت أو زرَّي التحكّم بمستوى الصوت في الجهاز يجب تمرير معلمة واحدة على الأقل من المعلمات التالية لتغيير مستوى صوت البث.

الاسم Type الوصف
المستوى مزدوج اختياري يعرض هذا الحقل مستوى صوت البث الحالي كقيمة تتراوح بين 0.0 و1.0 حيث يمثّل المستوى 1.0 الحد الأقصى لمستوى الصوت.
كتم الصوت boolean اختياري ما إذا كان جهاز البث مكتومًا أم لا، بغض النظر عن مستوى الصوت

بُنى بيانات مساحة اسم الوسائط

تصف هذه الرسائل حالة مشغّل الوسائط. مساحة الاسم هي urn:x-cast:com.google.cast.media.

MediaInformation

تصف بنية البيانات هذه مصدر بيانات.

الاسم Type الوصف
contentId سلسلة المعرّف الخاص بالخدمة للمحتوى الذي يتم تحميله حاليًا بواسطة مشغّل الوسائط. هذه سلسلة حرة ومخصّصة للتطبيق. وفي معظم الحالات، سيكون هذا هو عنوان URL للوسائط، ولكن يمكن للمرسل اختيار تمرير سلسلة يمكن للمستلم تفسيرها بشكل صحيح. الحدّ الأقصى للطول: ألف واحد
streamType enum
(string)

يصِف نوع الوسائط الإعلامية بأحد الفئات التالية:

  • بدون
  • تخزين مؤقت
  • البث المباشر
contentType سلسلة نوع محتوى MIME للوسائط التي يتم تشغيلها
البيانات الوصفية كائن

اختياري يمثل كائن البيانات الوصفية للوسائط، أحد الخيارات التالية:

المدة مزدوج اختياري مدة البث قيد التشغيل حاليًا بالثواني
customData كائن اختياري  كائن ثنائي كبير من البيانات خاص بالتطبيق المحدد إما من خلال تطبيق المرسِل أو تطبيق المُستلِم

GenericMediaMetadata

يصف عنصر وسائط عامًا.

الاسم Type الوصف
metadataType عدد صحيح 0  (القيمة الوحيدة)
title سلسلة اختياري : تشير هذه السمة إلى عنوان وصفي للمحتوى. يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
subtitle سلسلة اختيارية تشير إلى ترجمة وصفية للمحتوى. يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
صور صورة[] اختياري : مصفوفة من عناوين URL لصورة مرتبطة بالمحتوى. ويمكن أن يقدم المُرسِل القيمة الأولية للحقل في الرسالة تحميل. يجب تقديم المقاسات الموصى بها.
releaseDate سلسلة (ISO 8601) تاريخ ووقت إصدار هذا المحتوى وفقًا لمعيار ISO 8601 اختياري  يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.

MovieMediaMetadata

يصف أداة وسائط الفيلم.

الاسم Type الوصف
metadataType عدد صحيح 1  (القيمة الوحيدة)
title سلسلة اختياري : تشير هذه السمة إلى عنوان وصفي للمحتوى. يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
subtitle سلسلة اختيارية تشير إلى ترجمة وصفية للمحتوى. يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
استوديو سلسلة اختياري  في الاستوديو الذي نشر المحتوى يمكن للمشغّل استرداد "استوديو YouTube" بشكل مستقل باستخدام content_id، أو يمكن للمُرسِل الحصول عليه في الرسالة تحميل.
صور صورة[] اختياري : مصفوفة من عناوين URL لصورة مرتبطة بالمحتوى. ويمكن أن يقدم المُرسِل القيمة الأولية للحقل في الرسالة تحميل. يجب تقديم المقاسات الموصى بها.
releaseDate سلسلة (ISO 8601) تاريخ ووقت إصدار هذا المحتوى وفقًا لمعيار ISO 8601 اختياري  يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.

TvShowMediaMetadata

يصف هذا القسم الأدوات الإعلامية لحلقات برنامج تلفزيوني.

الاسم Type الوصف
metadataType عدد صحيح 2  (القيمة الوحيدة)
seriesTitle سلسلة اختياري : تشير هذه السمة إلى العنوان الوصفي للمسلسل التلفزيوني. يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
subtitle سلسلة اختيارية تشير إلى ترجمة وصفية للحلقة التلفزيونية. يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
الموسم عدد صحيح اختياري رقم الموسم للبرنامج التلفزيوني
حلقة عدد صحيح اختياري رقم الحلقة (في الموسم) من البرنامج التلفزيوني
صور صورة[] اختياري : مصفوفة من عناوين URL لصورة مرتبطة بالمحتوى. ويمكن أن يقدم المُرسِل القيمة الأولية للحقل في الرسالة تحميل. يجب تقديم المقاسات الموصى بها.
originalAirDate سلسلة (ISO 8601) تاريخ ووقت إصدار هذه الحلقة اختياري  وفقًا لمعيار ISO 8601 يمكن للمشغّل استرداد قيمة originAirDate بشكل مستقل باستخدام content_id أو يمكن أن يحدّده المُرسِل في الرسالة Load (تحميل).

MusicTrackMediaMetadata

يصف العنصر الوسائط الخاصة بالمقطع الموسيقي الموسيقي.

الاسم Type الوصف
metadataType عدد صحيح 3  (القيمة الوحيدة)
albumName سلسلة اختياري  الألبوم أو المجموعة التي تم أخذ هذا المقطع الصوتي منها. يمكن للمشغّل استرداد albumName بشكل مستقل باستخدام content_id أو تحديده من قِبل المُرسِل في الرسالة Load (تحميل).
title سلسلة اختياري اسم المقطع الصوتي (مثل عنوان الأغنية) يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
albumArtist سلسلة اختياري  اسم الفنان المرتبط بالألبوم الذي يتضمّن هذه الأغنية يمكن للمشغّل استرداد albumArtist بشكل مستقل باستخدام content_id أو توفيره للمرسل في الرسالة Load (تحميل).
فنّان سلسلة اختياري : اسم الفنّان المرتبط بالمقطع الصوتي للوسائط يمكن للمشغّل استرداد الفنان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
مؤلف سلسلة اختياري : اسم المؤلف المرتبط بمقطع الموسيقى. يمكن للمشغّل استرداد المؤلف بشكل مستقل باستخدام content_id، أو يمكن للمُرسِل الحصول عليه في الرسالة Load.
trackNumber عدد صحيح اختياري رقم المقطع الصوتي في الألبوم
discNumber عدد صحيح اختياري رقم وحدة الصوت (على سبيل المثال، قرص) في الألبوم
صور صورة[] اختياري : مصفوفة من عناوين URL لصورة مرتبطة بالمحتوى. ويمكن أن يقدم المُرسِل القيمة الأولية للحقل في الرسالة تحميل. يجب تقديم المقاسات الموصى بها.
releaseDate سلسلة (ISO 8601) تاريخ ووقت إصدار هذا المحتوى وفقًا لمعيار ISO 8601 اختياري  يمكن للمشغّل استرداد releaseDate بشكل مستقل باستخدام content_id أو يمكن أن يحدده المرسِل في الرسالة Load (تحميل).

PhotoMediaMetadata

تصف أداة الوسائط الفوتوغرافية.

الاسم Type الوصف
metadataType عدد صحيح 4  (القيمة الوحيدة)
title سلسلة اختياري : عنوان الصورة. يمكن للمشغّل استرداد العنوان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
فنّان سلسلة اختياري اسم المصوِّر. يمكن للمشغّل استرداد الفنان بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المرسِل في الرسالة تحميل.
الموقع الجغرافي سلسلة اختياري الموقع اللفظي الذي تم التقاط الصورة فيه، على سبيل المثال "مدريد، إسبانيا" يمكن للمشغّل استرداد الموقع الجغرافي بشكل مستقل باستخدام content_id، أو يمكن أن يحدّده المُرسِل في الرسالة Load (تحميل).
latitude مزدوج اختيارية قيمة خط العرض الجغرافي للموقع الجغرافي الذي تم التقاط الصورة فيه يمكن للمشغّل استرداد خط العرض بشكل مستقل باستخدام content_id، أو يمكن تحديده من خلال المُرسِل في الرسالة Load (تحميل).
longitude مزدوج اختيارية قيمة خط الطول الجغرافي للموقع الجغرافي الذي تم التقاط الصورة فيه. يمكن للمشغّل استرداد خط الطول بشكل مستقل باستخدام content_id، أو يمكن تحديده من خلال المُرسِل في الرسالة Load (تحميل).
العرض عدد صحيح اختياري : عرض الصورة بالبكسل. يمكن للمشغّل استرداد العرض بشكل مستقل باستخدام content_id، أو يمكن تحديده من خلال المرسِل في الرسالة تحميل.
الارتفاع عدد صحيح اختياري  ارتفاع الصورة بالبكسل. يمكن للمشغّل استرداد الارتفاع بشكل مستقل باستخدام content_id، أو يمكن تحديده من خلال المرسِل في الرسالة تحميل.
creationDateTime سلسلة (ISO 8601) تاريخ ووقت التقاط هذه الصورة اختياري  وفقًا لمعيار ISO 8601. يمكن للمشغّل استرداد createDateTime بشكل مستقل باستخدام content_id أو يمكن أن يحدّده المُرسِل في الرسالة Load.

MediaStatus

تصف الحالة الحالية لأدوات الوسائط في ما يتعلق بالجلسة.

الاسم Type الوصف
mediaSessionId عدد صحيح معرّف فريد لتشغيل هذه الجلسة المحدّدة. يعيّن المتلقي هذا المعرّف على LOAD ويمكن استخدامه لتحديد حدث معيّن من عملية تشغيل. على سبيل المثال، في حال شغّلت عمليتَي تشغيل لأغنية Wish you was here في الجلسة نفسها، يتم تحديد فئة mediaSessionId فريدة لكل منهما.
media MediaInformation اختياري (لرسائل الحالة) وصف كامل للمحتوى الذي يتم تشغيله. لا يتم عرضه في رسائل حالة إلا إذا تم تغيير MediaInformation.
playbackRate float لتوضيح ما إذا كان وقت الوسائط يتقدم أم لا، وإلى أي معدل. وهذه الحالة مستقلة عن حالة المشغّل لأنّ وقت تشغيل الوسائط يمكن أن يتوقف بأي حالة. 1.0 هو وقت منتظم، و0.5 هو تصوير بطيء
playerState تعداد (سلسلة)

يصف حالة المشغّل إحدى الحالات التالية:

  • غير نشِط لفترة قصيرة  لم يتم تحميل المشغّل بعد
  • تشغيل  يشغّل اللاعب المحتوى بشكل نشط
  • التخزين المؤقت  اللاعب في وضع Play لكنه لا يشغّل المحتوى بشكل نشط (لن يتغيّر الوقت الحالي)
  • متوقف مؤقتًا  تم إيقاف المشغّل مؤقتًا
idleReason تعداد (سلسلة)

اختيارية إذا كانت حالة PlayerState غير نشطة وكان السبب الذي جعلها غير معروفة، يتم توفير هذه السمة. إذا كان المشغِّل غير نشط بسبب بدئه للتو، لن يتم توفير هذه الخاصية، وإذا كان المُشغِّل في أي حالة أخرى، يجب عدم تقديم هذه الخاصية. تنطبق القيم التالية:

  • تم الإلغاء  طلب مرسِل إيقاف التشغيل باستخدام الأمر "إيقاف"
  • توقّفت  طلب مُرسِل تشغيل وسائط مختلفة باستخدام الأمر LOAD
  • تم الانتهاء  اكتمل تشغيل الوسائط
  • خطأ  تمت مقاطعة الوسائط بسبب خطأ، على سبيل المثال، إذا تعذّر على المشغّل تنزيل الوسائط بسبب مشاكل في الشبكة
currentTime مزدوج الموضع الحالي لمشغِّل الوسائط منذ بداية المحتوى، بالثواني إذا كان هذا محتوى بثًا مباشرًا، يمثّل هذا الحقل الوقت الذي يجب أن يعرفه المشغّل بالثواني من بداية الحدث.
supportedMediaCommands أعلام

علامات تصف أوامر الوسائط المتوافقة مع مشغّل الوسائط:

  • 1  إيقاف مؤقت
  • 2  تقديم/ترجيع
  • 4  مستوى صوت البث
  • 8  كتم صوت البث
  • 16  التخطّي إلى الأمام
  • 32  التخطّي إلى الخلف

يتم وصف المجموعات كتجميعات؛ على سبيل المثال، Pause+Seek+StreamVolume+ المرتبطة == 15.

مستوى الصوت مستوى الصوت مستوى صوت مجموعة البث
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيق الذي يحدده تطبيق المُستلِم

الأوامر من المرسِل إلى المستلم

تتحكّم هذه الأوامر في مشغّل الوسائط. يجب أن تكون جميع كائنات customData في الرسائل أدناه اختيارية (أي من المفترض أن يتراجع المتلقّي بشكل صحيح في حال عدم تمرير البيانات). سيسمح هذا للتطبيقات العامة للتحكّم عن بُعد بالعمل بشكل سليم.

تحميل

تحميل محتوى جديد إلى مشغّل الوسائط

الاسم Type الوصف
requestId عدد صحيح معرّف الطلب لربط الطلب والردّ
النوع سلسلة LOAD (القيمة فقط)
media MediaInformation البيانات الوصفية (بما في ذلك contentId) للوسائط المطلوب تحميلها
تشغيل تلقائي boolean

اختياري (القيمة التلقائية هي true) إذا تم تحديد مَعلمة التشغيل التلقائي، سيبدأ مشغّل الوسائط في تشغيل المحتوى عند تحميله. حتى إذا لم يتم تحديد التشغيل التلقائي، قد يختار تطبيق مشغّل الوسائط بدء التشغيل على الفور. إذا بدأ التشغيل، يجب ضبط حالة المشغّل في الاستجابة على "تخزين مؤقت"، وإلا يجب ضبطه على "متوقف مؤقتًا"

currentTime مزدوج اختيارية بالثواني منذ بداية المحتوى إذا كان المحتوى مباشرًا ولم يتم تحديد الموضع، سيبدأ البث من هذا الموضع.
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيقات حددها تطبيق المرسِل
الإجابة أسباب طلب المساعدة عمليات البث الأخطاء
لا ينطبق تغيير حالة جهاز الاستقبال رسالة تغيير حالة الوسائط حالة المشغّل غير صالحة
تعذّر التحميل
تم إلغاء التحميل

إيقاف مؤقت

لإيقاف تشغيل المحتوى الحالي مؤقتًا. لتشغيل إشعار بحدث "حالة" لجميع تطبيقات المرسلين.

الاسم Type الوصف
mediaSessionId عدد صحيح رقم تعريف جلسة الوسائط المراد إيقافها مؤقتًا
requestId عدد صحيح معرّف الطلب، لاستخدامه لربط الطلب/الاستجابة
النوع سلسلة إيقاف مؤقت (القيمة فقط)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيقات حددها تطبيق المرسِل
الإجابة أسباب طلب المساعدة عمليات البث الأخطاء
لا ينطبق تغيير حالة جهاز الاستقبال رسالة تغيير حالة الوسائط حالة المشغّل غير صالحة

استدعاء

لتعيين الموضع الحالي في ساحة المشاركات. لتشغيل إشعار بحدث "حالة" لجميع تطبيقات المرسلين. إذا كان الموضع المقدّم خارج نطاق المواضع الصالحة للمحتوى الحالي، يجب أن يختار المشغّل موضعًا صالحًا أقرب ما يمكن للموضع المطلوب.

الاسم Type الوصف
mediaSessionId عدد صحيح رقم تعريف جلسة الوسائط التي تم فيها ضبط موضع مجموعة البث
requestId عدد صحيح معرّف الطلب لربط الطلب والردّ
النوع سلسلة SeeK (القيمة فقط)
resumeState تعداد (سلسلة)

اختياري إذا لم يتم ضبط هذه السياسة، لن تتغير حالة التشغيل، وتنطبق القيم التالية:

  • PLAYBACK_START  لفرض تشغيل الوسائط
  • PLAYBACK_PAUSE  لفرض إيقاف الوسائط مؤقتًا
currentTime مزدوج اختيارية بالثواني منذ بداية المحتوى إذا كان المحتوى مباشرًا ولم يتم تحديد الموضع، سيبدأ البث من هذا الموضع.
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيقات حددها تطبيق المرسِل
الإجابة أسباب طلب المساعدة عمليات البث الأخطاء
لا ينطبق تغيير حالة جهاز الاستقبال رسالة تغيير حالة الوسائط حالة المشغّل غير صالحة

إيقاف

إيقاف تشغيل المحتوى الحالي لتشغيل إشعار بحدث "حالة" لجميع تطبيقات المرسلين. بعد هذا الأمر، لن يتم تحميل المحتوى وسيتم إلغاء صلاحية mediaSessionId.

الاسم Type الوصف
mediaSessionId عدد صحيح رقم تعريف جلسة الوسائط لإيقاف المحتوى
requestId عدد صحيح معرّف الطلب لربط الطلب والردّ
النوع سلسلة إيقاف (القيمة فقط)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيقات حددها تطبيق المرسِل
الإجابة أسباب طلب المساعدة عمليات البث الأخطاء
لا ينطبق تغيير حالة جهاز الاستقبال رسالة تغيير حالة الوسائط حالة المشغّل غير صالحة

تشغيل

لبدء تشغيل المحتوى الذي تم تحميله مع استدعاء التحميل، ويستمر التشغيل من موضع الوقت الحالي.

الاسم Type الوصف
mediaSessionId عدد صحيح رقم تعريف جلسة الوسائط للمحتوى الذي سيتم تشغيله
requestId عدد صحيح معرّف الطلب لربط الطلب والردّ
النوع سلسلة PLAY (القيمة فقط)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيقات حددها تطبيق المرسِل
الإجابة أسباب طلب المساعدة عمليات البث الأخطاء
لا ينطبق تغيير حالة جهاز الاستقبال رسالة تغيير حالة الوسائط حالة المشغّل غير صالحة

الحصول على الحالة

لاسترداد حالة الوسائط.

الاسم Type الوصف
mediaSessionId عدد صحيح اختياري  معرّف جلسة الوسائط للوسائط التي يجب عرض حالة الوسائط لها. وفي حال عدم تقديم أي من هذه البيانات، سيتم تقديم حالة جميع أرقام تعريف جلسات الوسائط.
requestId عدد صحيح معرّف الطلب لربط الطلب والردّ
النوع سلسلة GET_STATUS (القيمة فقط)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيقات حددها تطبيق المرسِل
الإجابة أسباب طلب المساعدة عمليات البث الأخطاء
رسالة MediaStatus إلى المرسل الذي طلبها لا ينطبق لا ينطبق لا ينطبق

SetVolume

لضبط مستوى صوت بث الوسائط. يُستخدم لتأثيرات التلاشي/الاختفاء التدريجي في بث الوسائط. (ملاحظة: يتم تغيير مستوى صوت المستلِم باستخدام setVolume للمُرسِل على الويب). ولا تستخدم مستوى صوت البث مع شريط تمرير مستوى الصوت أو زرَّي التحكّم بمستوى الصوت للتحكم في مستوى صوت الجهاز. ولن يؤدي أي تغيير في مستوى صوت البث إلى تشغيل أي واجهة مستخدم على جهاز الاستقبال.

الاسم Type الوصف
mediaSessionId عدد صحيح معرِّف جلسة الوسائط للوسائط التي تم تغيير مستوى صوت البث لها
requestId عدد صحيح معرّف الطلب لربط الطلب والردّ
النوع سلسلة VOLUME (القيمة فقط)
مستوى الصوت مستوى الصوت مستوى صوت مجموعة البث
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيقات حددها تطبيق المرسِل
الإجابة أسباب طلب المساعدة عمليات البث الأخطاء
لا ينطبق تغيير حالة جهاز الاستقبال رسالة تغيير حالة الوسائط حالة المشغّل غير صالحة

الرسائل من المستلِم إلى المُرسِل

ويرسل المُستلِم نوعَين من الرسائل:

  • الأخطاء: رسائل البث الأحادي التي يتم إرسالها عندما يكون هناك خطأ في الاستجابة لطلب المُرسِل.
  • الحالة: رسائل البث.
    • نتيجة لإجراء نفّذه المرسِل. ستحتوي على رقم تعريف الطلب الذي تسبب في التغيير.
    • عفوي: على سبيل المثال، بسبب تغيير يؤدّيه تطبيق المُستلِم. سيكون رقم تعريف الطلب 0.

خطأ: حالة المشغّل غير صالحة

يتم إرساله عندما يتعذر تلبية طلب المرسل لأن المشغل ليس في حالة صالحة. على سبيل المثال، إذا لم ينشئ التطبيق عنصر وسائط بعد.

الاسم Type الوصف
requestId عدد صحيح رقم تعريف الطلب الذي أدّى إلى ظهور هذا الخطأ
النوع سلسلة INVALID_PLAYER_STATE (القيمة فقط)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيق الذي يحدده تطبيق المُستلِم

خطأ: تعذّر التحميل

يتم إرساله عند فشل طلب التحميل. ستكون حالة المشغّل غير نشطة.

الاسم Type الوصف
requestId عدد صحيح رقم تعريف الطلب الذي أدّى إلى ظهور هذا الخطأ
النوع سلسلة LOAD_FAILED (القيمة فقط)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيق الذي يحدده تطبيق المُستلِم

خطأ: تم إلغاء التحميل

يتم إرساله عند إلغاء طلب التحميل (تم استلام طلب تحميل ثانٍ).

الاسم Type الوصف
requestId عدد صحيح رقم تعريف الطلب الذي أدّى إلى ظهور هذا الخطأ
النوع سلسلة LOAD_CANCELLED (القيمة فقط)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيق الذي يحدده تطبيق المُستلِم

خطأ: طلب غير صالح

يتم إرساله عندما يكون الطلب غير صالح (على سبيل المثال، نوع طلب غير معروف).

الاسم Type الوصف
requestId عدد صحيح رقم تعريف الطلب الذي أدّى إلى ظهور هذا الخطأ
النوع سلسلة INVALID_REQUEST (القيمة فقط)
السبب قيم التعداد (سلسلة)

القيم:

  • INVALID_COMMAND  الأمر غير متوافق
  • DUPLICATE_REQUESTID  مُعرّف الطلب غير فريد (يعالج المُستلِم طلبًا برقم التعريف نفسه)
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيق الذي يحدده تطبيق المُستلِم

حالة الوسائط

يتم إرساله بعد تغيير الحالة أو بعد طلب حالة وسائط. ولن يتم إرسال سوى عناصر MediaStatus التي تم تغييرها أو طلبها.

الاسم Type الوصف
requestId عدد صحيح المعرّف المستخدَم لربط استجابة الحالة هذه بالطلب الذي أصدرها، أو 0 إذا كانت رسالة الحالة تلقائية (لم يتم تشغيلها من خلال طلب مُرسِل). ستنشئ تطبيقات المرسِل معرّفات طلبات فريدة من خلال اختيار رقم عشوائي وزيادته باستمرار (لن تستخدم الرقم 0).
النوع سلسلة MEDIA_STATUS (القيمة فقط)
الحالة MediaStatus[] مصفوفة من كائنات حالة الوسائط. ملاحظة: لن يتم عرض عنصر الوسائط في MediaStatus إلا إذا تم تغييره.
customData كائن اختياري  كائن ثنائي كبير من البيانات الخاصة بالتطبيق الذي يحدده تطبيق المُستلِم