فئة GCKMediaQueueItem

مرجع فئة GCKMediaQueueItem

نظرة عامة

صف يمثّل عنصرًا في قائمة انتظار الوسائط.

إنّ مثيلات هذا الكائن غير قابلة للتغيير.

تُستخدم هذه الفئة في الاتصال المتبادل بين تطبيق المُرسِل وتطبيق الاستقبال. ينشئ المرسِل هذه العناصر لتحميل قائمة بعناصر الوسائط أو إدراجها في تطبيق المتلقّي. تتضمّن أيضًا السمة GCKMediaStatus الواردة من المُستلِم قائمة العناصر الممثَّلة كمثيلات لهذه الفئة.

بعد التحميل، سيضبط المُستلِم معرّف سلعة فريد لكل GCKMediaQueueItem، حتى إذا تم تحميل الوسائط نفسها عدة مرات.

تكتسب NSObject. تنفيذ <NSCopying>.

ملخّص طريقة المثيل

(instancetype) - initWithMediaInformation:autoplay:startTime:preloadTime:activeTrackIDs:customData:
 تنشئ علامة GCKMediaQueueItem جديدة بالسمات المحددة. المزيد...
 
(instancetype) - initWithMediaInformation:autoplay:startTime:playbackDuration:preloadTime:activeTrackIDs:customData:
 المُهيئ المُعيّن. المزيد...
 
(void) - clearItemID
 محو (إلغاء تعيين) معرّف العنصر. المزيد...
 
(instancetype) - mediaQueueItemModifiedWithBlock:
 لعرض نسخة من GCKMediaQueueItem تم تعديلها بواسطة المجموعة المحدّدة. المزيد...
 

ملخّص الموقع

GCKMediaInformationmediaInformation
 معلومات الوسائط المرتبطة بهذا العنصر. المزيد...
 
GCKMediaQueueItemID itemID
 معرّف السلعة أو kGCKMediaQueueInvalidItemID في حال لم يتم تخصيص معرّف بعد المزيد...
 
BOOL autoplay
 لتحديد ما إذا كان يجب بدء تشغيل العنصر تلقائيًا عندما يصبح العنصر الحالي في قائمة الانتظار أم لا. المزيد...
 
NSTimeInterval startTime
 وقت بدء العنصر بالثواني. المزيد...
 
NSTimeInterval playbackDuration
 مدة تشغيل العنصر، بالثواني أو INFINITY إذا كان يجب استخدام المدة الفعلية للبث. المزيد...
 
NSTimeInterval preloadTime
 المدة التي تسبق انتهاء تحميل المحتوى السابق بالثواني قبل أن يبدأ المستلِم التحميل المُسبق لهذا العنصر. المزيد...
 
NSArray< NSNumber * > * activeTrackIDs
 أرقام تعريف التتبّع النشطة لهذا العنصر. المزيد...
 
id customData
 البيانات المخصّصة المرتبطة بهذا العنصر، إن توفّرت. المزيد...
 

تفاصيل الطريقة

- (instancetype) initWithMediaInformation: (GCKMediaInformation *)  mediaInformation
autoplay: (BOOL)  autoplay
startTime: (NSTimeInterval)  startTime
preloadTime: (NSTimeInterval)  preloadTime
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs
customData: (nullable id)  customData 

تنشئ علامة GCKMediaQueueItem جديدة بالسمات المحددة.

اطّلِع على وثائق السمات المقابلة لمزيد من المعلومات.

Parameters
mediaInformationThe media information for the item.
autoplayThe autoplay state for this item.
startTimeThe start time of the item, in seconds. May be kGCKInvalidTimeInterval if this item refers to a live stream or if the default start time should be used.
preloadTimeThe preload time for the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time.
activeTrackIDsThe active track IDs for the item. May be nil.
customDataAny custom data to associate with the item. May be nil.
- (instancetype) initWithMediaInformation: (GCKMediaInformation *)  mediaInformation
autoplay: (BOOL)  autoplay
startTime: (NSTimeInterval)  startTime
playbackDuration: (NSTimeInterval)  playbackDuration
preloadTime: (NSTimeInterval)  preloadTime
activeTrackIDs: (nullable NSArray< NSNumber * > *)  activeTrackIDs
customData: (nullable id)  customData 

المُهيئ المُعيّن.

تنشئ علامة GCKMediaQueueItem جديدة بالسمات المحددة. اطّلِع على وثائق السمات المقابلة لمزيد من المعلومات.

Parameters
mediaInformationThe media information for the item.
autoplayThe autoplay state for this item.
startTimeThe start time of the item, in seconds. May be kGCKInvalidTimeInterval if this item refers to a live stream or if the default start time should be used.
playbackDurationThe playback duration of the item, in seconds. May be kGCKInvalidTimeInterval to indicate no preload time.
preloadTimeThe preload time for the item, in seconds.
activeTrackIDsThe active track IDs for the item. May be nil.
customDataAny custom data to associate with the item. May be nil.
- (void) clearItemID

محو (إلغاء تعيين) معرّف العنصر.

يجب استدعاءها لإعادة استخدام مثيل موجود، على سبيل المثال، لإضافته مرة أخرى إلى قائمة الانتظار.

- (instancetype) mediaQueueItemModifiedWithBlock: (void(^)(GCKMediaQueueItemBuilder *builder))  block

لعرض نسخة من GCKMediaQueueItem تم تعديلها بواسطة المجموعة المحدّدة.

Parameters
blockA block that receives a GCKMediaQueueItemBuilder which can be used to modify attributes of the copy. It is not necessary to call the builder's build (GCKMediaQueueItemBuilder) method within the block, as this method will do that automatically when the block completes.
المرتجعات
نسخة معدَّلة من هذا العنصر

تفاصيل الموقع

- (GCKMediaInformation*) mediaInformation
readnonatomicstrong

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

- (GCKMediaQueueItemID) itemID
readnonatomicassign

معرّف السلعة أو kGCKMediaQueueInvalidItemID في حال لم يتم تخصيص معرّف بعد

- (BOOL) autoplay
readnonatomicassign

لتحديد ما إذا كان يجب بدء تشغيل العنصر تلقائيًا عندما يصبح العنصر الحالي في قائمة الانتظار أم لا.

إذا كان NO، سيتم إيقاف قائمة المحتوى التالي مؤقتًا عند وصولها إلى هذا العنصر. القيمة التلقائية هي YES. عند استخدام هذا العنصر لتحميل قائمة انتظار وسائط في GCKMediaLoadRequestData، لن تسري هذه السمة في العنصر الأول إلا إذا كان autoplay في GCKMediaLoadRequestData فارغًا.

- (NSTimeInterval) startTime
readnonatomicassign

وقت بدء العنصر بالثواني.

القيمة التلقائية هي kGCKInvalidTimeInterval، للإشارة إلى أنّه لم يتم ضبط وقت بدء.

- (NSTimeInterval) playbackDuration
readnonatomicassign

مدة تشغيل العنصر، بالثواني أو INFINITY إذا كان يجب استخدام المدة الفعلية للبث.

- (NSTimeInterval) preloadTime
readnonatomicassign

المدة التي تسبق انتهاء تحميل المحتوى السابق بالثواني قبل أن يبدأ المستلِم التحميل المُسبق لهذا العنصر.

القيمة التلقائية هي kGCKInvalidTimeInterval، للإشارة إلى أنّه لم يتم ضبط أي مدة للتحميل المُسبق.

- (NSArray<NSNumber *>*) activeTrackIDs
readnonatomicstrong

أرقام تعريف التتبّع النشطة لهذا العنصر.

- (id) customData
readnonatomicstrong

البيانات المخصّصة المرتبطة بهذا العنصر، إن توفّرت.