الوضع في قائمة الانتظار

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

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

إنشاء عناصر قائمة انتظار الوسائط وتحميلها

في iOS، يتم تمثيل عنصر قائمة انتظار الوسائط في إطار عمل البث على شكل مثال واحد (GCKMediaQueueItem) عند إنشاء عنصر في قائمة انتظار الوسائط باستخدام محتوى تكيّفي، يمكنك ضبط وقت التحميل المسبق بحيث يمكن للمشغل بدء التخزين المؤقت لعنصر قائمة انتظار الوسائط قبل ينتهي تشغيل العنصر الذي ينتظره في قائمة الانتظار. الاطّلاع على المزيد حول التحميل المُسبق في الـ دليل التحميل المُسبق لـ "جهاز استقبال الويب"

ضبط التشغيل التلقائي للعنصر على "صحيح" تسمح لمستقبل الويب بتشغيلها تلقائيًا. على سبيل المثال: يمكنك استخدام نمط أداة إنشاء لإنشاء عنصر قائمة انتظار الوسائط على النحو التالي:

Swift
let builder = GCKMediaQueueItemBuilder.init()
builder.mediaInformation = mediaInformation
builder.autoplay = true
builder.preloadTime = 8.0
let newItem = builder.build()
الهدف-ج
GCKMediaQueueItemBuilder *builder = [[GCKMediaQueueItemBuilder alloc] init];
builder.mediaInformation = self.mediaInformation;
builder.autoplay = YES;
builder.preloadTime = 8.0;
GCKMediaQueueItem *newItem = [builder build];

يمكنك تحميل صفيف من عناصر قائمة انتظار الوسائط في قائمة الانتظار باستخدام الأدوات المناسبة طريقة queueLoadItems من GCKRemoteMediaClient الصف.

تلقّي تحديث عن حالة قائمة انتظار الوسائط

عندما يحمّل جهاز استقبال الويب عنصرًا قائمة انتظار وسائط، فإنه يعين معرفًا فريدًا عنصر قائم طوال مدة الجلسة (وعمر قائمة الانتظار). يمكنك الاطّلاع على حالة قائمة الانتظار التي تشير إلى العنصر المُحمَّل حاليًا. (قد لا يتم تشغيله) أو تحميله أو تحميله مسبقًا يمكنك أيضًا الحصول على طلب قائمة بجميع العناصر في قائمة الانتظار. تشير رسالة الأشكال البيانية GCKMediaStatus الفئة معلومات الحالة التالية:

  • preloadedItemID السمة - معرّف السلعة التي تمّ تحميلها مسبقًا، إن توفّرت.
  • loadingItemID السمة - معرّف العنصر الذي يتم تحميله حاليًا،
  • currentItemID الخاصية - معرّف عنصر قائمة الانتظار الحالي، إن وجد.
  • queueItemCount الطريقة - لعرض عدد العناصر في قائمة انتظار التشغيل.
  • queueItemAtIndex الطريقة - لعرض العنصر في الفهرس المحدد في قائمة انتظار التشغيل.

استخدم هؤلاء الأعضاء مع غيرهم من أعضاء حالة الوسائط لإبلاغ التطبيق حول حالة قائمة الانتظار والعناصر الموجودة في قائمة الانتظار. بالإضافة إلى تحديثات حالة الوسائط من مستقبل الويب، فيمكنك الاستماع إلى التغييرات التي تطرأ على عن طريق تنفيذ -[remoteMediaClientDidUpdateQueue:] من GCKRemoteMediaClientListener

تعديل قائمة المحتوى التالي

للتعامل مع العناصر الموجودة في قائمة الانتظار، استخدم طرق قائمة الانتظار GCKRemoteMediaClient لديك العديد من واجهات برمجة التطبيقات. وهي تتيح لك تحميل صفيف من العناصر في قائمة انتظار جديدة، إدراج عناصر في قائمة انتظار حالية، وتحديث خصائص العناصر في قائمة الانتظار، وجعل عنصر ينتقل للأمام أو الخلف في قائمة الانتظار، وتعيين خصائص قائمة المحتوى التالي نفسها (على سبيل المثال، تغيير repeatMode الذي يختار التالي ثم إزالة العناصر من قائمة الانتظار وإعادة ترتيب العناصر في قائمة الانتظار.