فئة GCKMediaLoadRequestData

مرجع فئة GCKMediaLoadRequestData

نظرة عامة

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

تُستخدَم هذه الفئة من خلال أوامر تحميل الوسائط في GCKRemoteMediaClient لتحديد كيفية تحميل تطبيق جهاز الاستقبال للوسائط.

لتحميل عنصر واحد، يجب تحديد العنصر المراد تحميله باللغة mediaInformation. لتحميل قائمة انتظار غير سحابية، يجب تحديد معلومات قائمة الانتظار في queueData. بشكل اختياري، يمكن تحديد معلومات أول عنصر يتم تشغيله في mediaInformation. إذا كانت قائمة الانتظار عبارة عن قائمة انتظار على السحابة الإلكترونية، يمكن أن تكون قيمة items في nil أو فارغة، ولكن يجب تحديد entity ليتمكّن تطبيق جهاز الاستقبال من جلب قائمة الانتظار من السحابة الإلكترونية باستخدام entity. إذا لم يتم تحديد mediaInformation أو queueData، سيتعذّر تنفيذ طلبات التحميل بدون الإرسال إلى تطبيقات المُستلِم.

منذ
4.4.1

تكتسب NSObject و<NSCopying> و <NSSecureCoding>.

ملخّص الموقع

GCKMediaInformationmediaInformation
 عنصر الوسائط المطلوب تحميله. المزيد...
 
GCKMediaQueueDataqueueData
 البيانات الوصفية لمادة الوسائط أو قائمة المحتوى التالي المزيد...
 
NSNumber * autoplay
 العلامة التي تحدّد ما إذا كان بدء التشغيل فور التحميل المزيد...
 
NSTimeInterval startTime
 موضع التشغيل الأولي. المزيد...
 
float playbackRate
 معدّل التشغيل المزيد...
 
NSArray< NSNumber * > * activeTrackIDs
 مصفوفة من الأعداد الصحيحة تحدد المسارات النشطة. المزيد...
 
id customData
 البيانات المخصصة الخاصة بالتطبيق التي يتم تمريرها مع الطلب. المزيد...
 
NSString * credentials
 بيانات اعتماد المستخدم لعنصر الوسائط الذي يجري تحميله. المزيد...
 
NSString * credentialsType
 نوع بيانات اعتماد المستخدم المحددة في GCKMediaLoadRequestData::credentials. المزيد...
 
NSString * atvCredentials
 بيانات اعتماد Android TV البديلة لعنصر الوسائط الذي يجري تحميله. المزيد...
 
NSString * atvCredentialsType
 نوع بيانات اعتماد Android TV المحددة في GCKMediaLoadRequestData::atvCredentials. المزيد...
 

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

- (GCKMediaInformation*) mediaInformation
readnonatomiccopy

عنصر الوسائط المطلوب تحميله.

- (GCKMediaQueueData*) queueData
readnonatomiccopy

البيانات الوصفية لمادة الوسائط أو قائمة المحتوى التالي

- (NSNumber*) autoplay
readnonatomiccopy

العلامة التي تحدّد ما إذا كان بدء التشغيل فور التحميل

ستكون القيمة التلقائية @(YES).

عند تحميل قائمة انتظار من خلال تحديد عناصر قائمة الانتظار في queueData، تلغي هذه القيمة autoplay من أول GCKMediaQueueItem سيتم تحميلها في queueData. فقط عندما يكون هذا الحقل هو nil، سيتم تفعيل السمة autoplay للفرد GCKMediaQueueItem في queueData.

عند تحميل عنصر واحد من خلال تحديد mediaInformation، يحدّد هذا الحقل ما إذا كان يجب بدء التشغيل عند التحميل. إذا nil، لن يبدأ التشغيل على الفور.

- (NSTimeInterval) startTime
readnonatomicassign

موضع التشغيل الأولي.

القيمة التلقائية هي kGCKInvalidTimeInterval، ما يعني موضع التشغيل التلقائي. في حال تشغيل فيديو عند الطلب، يبدأ من 0. أمّا في حال بث محتوى مباشر، فيبدأ من ميزة البث المباشر.

- (float) playbackRate
readnonatomicassign

معدّل التشغيل

ستكون القيمة التلقائية 1.

- (NSArray<NSNumber *>*) activeTrackIDs
readnonatomicstrong

مصفوفة من الأعداد الصحيحة تحدد المسارات النشطة.

ستكون القيمة التلقائية nil.

- (id) customData
readnonatomicstrong

البيانات المخصصة الخاصة بالتطبيق التي يتم تمريرها مع الطلب.

يجب أن يكون كائنًا يمكن إنشاء تسلسل له بتنسيق JSON باستخدام NSJSONSerialization أو nil.

- (NSString*) credentials
readnonatomiccopy

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

- (NSString*) credentialsType
readnonatomiccopy

نوع بيانات اعتماد المستخدم المحددة في GCKMediaLoadRequestData::credentials.

- (NSString*) atvCredentials
readnonatomiccopy

بيانات اعتماد Android TV البديلة لعنصر الوسائط الذي يجري تحميله.

في حال ضبط بيانات الاعتماد هذه، سيتم إلغاء القيمة التي تم ضبطها في GCKMediaLoadRequestData::credentials إذا كان المستلِم هو تطبيق Android TV. أما على جهاز الاستقبال، فيمكن الوصول إلى بيانات الاعتماد هذه من MediaLoadRequestData#getCredentials.

منذ
4.7.0
- (NSString*) atvCredentialsType
readnonatomiccopy

نوع بيانات اعتماد Android TV المحددة في GCKMediaLoadRequestData::atvCredentials.

في حال ضبط نوع بيانات الاعتماد هذا، سيتم إلغاء القيمة التي تم ضبطها في GCKMediaLoadRequestData::credentialsType إذا كان المستلِم هو تطبيق Android TV. أما على جهاز الاستقبال، فيمكن الوصول إلى بيانات الاعتماد هذه من MediaLoadRequestData#getCredentialsType.

منذ
4.7.0