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

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

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

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

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

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

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

صورة

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

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

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

مجلد

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

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

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

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

معلومات الوسائط

تصف بنية البيانات هذه مصدر الوسائط.

الاسم	النوع	الوصف
معرّف المحتوى	سلسلة	المعرّف الخاص بالخدمة للمحتوى الذي يتم تحميله حاليًا بواسطة مشغّل الوسائط. هذه سلسلة ذات شكل حر خاصة بالتطبيق. وفي معظم الحالات، سيكون هذا هو عنوان URL للوسائط، ولكن يمكن للمرسِل اختيار تمرير سلسلة يمكن للمتلقي تفسيرها بشكل صحيح. أقصى طول: 1 كيلوبايت
streamType	تعداد (سلسلة)	تصف نوع العنصر من الوسائط بإحدى الطرق التالية: بدون تم التخزين المؤقت مباشر
نوع المحتوى	سلسلة	نوع محتوى MIME للوسائط التي يتم تشغيلها
البيانات الوصفية	كائن	اختياري كائن البيانات الوصفية للوسائط، وهو أحد العناصر التالية: 0 UniversalMediaMetadata 1 MovieMediaMetadata 2 TvShowMediaMetadata 3 MusicTrackMediaMetadata 4 PhotoMediaMetadata
المدة	مزدوج	اختيارية مدة البث الحالي الذي يتم تشغيله بالثواني
customData	كائن	اختياري كائن تخزين البيانات الثنائية الكبيرة لتطبيق محدد بواسطة تطبيق المرسل أو تطبيق المستلم

البيانات الوصفية للوسائط العامة

تصف مادة وسائط عامة.

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

البيانات الوصفية لـ MovieMedia

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

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

البيانات الوصفية للعروض التلفزيونية

وصف عنصر وسائط وسائط العرض التلفزيوني.

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

البيانات الوصفية لـ MusicTrackMedia

وصف عنصر وسائط وسائط صوتية موسيقية.

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

صورة MediaMedia

وصف عنصر وسائط فوتوغرافية.

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

حالة الوسائط

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

الاسم	النوع	الوصف
mediaSessionId	عدد صحيح	المعرّف الفريد لتشغيل هذه الجلسة المحدّدة. ويتم تعيين هذا المعرّف من قِبل المتلقي على LOAD، ويمكن استخدامه لتحديد حالة معينة من عملية تشغيل. على سبيل المثال، إنّ مرّتَي تشغيل "تمنيت لو كنت هنا" خلال الجلسة نفسها ستحتوي على معرّف وسائط جلسة فريد.
الوسائط	معلومات الوسائط	اختياري (لرسائل الحالة) وصف كامل للمحتوى الذي يتم تشغيله. ولا يتم عرضها في رسائل الحالة إلا إذا تم تغيير MediaInformation.
معدل التشغيل	عدد عائم	يشير إلى ما إذا كان وقت الوسائط يتقدم أم لا، وما هو المعدّل المطلوب. وهذا مستقل عن حالة المشغّل حيث يمكن أن يتوقف وقت الوسائط في أي حالة. 1.0 عبارة عن وقت عادي و0.5 حركة بطيئة
playerState	تعداد (سلسلة)	تصف حالة المشغّل باعتبارها واحدة مما يلي: خامل لم يتم تحميل المشغل بعد PLAYING يشغّل اللاعب المحتوى التخزين المؤقت "مشغّل Google Play" في "وضع PLAY" ولكنه لا يشغّله حاليًا (لا يتم تغيير الوقت الحالي) PAUSED تم إيقاف المشغّل مؤقتًا
خامل	تعداد (سلسلة)	اختيارية إذا كانت حالة stateLE هي IDLE وكان اسمها معروفًا، يتم توفير هذه الخاصية. إذا كان المشغل في وضع الخمول نظرًا لأنه قد بدأ تشغيله للتو، فلن يتم توفير هذه الخاصية؛ وإذا كان المشغل في أي حالة أخرى، ينبغي عدم توفير هذه الخاصية. يتم تطبيق القيم التالية: تم الإلغاء طلب مرسِل إيقاف التشغيل باستخدام الأمر STOP مقاطعة طلب أحد المرسلين تشغيل وسائط مختلفة باستخدام الأمر LOAD FINISHED اكتمل تشغيل الوسائط ERROR تمت مقاطعة الوسائط بسبب حدوث خطأ، على سبيل المثال، إذا تعذر على المشغل تنزيل الوسائط بسبب مشكلات في الشبكة
currentTime	مزدوج	الموضع الحالي لمشغّل الوسائط منذ بداية المحتوى، بالثواني. إذا كان هذا المحتوى عبارة عن بث مباشر، يمثّل هذا الحقل الوقت بالثواني من بداية الحدث الذي يجب أن يكون معروفًا للمشغل.
supportedMediaCommands	أعلام	علامات تصف أوامر الوسائط التي يدعمها مشغل الوسائط: 1 إيقاف مؤقت 2 تقديم/ترجيع 4 مستوى صوت البث 8 تجاهل البث 16 تخطي 32 الانتقال إلى الخلف يتم وصف المجموعات كتجميعات، على سبيل المثال، Pause+Seek+StreamVolume+كتم الصوت == 15.
المجلد	مستوى الصوت	مستوى صوت البث
customData	كائن	اختياري كائن تخزين البيانات الثنائية الكبيرة الخاص بالتطبيق الذي يحدده تطبيق المتلقي

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

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

تحميل

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

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

الإجابة	أسباب طلب المساعدة	عمليات البث	الأخطاء
لا ينطبق	تغيير حالة المُستلِم	رسالة تغيير حالة الوسائط	حالة اللاعب غير صالحة تعذّر التحميل تم إلغاء التحميل

إيقاف مؤقت

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

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

الإجابة	أسباب طلب المساعدة	عمليات البث	الأخطاء
لا ينطبق	تغيير حالة المُستلِم	رسالة تغيير حالة الوسائط	حالة اللاعب غير صالحة

استدعاء

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

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

الإجابة	أسباب طلب المساعدة	عمليات البث	الأخطاء
لا ينطبق	تغيير حالة المُستلِم	رسالة تغيير حالة الوسائط	حالة اللاعب غير صالحة

إيقاف

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

الاسم	النوع	الوصف
mediaSessionId	عدد صحيح	رقم تعريف جلسة الوسائط حتى يتم إيقاف المحتوى
معرّف الطلب	عدد صحيح	رقم تعريف الطلب لربط الطلب والاستجابة
type (النوع)	سلسلة	STOP (القيمة فقط)
customData	كائن	اختياري كائن تخزين البيانات الثنائية الكبيرة لتطبيق محدد من قبل تطبيق المرسل

الإجابة	أسباب طلب المساعدة	عمليات البث	الأخطاء
لا ينطبق	تغيير حالة المُستلِم	رسالة تغيير حالة الوسائط	حالة اللاعب غير صالحة

تشغيل

لبدء تشغيل المحتوى الذي تم تحميله بمكالمة التحميل، تتم متابعة التشغيل من الموضع الزمني الحالي.

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

الإجابة	أسباب طلب المساعدة	عمليات البث	الأخطاء
لا ينطبق	تغيير حالة المُستلِم	رسالة تغيير حالة الوسائط	حالة اللاعب غير صالحة

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

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

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

الإجابة	أسباب طلب المساعدة	عمليات البث	الأخطاء
رسالة MediaStatus إلى المُرسِل الذي طلبها	لا ينطبق	لا ينطبق	لا ينطبق

ضبط مستوى الصوت

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

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

الإجابة	أسباب طلب المساعدة	عمليات البث	الأخطاء
لا ينطبق	تغيير حالة المُستلِم	رسالة تغيير حالة الوسائط	حالة اللاعب غير صالحة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الاسم	النوع	الوصف
معرّف الطلب	عدد صحيح	معرّف الطلب الذي أدى إلى ظهور هذا الخطأ
type (النوع)	سلسلة	INVALID_REQUEST (القيمة فقط)
السبب	Enum (سلسلة)	القيم: INVALID_COMMAND الأمر غير مدعوم DUPLICATE_REQUESTID معرّف الطلب ليس فريدًا (يعالج المستلم طلبًا برقم التعريف نفسه)
customData	كائن	اختياري كائن تخزين البيانات الثنائية الكبيرة الخاص بالتطبيق الذي يحدده تطبيق المتلقي

حالة الوسائط

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

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