نظرة عامة

فئة فرعية لـ 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
	يتم الاتصال عندما يتم إلغاء ربط هذه القناة، مما يشير إلى أنه لم يعد بالإمكان تبادل الرسائل مع جهاز البث عبر هذه القناة. المزيد...

ملخص الموقع
GCKMediaStatus *	mediaStatus
	حالة الوسائط للوسائط المحمّلة حاليًا، إن وجدت، وبخلاف ذلك، `nil`. المزيد...

NSTimeInterval	timeSinceLastMediaStatusUpdate
	مقدار الوقت المنقضي منذ تلقي آخر تحديث لحالة الوسائط. المزيد...

GCKError *	lastError
	تفاصيل الخطأ من آخر طلب، إن وُجد، أو `nil` في حال نجاح الطلب الأخير. المزيد...

id< GCKMediaControlChannelDelegate >	delegate
	المفوّض لتلقّي إشعارات حول التغييرات التي تطرأ على حالة القناة المزيد...

NSString *	protocolNamespace
	مساحة اسم القناة. المزيد...

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

GCKDeviceManager *	deviceManager
	مدير الجهاز الذي تم تسجيل هذه القناة به، إن وُجد. المزيد...

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

- (instancetype) init

مُعَيِّن مُحدَّد.

لتنفيذ GCKCastChannel.

- (NSInteger) loadMedia: (GCKMediaInformation *) mediaInfo

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

Parameters

mediaInfo An object describing the media item to load.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay

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

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition

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

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

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

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
customData	Custom 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

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
activeTrackIDs	An 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

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
activeTrackIDs	An array of integers specifying the active tracks. May be `nil`.
customData	Custom 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

activeTrackIDs An array of integers specifying the active tracks.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة. يمكن أن تكون nil أو مصفوفة فارغة لضبط المقاطع الصوتية النشطة على قائمة فارغة.

- (NSInteger) setTextTrackStyle: (GCKMediaTextTrackStyle *__nullable) textTrackStyle

لتعيين نمط مسار النص.

سيخفق الطلب في حالة عدم وجود حالة وسائط حالية.

Parameters

textTrackStyle The text track style. The style will not be changed if this is nil.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) pause

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

سيخفق الطلب في حالة عدم وجود حالة وسائط حالية.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) pauseWithCustomData: (id __nullable) customData

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

سيخفق الطلب في حالة عدم وجود حالة وسائط حالية.

Parameters

customData Custom 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

customData Custom 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

customData Custom 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

position The new position from the beginning of the stream.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) seekToTimeInterval:	(NSTimeInterval)	position
resumeState:	(GCKMediaControlChannelResumeState)	resumeState

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

سيخفق الطلب في حالة عدم وجود حالة وسائط حالية.

Parameters

position	The new position interval from the beginning of the stream.
resumeState	The action to take after the seek operation has finished.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) seekToTimeInterval:	(NSTimeInterval)	position
resumeState:	(GCKMediaControlChannelResumeState)	resumeState
customData:	(id __nullable)	customData

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

سيخفق الطلب في حالة عدم وجود حالة وسائط حالية.

Parameters

position	The new position from the beginning of the stream.
resumeState	The action to take after the seek operation has finished.
customData	Custom 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

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
repeatMode	The repeat mode for playing the queue.

المرتجعات: رقم تعريف الطلب لهذا الطلب، أو kGCKInvalidRequestID إذا تعذر إرسال الرسالة أو إذا كانت أي معلمة من المعلمات غير صالحة.

- (NSInteger) queueLoadItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
startIndex:	(NSUInteger)	startIndex
repeatMode:	(GCKMediaRepeatMode)	repeatMode
customData:	(id __nullable)	customData

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

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
repeatMode	The repeat mode for playing the queue.
customData	Custom 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

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
playPosition	The 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.
repeatMode	The repeat mode for playing the queue.
customData	Custom 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

queueItems	An array of GCKMediaQueueItem instances to insert. Must not be `nil` or empty.
beforeItemID	The 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

queueItems	An array of GCKMediaQueueItem instances to insert. Must not be `nil` or empty.
beforeItemID	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.
customData	Custom 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

item	The item to insert.
beforeItemID	The 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

item	The item to insert.
beforeItemID	The 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

item	The item to insert.
beforeItemID	The 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.
playPosition	The 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.
customData	Custom 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

queueItems The list of updated items.

المرتجعات: رقم تعريف الطلب لهذا الطلب، أو kGCKInvalidRequestID إذا تعذر إرسال الرسالة أو إذا كانت أي معلمة من المعلمات غير صالحة.

- (NSInteger) queueUpdateItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
customData:	(id __nullable)	customData

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

Parameters

queueItems	The list of updated items.
customData	Custom 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

itemIDs An 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

itemIDs	An array of media item IDs identifying the items to remove. Must not be `nil` or empty.
customData	Custom 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

itemID The ID of the item to remove.

المرتجعات: رقم تعريف الطلب لهذا الطلب، أو kGCKInvalidRequestID إذا تعذر إرسال الرسالة أو إذا كانت أي معلمة من المعلمات غير صالحة.

- (NSInteger) queueReorderItemsWithIDs:	(NSArray< NSNumber * > *)	queueItemIDs
insertBeforeItemWithID:	(NSUInteger)	beforeItemID

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

Parameters

queueItemIDs	An array of media item IDs identifying the items to reorder. Must not be `nil` or empty.
beforeItemID	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 appended at the end of the queue.

المرتجعات: رقم تعريف الطلب لهذا الطلب، أو kGCKInvalidRequestID إذا تعذر إرسال الرسالة أو إذا كانت أي معلمة من المعلمات غير صالحة.

- (NSInteger) queueReorderItemsWithIDs:	(NSArray< NSNumber * > *)	queueItemIDs
insertBeforeItemWithID:	(NSUInteger)	beforeItemID
customData:	(id __nullable)	customData

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

Parameters

queueItemIDs	An array of media item IDs identifying the items to reorder. Must not be `nil` or empty.
beforeItemID	The 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.
customData	Custom 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

itemID	The ID of the item to move.
beforeItemID	The 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

itemID The ID of the item to jump to.

المرتجعات: معرف الطلب لهذا الطلب، أو kGCKInvalidRequestID إذا تعذر إرسال الرسالة.

- (NSInteger) queueJumpToItemWithID:	(NSUInteger)	itemID
customData:	(id __nullable)	customData

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

Parameters

itemID	The ID of the item to jump to.
customData	Custom 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

itemID	The ID of the item to jump to.
playPosition	The 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.
customData	Custom 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

repeatMode The new repeat mode.

المرتجعات: رقم تعريف الطلب لهذا الطلب، أو kGCKInvalidRequestID إذا تعذر إرسال الرسالة أو إذا كانت أي معلمة من المعلمات غير صالحة.

- (NSInteger) setStreamVolume: (float) volume

لتعيين مستوى صوت البث.

سيخفق الطلب في حال عدم وجود جلسة وسائط حالية.

Parameters

volume The new volume, in the range [0.0 - 1.0].

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) setStreamVolume:	(float)	volume
customData:	(id __nullable)	customData

لتعيين مستوى صوت البث.

سيخفق الطلب في حال عدم وجود جلسة وسائط حالية.

Parameters

volume	The new volume, in the range [0.0 - 1.0].
customData	Custom 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

muted Whether the stream should be muted or unmuted.

المرتجعات: رقم تعريف الطلب، أو kGCKInvalidRequestID في حالة تعذر إرسال الرسالة.

- (NSInteger) setStreamMuted:	(BOOL)	muted
customData:	(id __nullable)	customData

لتعيين ما إذا كان سيتم كتم صوت مجموعة البث أم لا.

سيخفق الطلب في حال عدم وجود جلسة وسائط حالية.

Parameters

muted	Whether the stream should be muted or unmuted.
customData	Custom 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

requestID The ID of the request to cancel.

المرتجعات: YES إذا تم إلغاء الطلب، أو NO في حال عدم تتبُّع أي طلب باستخدام رقم التعريف المحدّد.

- (instancetype) initWithNamespace: (NSString *) protocolNamespace

مُعَيِّن مُحدَّد.

لإنشاء GCKCastChannel جديدة باستخدام مساحة الاسم المحدّدة.

Parameters

protocolNamespace The namespace.

تم التنفيذ في GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *) message

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

التنفيذ الافتراضي هو بيئة مستقلة.

Parameters

message The message.

- (BOOL) sendTextMessage: (NSString *) message

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

Parameters

message The message.

المرتجعات: YES يتم إرسالها بنجاح أو NO إذا تعذر إرسال الرسالة (نظرًا لعدم اتصال القناة، أو لأن المخزن المؤقت للإرسال ممتلئ للغاية في الوقت الحالي).

Deprecated:: استخدِم sendTextMessage:error: الذي يقدّم معلومات تفصيلية عن الأخطاء.

- (BOOL) sendTextMessage:	(NSString *)	message
error:	(GCKError __nullable __nullable)	error

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

Parameters

message	The message.
error	A 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

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

التنفيذ الافتراضي هو بيئة مستقلة.

تفاصيل العقار

- (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.

فئة GCKMediaControlChannel

نظرة عامة

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

ملخص الموقع

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

تفاصيل العقار