فئة GCKMediaControlChannel

مرجع فئة GCKMediaControlChannel

نظرة عامة

فئة فرعية GCKCastChannel لعمليات التحكّم في الوسائط

تتطلّب أي عمليات تنطبق على بث نشط حاليًا (مثل التشغيل والإيقاف المؤقت والبحث والإيقاف وما إلى ذلك) حالة وسائط صالحة (أي غير فارغة)، وإلا ستعرض kGCKInvalidRequestID ولن ترسل الطلب. يتم طلب حالة الوسائط تلقائيًا عند ربط القناة، ويتم تضمينها في ردّ اكتمال التحميل بنجاح، ويمكن أيضًا تعديلها في أي وقت. يمكن أن تصبح حالة الوسائط فارغة أيضًا في أي وقت، ويحدث ذلك مثلاً إذا تم قطع اتصال القناة مؤقتًا. عند استخدام هذه القناة، يجب تتبُّع تغييرات حالة الوسائط من خلال معاودة الاتصال mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p)، ويجب عدم استدعاء الطرق التي تعمل على عمليات البث إلا عندما تكون حالة الوسائط غير فارغة.

في حال بدء الطلب بنجاح، تعرض الطريقة المقابلة رقم تعريف الطلب الذي تم تعيينه لهذا الطلب. إذا تعذّر بدء الطلب، ستعرض الطريقة kGCKInvalidRequestID وسيتم ضبط السمة lastError للإشارة إلى سبب التعذّر. إذا تم بدء الطلب بنجاح ولكنّه تعذّر في النهاية، سيتم استدعاء معاودة الاتصال mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) للإشارة إلى تعذُّر التنفيذ.

يمكنك الاطّلاع على GCKMediaControlChannelDelegate لمعرفة بروتوكول التفويض.

Deprecated:
استخدِم السمة GCKRemoteMediaClient الخاصة بالعنصر GCKCastSession للتحكّم في تشغيل الوسائط.

يرث GCKCastChannel.

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

(instancetype) - init
 أداة تهيئة محدّدة المزيد...
 
(NSInteger) - loadMedia:
 تحميل عنصر وسائط جديد وبدء تشغيله المزيد...
 
(NSInteger) - loadMedia:autoplay:
 تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا المزيد...
 
(NSInteger) - loadMedia:autoplay:playPosition:
 تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا المزيد...
 
(NSInteger) - loadMedia:autoplay:playPosition:customData:
 تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا المزيد...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:
 تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا المزيد...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:customData:
 تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا المزيد...
 
(NSInteger) - setActiveTrackIDs:
 تضبط هذه السمة المقاطع الصوتية النشطة. المزيد...
 
(NSInteger) - setTextTrackStyle:
 تضبط هذه السمة نمط مسار النص. المزيد...
 
(NSInteger) - pause
 يوقف تشغيل عنصر الوسائط الحالي مؤقتًا. المزيد...
 
(NSInteger) - pauseWithCustomData:
 يوقف تشغيل عنصر الوسائط الحالي مؤقتًا. المزيد...
 
(NSInteger) - stop
 يوقف تشغيل عنصر الوسائط الحالي. المزيد...
 
(NSInteger) - stopWithCustomData:
 يوقف تشغيل عنصر الوسائط الحالي. المزيد...
 
(NSInteger) - play
 يبدأ (أو يستأنف) تشغيل عنصر الوسائط الحالي. المزيد...
 
(NSInteger) - playWithCustomData:
 يبدأ (أو يستأنف) تشغيل عنصر الوسائط الحالي. المزيد...
 
(NSInteger) - seekToTimeInterval:
 للانتقال إلى موضع جديد ضمن عنصر الوسائط الحالي المزيد...
 
(NSInteger) - seekToTimeInterval:resumeState:
 للانتقال إلى موضع جديد ضمن عنصر الوسائط الحالي المزيد...
 
(NSInteger) - seekToTimeInterval:resumeState:customData:
 للانتقال إلى موضع جديد ضمن عنصر الوسائط الحالي المزيد...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:
 تحميل قائمة جديدة من عناصر الوسائط وبدء تشغيلها اختياريًا المزيد...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:customData:
 تحميل قائمة جديدة من عناصر الوسائط وبدء تشغيلها اختياريًا المزيد...
 
(NSInteger) - queueLoadItems:startIndex:playPosition:repeatMode:customData:
 تحميل قائمة جديدة من عناصر الوسائط وبدء تشغيلها اختياريًا المزيد...
 
(NSInteger) - queueInsertItems:beforeItemWithID:
 تُدرِج هذه الطريقة قائمة بعناصر الوسائط الجديدة في قائمة الانتظار. المزيد...
 
(NSInteger) - queueInsertItems:beforeItemWithID:customData:
 تُدرِج هذه الطريقة قائمة بعناصر الوسائط الجديدة في قائمة الانتظار. المزيد...
 
(NSInteger) - queueInsertItem:beforeItemWithID:
 طريقة ملائمة لإدراج عنصر واحد في قائمة الانتظار المزيد...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:
 طريقة سهلة لإدراج عنصر واحد في قائمة الانتظار وجعله العنصر الحالي المزيد...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
 طريقة سهلة لإدراج عنصر واحد في قائمة الانتظار وجعله العنصر الحالي المزيد...
 
(NSInteger) - queueUpdateItems:
 تعديل قائمة الانتظار المزيد...
 
(NSInteger) - queueUpdateItems:customData:
 تعديل قائمة الانتظار المزيد...
 
(NSInteger) - queueRemoveItemsWithIDs:
 تزيل هذه الطريقة قائمة بعناصر الوسائط من قائمة الانتظار. المزيد...
 
(NSInteger) - queueRemoveItemsWithIDs:customData:
 تزيل هذه الطريقة قائمة بعناصر الوسائط من قائمة الانتظار. المزيد...
 
(NSInteger) - queueRemoveItemWithID:
 طريقة سهلة لإزالة عنصر واحد من قائمة الانتظار. المزيد...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:
 تعيد هذه الطريقة ترتيب قائمة عناصر الوسائط في قائمة الانتظار. المزيد...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
 إعادة ترتيب قائمة عناصر الوسائط في قائمة الانتظار المزيد...
 
(NSInteger) - queueMoveItemWithID:beforeItemWithID:
 طريقة ملائمة لنقل عنصر واحد في قائمة الانتظار المزيد...
 
(NSInteger) - queueJumpToItemWithID:
 ينتقِل إلى العنصر الذي يحمل رقم التعريف المحدّد في قائمة الانتظار. المزيد...
 
(NSInteger) - queueJumpToItemWithID:customData:
 ينتقِل إلى العنصر الذي يحمل رقم التعريف المحدّد في قائمة الانتظار. المزيد...
 
(NSInteger) - queueJumpToItemWithID:playPosition:customData:
 ينتقِل إلى العنصر الذي يحمل رقم التعريف المحدّد في قائمة الانتظار. المزيد...
 
(NSInteger) - queueNextItem
 الانتقال إلى العنصر التالي في قائمة الانتظار المزيد...
 
(NSInteger) - queuePreviousItem
 الانتقال إلى العنصر السابق في قائمة الانتظار المزيد...
 
(NSInteger) - queueSetRepeatMode:
 يضبط هذا الإجراء وضع تكرار قائمة الانتظار. المزيد...
 
(NSInteger) - setStreamVolume:
 تضبط هذه السمة مستوى صوت البث. المزيد...
 
(NSInteger) - setStreamVolume:customData:
 تضبط هذه السمة مستوى صوت البث. المزيد...
 
(NSInteger) - setStreamMuted:
 تضبط هذه السمة ما إذا كان البث مكتومًا. المزيد...
 
(NSInteger) - setStreamMuted:customData:
 تضبط هذه السمة ما إذا كان البث مكتومًا. المزيد...
 
(NSInteger) - requestStatus
 يطلب هذا الإجراء معلومات محدَّثة عن حالة الوسائط من جهاز الاستقبال. المزيد...
 
(NSTimeInterval) - approximateStreamPosition
 تعرض هذه السمة موضع البث التقريبي الذي يتم احتسابه من آخر معلومات تم تلقّيها عن البث والوقت المنقضي منذ آخر تحديث. المزيد...
 
(BOOL) - cancelRequestWithID:
 يلغي هذا الإجراء طلبًا قيد التنفيذ. المزيد...
 
(instancetype) - initWithNamespace:
 أداة تهيئة محدّدة المزيد...
 
(void) - didReceiveTextMessage:
 يتم استدعاء هذه الطريقة عند تلقّي رسالة نصية على هذه القناة. المزيد...
 
(BOOL) - sendTextMessage:
 إرسال رسالة نصية على هذه القناة المزيد...
 
(BOOL) - sendTextMessage:error:
 إرسال رسالة نصية على هذه القناة المزيد...
 
(NSInteger) - generateRequestID
 تنشئ هذه السمة معرّف طلب لرسالة جديدة. المزيد...
 
(NSNumber *__nullable) - generateRequestNumber
 طريقة ملائمة تغلف نتيجة generateRequestID في NSNumber. المزيد...
 
(void) - didConnect
 يتم استدعاء هذه الطريقة عند ربط هذه القناة، ما يشير إلى أنّه يمكن الآن تبادل الرسائل مع جهاز البث عبر هذه القناة. المزيد...
 
(void) - didDisconnect
 يتم استدعاء هذه الطريقة عند قطع اتصال هذه القناة، ما يشير إلى أنّه لم يعُد بالإمكان تبادل الرسائل مع جهاز Cast عبر هذه القناة. المزيد...
 

ملخّص الموقع

GCKMediaStatusmediaStatus
 حالة الوسائط التي تم تحميلها حاليًا، إذا توفّرت، وإلا nil المزيد...
 
NSTimeInterval timeSinceLastMediaStatusUpdate
 مقدار الوقت الذي انقضى منذ تلقّي آخر تحديث لحالة الوسائط المزيد...
 
GCKErrorlastError
 تفاصيل الخطأ من الطلب الأخير، إن وُجدت، أو nil إذا كان الطلب الأخير ناجحًا. المزيد...
 
id< GCKMediaControlChannelDelegatedelegate
 المفوّض لتلقّي إشعارات بشأن التغييرات في حالة القناة. المزيد...
 
NSString * protocolNamespace
 مساحة اسم القناة المزيد...
 
BOOL isConnected
 علامة تشير إلى ما إذا كانت هذه القناة مرتبطة حاليًا. المزيد...
 
GCKDeviceManagerdeviceManager
 تمثّل هذه السمة مدير الأجهزة الذي تم تسجيل هذه القناة فيه، إن وُجد. المزيد...
 

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

- (instancetype) init

أداة تهيئة محدّدة

تنفّذ هذه السمة GCKCastChannel.

- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo

تحميل عنصر وسائط جديد وبدء تشغيله

Parameters
mediaInfoAn object describing the media item to load.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay 

تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition 

تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs 

تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn array of integers specifying the active tracks. May be nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  customData 

تحميل عنصر وسائط جديد وبدء تشغيله اختياريًا

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
activeTrackIDsAn array of integers specifying the active tracks. May be nil.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) setActiveTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs

تضبط هذه السمة المقاطع الصوتية النشطة.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

Parameters
activeTrackIDsAn array of integers specifying the active tracks.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة يمكن أن تكون nil أو مصفوفة فارغة لضبط المقاطع الصوتية النشطة على القائمة الفارغة.
- (NSInteger) setTextTrackStyle: (GCKMediaTextTrackStyle *__nullable)  textTrackStyle

تضبط هذه السمة نمط مسار النص.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

Parameters
textTrackStyleThe text track style. The style will not be changed if this is nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) pause

يوقف تشغيل عنصر الوسائط الحالي مؤقتًا.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) pauseWithCustomData: (id __nullable)  customData

يوقف تشغيل عنصر الوسائط الحالي مؤقتًا.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

Parameters
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) stop

يوقف تشغيل عنصر الوسائط الحالي.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية. إذا كانت قائمة تشغيل محملة حاليًا، ستتم إزالتها.

المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) stopWithCustomData: (id __nullable)  customData

يوقف تشغيل عنصر الوسائط الحالي.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية. إذا كانت قائمة تشغيل محملة حاليًا، ستتم إزالتها.

Parameters
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) play

يبدأ (أو يستأنف) تشغيل عنصر الوسائط الحالي.

يبدأ التشغيل دائمًا من بداية البث. سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) playWithCustomData: (id __nullable)  customData

يبدأ (أو يستأنف) تشغيل عنصر الوسائط الحالي.

يبدأ التشغيل دائمًا من بداية البث. سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

Parameters
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position

للانتقال إلى موضع جديد ضمن عنصر الوسائط الحالي

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

Parameters
positionThe new position from the beginning of the stream.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState 

للانتقال إلى موضع جديد ضمن عنصر الوسائط الحالي

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

Parameters
positionThe new position interval from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState
customData: (id __nullable)  customData 

للانتقال إلى موضع جديد ضمن عنصر الوسائط الحالي

سيتعذّر تنفيذ الطلب إذا لم تكن هناك حالة وسائط حالية.

Parameters
positionThe new position from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode 

تحميل قائمة جديدة من عناصر الوسائط وبدء تشغيلها اختياريًا

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe repeat mode for playing the queue.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData 

تحميل قائمة جديدة من عناصر الوسائط وبدء تشغيلها اختياريًا

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
repeatModeThe repeat mode for playing the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
playPosition: (NSTimeInterval)  playPosition
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData 

تحميل قائمة جديدة من عناصر الوسائط وبدء تشغيلها اختياريًا

Parameters
queueItemsAn array of GCKMediaQueueItem instances to load. Must not be nil or empty.
startIndexThe index of the item in the items array that should be played first.
playPositionThe initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
repeatModeThe repeat mode for playing the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueInsertItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
beforeItemWithID: (NSUInteger)  beforeItemID 

تُدرِج هذه الطريقة قائمة بعناصر الوسائط الجديدة في قائمة الانتظار.

Parameters
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDThe ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueInsertItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
beforeItemWithID: (NSUInteger)  beforeItemID
customData: (id __nullable)  customData 

تُدرِج هذه الطريقة قائمة بعناصر الوسائط الجديدة في قائمة الانتظار.

Parameters
queueItemsAn array of GCKMediaQueueItem instances to insert. Must not be nil or empty.
beforeItemIDID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueInsertItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

طريقة ملائمة لإدراج عنصر واحد في قائمة الانتظار

Parameters
itemThe item to insert.
beforeItemIDThe ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

طريقة سهلة لإدراج عنصر واحد في قائمة الانتظار وجعله العنصر الحالي

Parameters
itemThe item to insert.
beforeItemIDThe ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

طريقة سهلة لإدراج عنصر واحد في قائمة الانتظار وجعله العنصر الحالي

Parameters
itemThe item to insert.
beforeItemIDThe ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
playPositionThe initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems

تعديل قائمة الانتظار

Parameters
queueItemsThe list of updated items.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
customData: (id __nullable)  customData 

تعديل قائمة الانتظار

Parameters
queueItemsThe list of updated items.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs

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

وإذا أصبحت قائمة الانتظار فارغة نتيجةً لذلك، سيتم إنهاء جلسة الوسائط الحالية.

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs
customData: (id __nullable)  customData 

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

وإذا أصبحت قائمة الانتظار فارغة نتيجةً لذلك، سيتم إنهاء جلسة الوسائط الحالية.

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueRemoveItemWithID: (NSUInteger)  itemID

طريقة سهلة لإزالة عنصر واحد من قائمة الانتظار.

Parameters
itemIDThe ID of the item to remove.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID 

تعيد هذه الطريقة ترتيب قائمة عناصر الوسائط في قائمة الانتظار.

Parameters
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be appended at the end of the queue.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueReorderItemsWithIDs: (NSArray< NSNumber * > *)  queueItemIDs
insertBeforeItemWithID: (NSUInteger)  beforeItemID
customData: (id __nullable)  customData 

إعادة ترتيب قائمة عناصر الوسائط في قائمة الانتظار

Parameters
queueItemIDsAn array of media item IDs identifying the items to reorder. Must not be nil or empty.
beforeItemIDThe ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be moved to the end of the queue.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueMoveItemWithID: (NSUInteger)  itemID
beforeItemWithID: (NSUInteger)  beforeItemID 

طريقة ملائمة لنقل عنصر واحد في قائمة الانتظار

Parameters
itemIDThe ID of the item to move.
beforeItemIDThe ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the item will be moved to the end of the queue.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID

ينتقِل إلى العنصر الذي يحمل رقم التعريف المحدّد في قائمة الانتظار.

Parameters
itemIDThe ID of the item to jump to.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
customData: (id __nullable)  customData 

ينتقِل إلى العنصر الذي يحمل رقم التعريف المحدّد في قائمة الانتظار.

Parameters
itemIDThe ID of the item to jump to.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

ينتقِل إلى العنصر الذي يحمل رقم التعريف المحدّد في قائمة الانتظار.

Parameters
itemIDThe ID of the item to jump to.
playPositionThe initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) queueNextItem

الانتقال إلى العنصر التالي في قائمة الانتظار

المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) queuePreviousItem

الانتقال إلى العنصر السابق في قائمة الانتظار

المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode repeatMode

يضبط هذا الإجراء وضع تكرار قائمة الانتظار.

Parameters
repeatModeThe new repeat mode.
المرتجعات
معرّف الطلب هذا، أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة أو إذا كانت أيّ من المَعلمات غير صالحة
- (NSInteger) setStreamVolume: (float)  volume

تضبط هذه السمة مستوى صوت البث.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك جلسة وسائط حالية.

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) setStreamVolume: (float)  volume
customData: (id __nullable)  customData 

تضبط هذه السمة مستوى صوت البث.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك جلسة وسائط حالية.

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) setStreamMuted: (BOOL)  muted

تضبط هذه السمة ما إذا كان البث مكتومًا.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك جلسة وسائط حالية.

Parameters
mutedWhether the stream should be muted or unmuted.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) setStreamMuted: (BOOL)  muted
customData: (id __nullable)  customData 

تضبط هذه السمة ما إذا كان البث مكتومًا.

سيتعذّر تنفيذ الطلب إذا لم تكن هناك جلسة وسائط حالية.

Parameters
mutedWhether the stream should be muted or unmuted.
customDataCustom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.
المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSInteger) requestStatus

يطلب هذا الإجراء معلومات محدَّثة عن حالة الوسائط من جهاز الاستقبال.

المرتجعات
رقم تعريف الطلب أو kGCKInvalidRequestID إذا تعذّر إرسال الرسالة
- (NSTimeInterval) approximateStreamPosition

تعرض هذه السمة موضع البث التقريبي الذي يتم احتسابه من آخر معلومات تم تلقّيها عن البث والوقت المنقضي منذ آخر تحديث.

تعرِض القيمة 0 إذا لم تكن القناة مرتبطة أو إذا لم يتم تحميل أي وسائط حاليًا.

- (BOOL) cancelRequestWithID: (NSInteger)  requestID

يلغي هذا الإجراء طلبًا قيد التنفيذ.

لا يؤدي إلغاء الطلب إلى منع تنفيذه، بل يشير ببساطة إلى أنّ التطبيق الذي أرسل الطلب لم يعُد مهتمًا بنتائجه، وبالتالي سيتم محو أي حالة مرتبطة بتتبُّع الطلب.

Parameters
requestIDThe ID of the request to cancel.
المرتجعات
YES إذا تم إلغاء الطلب، أو NO إذا لم يتم تتبُّع أي طلب باستخدام المعرّف المحدّد.
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

أداة تهيئة محدّدة

تنشئ هذه الدالة GCKCastChannel جديدًا باستخدام مساحة الاسم المحدّدة.

Parameters
protocolNamespaceThe namespace.

تمّ تنفيذها في GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *)  message

يتم استدعاء هذه الطريقة عند تلقّي رسالة نصية على هذه القناة.

التنفيذ التلقائي هو عملية غير نشطة.

Parameters
messageThe message.
- (BOOL) sendTextMessage: (NSString *)  message

إرسال رسالة نصية على هذه القناة

Parameters
messageThe message.
المرتجعات
YES عند النجاح أو NO إذا تعذّر إرسال الرسالة (لأنّ القناة غير مرتبطة أو لأنّ مخزن الإرسال المؤقت ممتلئ جدًا في الوقت الحالي).
Deprecated:
استخدِم sendTextMessage:error: الذي يقدّم معلومات مفصّلة عن الأخطاء.
- (BOOL) sendTextMessage: (NSString *)  message
error: (GCKError *__nullable *__nullable)  error 

إرسال رسالة نصية على هذه القناة

Parameters
messageThe message.
errorA pointer at which to store the error result. May be nil.
المرتجعات
YES عند النجاح أو NO إذا تعذّر إرسال الرسالة.
- (NSInteger) generateRequestID

تنشئ هذه السمة معرّف طلب لرسالة جديدة.

المرتجعات
المعرّف الذي تم إنشاؤه، أو kGCKInvalidRequestID إذا لم تكن القناة مرتبطة حاليًا
- (NSNumber * __nullable) generateRequestNumber

طريقة ملائمة تغلف نتيجة generateRequestID في NSNumber.

المرتجعات
المعرّف الذي تم إنشاؤه، أو nil إذا لم تكن القناة مرتبطة حاليًا
- (void) didConnect

يتم استدعاء هذه الطريقة عند ربط هذه القناة، ما يشير إلى أنّه يمكن الآن تبادل الرسائل مع جهاز البث عبر هذه القناة.

التنفيذ التلقائي هو عملية غير نشطة.

- (void) didDisconnect

يتم استدعاء هذه الطريقة عند قطع اتصال هذه القناة، ما يشير إلى أنّه لم يعُد بالإمكان تبادل الرسائل مع جهاز Cast عبر هذه القناة.

التنفيذ التلقائي هو عملية غير نشطة.

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

- (GCKMediaStatus*) mediaStatus
readnonatomicstrong

حالة الوسائط التي تم تحميلها حاليًا، إذا توفّرت، وإلا nil

- (NSTimeInterval) timeSinceLastMediaStatusUpdate
readnonatomicassign

مقدار الوقت الذي انقضى منذ تلقّي آخر تحديث لحالة الوسائط

إذا كان طلب الحالة قيد التقدّم حاليًا، ستكون القيمة 0.

- (GCKError*) lastError
readnonatomiccopy

تفاصيل الخطأ من الطلب الأخير، إن وُجدت، أو nil إذا كان الطلب الأخير ناجحًا.

- (id<GCKMediaControlChannelDelegate>) delegate
readwritenonatomicweak

المفوّض لتلقّي إشعارات بشأن التغييرات في حالة القناة.

- (NSString*) protocolNamespace
readnonatomiccopyinherited

مساحة اسم القناة

- (BOOL) isConnected
readnonatomicassigninherited

علامة تشير إلى ما إذا كانت هذه القناة مرتبطة حاليًا.

- (GCKDeviceManager*) deviceManager
readnonatomicweakinherited

تمثّل هذه السمة مدير الأجهزة الذي تم تسجيل هذه القناة فيه، إن وُجد.

Deprecated:
إذا لم يتم تسجيل هذه القناة باستخدام الفئة GCKDeviceManager المتوقّفة نهائيًا، ستكون القيمة nil.