فئة 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
 معلومات الوسائط المرتبطة بهذا العنصر المزيد...
 
NSUInteger 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: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  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: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  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

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

- (NSUInteger) itemID
readnonatomicassign

معرّف العنصر، أو kGCKMediaQueueInvalidItemID إذا لم يتم تحديد معرّف بعد

- (BOOL) autoplay
readnonatomicassign

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

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

- (NSTimeInterval) startTime
readnonatomicassign

تمثّل هذه السمة وقت بدء العنصر بالثواني.

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

- (NSTimeInterval) playbackDuration
readnonatomicassign

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

- (NSTimeInterval) preloadTime
readnonatomicassign

تحدّد هذه السمة المدة بالثواني التي يجب أن يبدأ خلالها جهاز الاستقبال في التحميل المُسبَق لهذا العنصر قبل انتهاء العنصر السابق.

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

- (NSArray<NSNumber *>*) activeTrackIDs
readnonatomicstrong

معرّفات المسارات النشطة لهذا العنصر

- (id) customData
readnonatomicstrong

البيانات المخصّصة المرتبطة بهذا العنصر، إن وُجدت