در صف

چارچوب Cast، APIهای صف را ارائه می‌کند که از ایجاد فهرست‌هایی از موارد محتوا، مانند جریان‌های ویدیویی یا صوتی، برای پخش متوالی در گیرنده وب پشتیبانی می‌کنند. صف اقلام محتوا ممکن است ویرایش، مرتب‌سازی مجدد، به‌روزرسانی و غیره باشد.

Web Receiver SDK تا زمانی که صف حداقل یک مورد فعال داشته باشد (در حال پخش یا توقف) صف را حفظ می کند و به عملیات روی صف پاسخ می دهد. فرستنده ها می توانند به جلسه بپیوندند و موارد را به صف اضافه کنند. گیرنده یک جلسه را برای آیتم های صف نگه می دارد تا زمانی که آخرین آیتم پخش را کامل کند یا فرستنده پخش را متوقف کند و جلسه را خاتمه دهد، یا تا زمانی که فرستنده یک صف جدید را روی گیرنده بارگذاری کند. گیرنده به طور پیش فرض هیچ اطلاعاتی در مورد صف های پایان یافته نگهداری نمی کند. پس از اتمام آخرین مورد در صف، جلسه رسانه به پایان می رسد و صف ناپدید می شود.

موارد صف رسانه را ایجاد و بارگیری کنید

در iOS، یک آیتم صف رسانه در چارچوب Cast به عنوان یک نمونه GCKMediaQueueItem نشان داده می‌شود. هنگامی که یک آیتم صف رسانه با محتوای تطبیقی ​​ایجاد می کنید، می توانید زمان پیش بارگذاری را طوری تنظیم کنید که پخش کننده بتواند قبل از اینکه آیتم جلوتر از آن در صف پخش شود، شروع به بافر کردن آیتم صف رسانه ای کند. در راهنمای بارگذاری پیش بارگیری Web Receiver اطلاعات بیشتری درباره پیش بارگیری مشاهده کنید.

تنظیم ویژگی پخش خودکار مورد روی true به گیرنده وب اجازه می دهد تا آن را به طور خودکار پخش کند. به عنوان مثال، می توانید از یک الگوی سازنده برای ایجاد آیتم صف رسانه خود به صورت زیر استفاده کنید:

سویفت
let builder = GCKMediaQueueItemBuilder.init()
builder.mediaInformation = mediaInformation
builder.autoplay = true
builder.preloadTime = 8.0
let newItem = builder.build()
هدف-C
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 استفاده کنید. شما چندین API دارید. اینها به شما امکان می‌دهند آرایه‌ای از آیتم‌ها را در یک صف جدید بارگذاری کنید، آیتم‌ها را در یک صف موجود وارد کنید، ویژگی‌های آیتم‌ها را در صف به‌روزرسانی کنید، یک آیتم را به جلو یا عقب در صف بپرید، ویژگی‌های خود صف را تنظیم کنید (به عنوان مثال ، repeatMode تغییر دهید که مورد بعدی را انتخاب می کند)، موارد را از صف حذف کنید و موارد موجود در صف را دوباره ترتیب دهید.