Tổng quan

Một lớp con GCKCastChannel cho các thao tác điều khiển nội dung nghe nhìn.

Mọi thao tác áp dụng cho một luồng đang hoạt động (phát, tạm dừng, tua, dừng, v.v.) đều yêu cầu trạng thái nội dung nghe nhìn hợp lệ (tức là không có giá trị rỗng), nếu không, các thao tác này sẽ trả về kGCKInvalidRequestID và sẽ không gửi yêu cầu. Trạng thái nội dung nghe nhìn sẽ được yêu cầu tự động khi kênh kết nối, được đưa vào phản hồi hoàn tất tải thành công và cũng có thể được cập nhật bất cứ lúc nào. Trạng thái nội dung nghe nhìn cũng có thể trở thành giá trị rỗng bất cứ lúc nào; điều này sẽ xảy ra nếu kênh tạm thời bị ngắt kết nối, chẳng hạn như vậy. Khi sử dụng kênh này, bạn nên theo dõi các thay đổi về trạng thái nội dung nghe nhìn thông qua lệnh gọi lại mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p) và chỉ gọi các phương thức hoạt động trên luồng khi trạng thái nội dung nghe nhìn không phải là giá trị rỗng.

Nếu một yêu cầu được bắt đầu thành công, phương thức tương ứng sẽ trả về mã yêu cầu được chỉ định cho yêu cầu đó. Nếu yêu cầu không bắt đầu được, phương thức này sẽ trả về kGCKInvalidRequestID và đặt thuộc tính lastError để cho biết lý do khiến yêu cầu không bắt đầu được. Nếu một yêu cầu được bắt đầu thành công nhưng cuối cùng không thành công, thì lệnh gọi lại mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) sẽ được gọi để cho biết lỗi.

Hãy xem GCKMediaControlChannelDelegate để biết giao thức uỷ quyền.

Deprecated:: Sử dụng thuộc tính GCKRemoteMediaClient của GCKCastSession để điều khiển chế độ phát nội dung nghe nhìn.

Kế thừa GCKCastChannel.

Tóm tắt phương thức của thực thể
(instancetype)	- init
	Trình khởi tạo được chỉ định. Tuỳ chọn khác...

(NSInteger)	- loadMedia:
	Tải và bắt đầu phát một mục nội dung nghe nhìn mới. Tuỳ chọn khác...

(NSInteger)	- loadMedia:autoplay:
	Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới. Tuỳ chọn khác...

(NSInteger)	- loadMedia:autoplay:playPosition:
	Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới. Tuỳ chọn khác...

(NSInteger)	- loadMedia:autoplay:playPosition:customData:
	Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới. Tuỳ chọn khác...

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:
	Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới. Tuỳ chọn khác...

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:customData:
	Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới. Tuỳ chọn khác...

(NSInteger)	- setActiveTrackIDs:
	Đặt các bản phát hành đang hoạt động. Tuỳ chọn khác...

(NSInteger)	- setTextTrackStyle:
	Đặt kiểu phụ đề. Tuỳ chọn khác...

(NSInteger)	- pause
	Tạm dừng phát mục nội dung đa phương tiện hiện tại. Tuỳ chọn khác...

(NSInteger)	- pauseWithCustomData:
	Tạm dừng phát mục nội dung đa phương tiện hiện tại. Tuỳ chọn khác...

(NSInteger)	- stop
	Dừng phát mục nội dung đa phương tiện hiện tại. Tuỳ chọn khác...

(NSInteger)	- stopWithCustomData:
	Dừng phát mục nội dung đa phương tiện hiện tại. Tuỳ chọn khác...

(NSInteger)	- play
	Bắt đầu (hoặc tiếp tục) phát mục nội dung nghe nhìn hiện tại. Tuỳ chọn khác...

(NSInteger)	- playWithCustomData:
	Bắt đầu (hoặc tiếp tục) phát mục nội dung nghe nhìn hiện tại. Tuỳ chọn khác...

(NSInteger)	- seekToTimeInterval:
	Chuyển đến một vị trí mới trong mục nội dung đa phương tiện hiện tại. Tuỳ chọn khác...

(NSInteger)	- seekToTimeInterval:resumeState:
	Chuyển đến một vị trí mới trong mục nội dung đa phương tiện hiện tại. Tuỳ chọn khác...

(NSInteger)	- seekToTimeInterval:resumeState:customData:
	Chuyển đến một vị trí mới trong mục nội dung đa phương tiện hiện tại. Tuỳ chọn khác...

(NSInteger)	- queueLoadItems:startIndex:repeatMode:
	Tải và tuỳ ý bắt đầu phát một hàng đợi mới gồm các mục nội dung nghe nhìn. Tuỳ chọn khác...

(NSInteger)	- queueLoadItems:startIndex:repeatMode:customData:
	Tải và tuỳ ý bắt đầu phát một hàng đợi mới gồm các mục nội dung nghe nhìn. Tuỳ chọn khác...

(NSInteger)	- queueLoadItems:startIndex:playPosition:repeatMode:customData:
	Tải và tuỳ ý bắt đầu phát một hàng đợi mới gồm các mục nội dung nghe nhìn. Tuỳ chọn khác...

(NSInteger)	- queueInsertItems:beforeItemWithID:
	Chèn danh sách các mục nội dung nghe nhìn mới vào hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueInsertItems:beforeItemWithID:customData:
	Chèn danh sách các mục nội dung nghe nhìn mới vào hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueInsertItem:beforeItemWithID:
	Một phương thức thuận tiện để chèn một mục duy nhất vào hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:
	Một phương thức tiện lợi để chèn một mục vào danh sách phát và đặt mục đó làm mục hiện tại. Tuỳ chọn khác...

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
	Một phương thức tiện lợi để chèn một mục vào danh sách phát và đặt mục đó làm mục hiện tại. Tuỳ chọn khác...

(NSInteger)	- queueUpdateItems:
	Cập nhật hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueUpdateItems:customData:
	Cập nhật hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueRemoveItemsWithIDs:
	Xoá một danh sách các mục nội dung nghe nhìn khỏi hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueRemoveItemsWithIDs:customData:
	Xoá một danh sách các mục nội dung nghe nhìn khỏi hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueRemoveItemWithID:
	Một phương thức tiện lợi giúp xoá một mục khỏi hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:
	Sắp xếp lại danh sách các mục nội dung nghe nhìn trong hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
	Sắp xếp lại danh sách các mục nội dung nghe nhìn trong hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueMoveItemWithID:beforeItemWithID:
	Một phương thức thuận tiện để di chuyển một mục trong hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueJumpToItemWithID:
	Chuyển đến mục có mã nhận dạng được chỉ định trong danh sách chờ. Tuỳ chọn khác...

(NSInteger)	- queueJumpToItemWithID:customData:
	Chuyển đến mục có mã nhận dạng được chỉ định trong danh sách chờ. Tuỳ chọn khác...

(NSInteger)	- queueJumpToItemWithID:playPosition:customData:
	Chuyển đến mục có mã nhận dạng được chỉ định trong danh sách chờ. Tuỳ chọn khác...

(NSInteger)	- queueNextItem
	Chuyển đến mục tiếp theo trong hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queuePreviousItem
	Chuyển đến mục trước trong hàng đợi. Tuỳ chọn khác...

(NSInteger)	- queueSetRepeatMode:
	Đặt chế độ lặp lại cho hàng đợi. Tuỳ chọn khác...

(NSInteger)	- setStreamVolume:
	Đặt âm lượng luồng phát. Tuỳ chọn khác...

(NSInteger)	- setStreamVolume:customData:
	Đặt âm lượng luồng phát. Tuỳ chọn khác...

(NSInteger)	- setStreamMuted:
	Đặt xem luồng có bị tắt tiếng hay không. Tuỳ chọn khác...

(NSInteger)	- setStreamMuted:customData:
	Đặt xem luồng có bị tắt tiếng hay không. Tuỳ chọn khác...

(NSInteger)	- requestStatus
	Yêu cầu thông tin cập nhật về trạng thái nội dung nghe nhìn từ thiết bị nhận. Tuỳ chọn khác...

(NSTimeInterval)	- approximateStreamPosition
	Trả về vị trí phát trực tiếp ước chừng được tính từ thông tin phát trực tiếp gần đây nhất nhận được và thời gian thực đã trôi qua kể từ lần cập nhật đó. Tuỳ chọn khác...

(BOOL)	- cancelRequestWithID:
	Huỷ một yêu cầu đang diễn ra. Tuỳ chọn khác...

(instancetype)	- initWithNamespace:
	Trình khởi tạo được chỉ định. Tuỳ chọn khác...

(void)	- didReceiveTextMessage:
	Được gọi khi một tin nhắn văn bản được nhận trên kênh này. Tuỳ chọn khác...

(BOOL)	- sendTextMessage:
	Gửi tin nhắn văn bản trên kênh này. Tuỳ chọn khác...

(BOOL)	- sendTextMessage:error:
	Gửi tin nhắn văn bản trên kênh này. Tuỳ chọn khác...

(NSInteger)	- generateRequestID
	Tạo mã yêu cầu cho một thông báo mới. Tuỳ chọn khác...

(NSNumber *__nullable)	- generateRequestNumber
	Một phương thức thuận tiện bao bọc kết quả của generateRequestID trong một NSNumber. Tuỳ chọn khác...

(void)	- didConnect
	Được gọi khi kênh này đã kết nối, cho biết rằng giờ đây, các thông báo có thể được trao đổi với thiết bị truyền qua kênh này. Tuỳ chọn khác...

(void)	- didDisconnect
	Được gọi khi kênh này bị ngắt kết nối, cho biết rằng không thể trao đổi thông báo với thiết bị truyền qua kênh này nữa. Tuỳ chọn khác...

Tóm tắt về tài sản
GCKMediaStatus *	mediaStatus
	Trạng thái nội dung nghe nhìn của nội dung nghe nhìn hiện đang được tải (nếu có); nếu không thì là `nil`. Tuỳ chọn khác...

NSTimeInterval	timeSinceLastMediaStatusUpdate
	Khoảng thời gian đã trôi qua kể từ lần gần đây nhất nhận được bản cập nhật trạng thái nội dung nghe nhìn. Tuỳ chọn khác...

GCKError *	lastError
	Thông tin chi tiết về lỗi của yêu cầu gần đây nhất (nếu có) hoặc `nil` nếu yêu cầu gần đây nhất thành công. Tuỳ chọn khác...

id< GCKMediaControlChannelDelegate >	delegate
	Uỷ quyền nhận thông báo về các thay đổi trong trạng thái của kênh. Tuỳ chọn khác...

NSString *	protocolNamespace
	Không gian tên của kênh. Tuỳ chọn khác...

BOOL	isConnected
	Một cờ cho biết liệu kênh này có đang kết nối hay không. Tuỳ chọn khác...

GCKDeviceManager *	deviceManager
	Trình quản lý thiết bị mà kênh này đã đăng ký, nếu có. Tuỳ chọn khác...

Thông tin chi tiết về phương thức

- (instancetype) init

Trình khởi tạo được chỉ định.

Triển khai GCKCastChannel.

- (NSInteger) loadMedia: (GCKMediaInformation *) mediaInfo

Tải và bắt đầu phát một mục nội dung nghe nhìn mới.

Parameters

mediaInfo An object describing the media item to load.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới.

Parameters

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới.

Parameters

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới.

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
activeTrackIDs:	(NSArray< NSNumber * > *__nullable)	activeTrackIDs

Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới.

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
activeTrackIDs:	(NSArray< NSNumber * > *__nullable)	activeTrackIDs
customData:	(id __nullable)	customData

Tải và tuỳ ý bắt đầu phát một mục nội dung nghe nhìn mới.

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) setActiveTrackIDs: (NSArray< NSNumber * > *__nullable) activeTrackIDs

Đặt các bản phát hành đang hoạt động.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

Parameters

activeTrackIDs An array of integers specifying the active tracks.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo. Có thể là nil hoặc một mảng trống để đặt các phụ đề đang hoạt động thành danh sách trống.

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

Đặt kiểu phụ đề.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

Parameters

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) pause

Tạm dừng phát mục nội dung đa phương tiện hiện tại.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) pauseWithCustomData: (id __nullable) customData

Tạm dừng phát mục nội dung đa phương tiện hiện tại.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

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.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) stop

Dừng phát mục nội dung đa phương tiện hiện tại.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại. Nếu một hàng đợi đang được tải, hàng đợi đó sẽ bị xoá.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) stopWithCustomData: (id __nullable) customData

Dừng phát mục nội dung đa phương tiện hiện tại.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại. Nếu một hàng đợi đang được tải, hàng đợi đó sẽ bị xoá.

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.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) play

Bắt đầu (hoặc tiếp tục) phát mục nội dung nghe nhìn hiện tại.

Quá trình phát luôn bắt đầu từ đầu luồng. Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) playWithCustomData: (id __nullable) customData

Bắt đầu (hoặc tiếp tục) phát mục nội dung nghe nhìn hiện tại.

Quá trình phát luôn bắt đầu từ đầu luồng. Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

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.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) seekToTimeInterval: (NSTimeInterval) position

Chuyển đến một vị trí mới trong mục nội dung đa phương tiện hiện tại.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

Parameters

position The new position from the beginning of the stream.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Chuyển đến một vị trí mới trong mục nội dung đa phương tiện hiện tại.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

Parameters

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Chuyển đến một vị trí mới trong mục nội dung đa phương tiện hiện tại.

Yêu cầu sẽ không thực hiện được nếu không có trạng thái nội dung nghe nhìn hiện tại.

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Tải và tuỳ ý bắt đầu phát một hàng đợi mới gồm các mục nội dung nghe nhìn.

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.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

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

Tải và tuỳ ý bắt đầu phát một hàng đợi mới gồm các mục nội dung nghe nhìn.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

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

Tải và tuỳ ý bắt đầu phát một hàng đợi mới gồm các mục nội dung nghe nhìn.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueInsertItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
beforeItemWithID:	(NSUInteger)	beforeItemID

Chèn danh sách các mục nội dung nghe nhìn mới vào hàng đợi.

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.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueInsertItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
beforeItemWithID:	(NSUInteger)	beforeItemID
customData:	(id __nullable)	customData

Chèn danh sách các mục nội dung nghe nhìn mới vào hàng đợi.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueInsertItem:	(GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID

Một phương thức thuận tiện để chèn một mục duy nhất vào hàng đợi.

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.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueInsertAndPlayItem:	(GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID

Một phương thức tiện lợi để chèn một mục vào danh sách phát và đặt mục đó làm mục hiện tại.

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.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueInsertAndPlayItem:	(GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

Một phương thức tiện lợi để chèn một mục vào danh sách phát và đặt mục đó làm mục hiện tại.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

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

Cập nhật hàng đợi.

Parameters

queueItems The list of updated items.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

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

Cập nhật hàng đợi.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *) itemIDs

Xoá một danh sách các mục nội dung nghe nhìn khỏi hàng đợi.

Nếu hàng đợi trở nên trống, phiên phát nội dung nghe nhìn hiện tại sẽ kết thúc.

Parameters

itemIDs An array of media item IDs identifying the items to remove. Must not be nil or empty.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueRemoveItemsWithIDs:	(NSArray< NSNumber * > *)	itemIDs
customData:	(id __nullable)	customData

Xoá một danh sách các mục nội dung nghe nhìn khỏi hàng đợi.

Nếu hàng đợi trở nên trống, phiên phát nội dung nghe nhìn hiện tại sẽ kết thúc.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueRemoveItemWithID: (NSUInteger) itemID

Một phương thức tiện lợi giúp xoá một mục khỏi hàng đợi.

Parameters

itemID The ID of the item to remove.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

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

Sắp xếp lại danh sách các mục nội dung nghe nhìn trong hàng đợi.

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.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

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

Sắp xếp lại danh sách các mục nội dung nghe nhìn trong hàng đợi.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueMoveItemWithID:	(NSUInteger)	itemID
beforeItemWithID:	(NSUInteger)	beforeItemID

Một phương thức thuận tiện để di chuyển một mục trong hàng đợi.

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.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) queueJumpToItemWithID: (NSUInteger) itemID

Chuyển đến mục có mã nhận dạng được chỉ định trong danh sách chờ.

Parameters

itemID The ID of the item to jump to.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Chuyển đến mục có mã nhận dạng được chỉ định trong danh sách chờ.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Chuyển đến mục có mã nhận dạng được chỉ định trong danh sách chờ.

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

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) queueNextItem

Chuyển đến mục tiếp theo trong hàng đợi.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) queuePreviousItem

Chuyển đến mục trước trong hàng đợi.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode) repeatMode

Đặt chế độ lặp lại cho hàng đợi.

Parameters

repeatMode The new repeat mode.

Giá trị trả về: Mã yêu cầu cho yêu cầu này hoặc kGCKInvalidRequestID nếu không gửi được thông báo hoặc nếu có tham số không hợp lệ.

- (NSInteger) setStreamVolume: (float) volume

Đặt âm lượng luồng phát.

Yêu cầu sẽ không thành công nếu không có phiên phát nội dung nghe nhìn nào đang diễn ra.

Parameters

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Đặt âm lượng luồng phát.

Yêu cầu sẽ không thành công nếu không có phiên phát nội dung nghe nhìn nào đang diễn ra.

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) setStreamMuted: (BOOL) muted

Đặt xem luồng có bị tắt tiếng hay không.

Yêu cầu sẽ không thành công nếu không có phiên phát nội dung nghe nhìn nào đang diễn ra.

Parameters

muted Whether the stream should be muted or unmuted.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

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

Đặt xem luồng có bị tắt tiếng hay không.

Yêu cầu sẽ không thành công nếu không có phiên phát nội dung nghe nhìn nào đang diễn ra.

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

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSInteger) requestStatus

Yêu cầu thông tin cập nhật về trạng thái nội dung nghe nhìn từ thiết bị nhận.

Giá trị trả về: Mã yêu cầu hoặc kGCKInvalidRequestID nếu không gửi được thông báo.

- (NSTimeInterval) approximateStreamPosition

Trả về vị trí phát trực tiếp ước chừng được tính từ thông tin phát trực tiếp gần đây nhất nhận được và thời gian thực đã trôi qua kể từ lần cập nhật đó.

Trả về 0 nếu kênh không được kết nối hoặc nếu hiện không có nội dung nghe nhìn nào được tải.

- (BOOL) cancelRequestWithID: (NSInteger) requestID

Huỷ một yêu cầu đang diễn ra.

Việc huỷ yêu cầu không ngăn yêu cầu đó được thực thi; việc này chỉ cho biết rằng ứng dụng gọi không còn quan tâm đến kết quả của yêu cầu nữa, vì vậy, mọi trạng thái liên quan đến việc theo dõi yêu cầu sẽ bị xoá.

Parameters

requestID The ID of the request to cancel.

Giá trị trả về: YES nếu yêu cầu bị huỷ hoặc NO nếu không có yêu cầu nào được theo dõi bằng mã nhận dạng đã cho.

- (instancetype) initWithNamespace: (NSString *) protocolNamespace

Trình khởi tạo được chỉ định.

Tạo một GCKCastChannel mới bằng không gian tên đã cho.

Parameters

protocolNamespace The namespace.

Được triển khai trong GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *) message

Được gọi khi một tin nhắn văn bản được nhận trên kênh này.

Phương thức triển khai mặc định là không hoạt động.

Parameters

message The message.

- (BOOL) sendTextMessage: (NSString *) message

Gửi tin nhắn văn bản trên kênh này.

Parameters

message The message.

Giá trị trả về: YES nếu thành công hoặc NO nếu không gửi được thông báo (vì kênh chưa kết nối hoặc vì bộ đệm gửi hiện đang quá đầy).

Deprecated:: Sử dụng sendTextMessage:error: để cung cấp thông tin chi tiết về lỗi.

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

Gửi tin nhắn văn bản trên kênh này.

Parameters

message	The message.
error	A pointer at which to store the error result. May be `nil`.

Giá trị trả về: YES nếu thành công hoặc NO nếu không gửi được tin nhắn.

- (NSInteger) generateRequestID

Tạo mã yêu cầu cho một thông báo mới.

Giá trị trả về: Mã nhận dạng được tạo hoặc kGCKInvalidRequestID nếu kênh hiện không được kết nối.

- (NSNumber * __nullable) generateRequestNumber

Một phương thức thuận tiện bao bọc kết quả của generateRequestID trong một NSNumber.

Giá trị trả về: Mã nhận dạng được tạo hoặc nil nếu kênh hiện không được kết nối.

- (void) didConnect

Được gọi khi kênh này đã kết nối, cho biết rằng giờ đây, các thông báo có thể được trao đổi với thiết bị truyền qua kênh này.

Phương thức triển khai mặc định là không hoạt động.

- (void) didDisconnect

Được gọi khi kênh này bị ngắt kết nối, cho biết rằng không thể trao đổi thông báo với thiết bị truyền qua kênh này nữa.

Phương thức triển khai mặc định là không hoạt động.

Thông tin chi tiết về cơ sở lưu trú

- (GCKMediaStatus*) mediaStatus

readnonatomicstrong

Trạng thái nội dung nghe nhìn của nội dung nghe nhìn hiện đang được tải (nếu có); nếu không thì là nil.

- (NSTimeInterval) timeSinceLastMediaStatusUpdate

readnonatomicassign

Khoảng thời gian đã trôi qua kể từ lần gần đây nhất nhận được bản cập nhật trạng thái nội dung nghe nhìn.

Nếu có yêu cầu về trạng thái đang được xử lý, thì giá trị này sẽ là 0.

- (GCKError*) lastError

readnonatomiccopy

Thông tin chi tiết về lỗi của yêu cầu gần đây nhất (nếu có) hoặc nil nếu yêu cầu gần đây nhất thành công.

- (id<GCKMediaControlChannelDelegate>) delegate

readwritenonatomicweak

Uỷ quyền nhận thông báo về các thay đổi trong trạng thái của kênh.

- (NSString*) protocolNamespace

readnonatomiccopyinherited

Không gian tên của kênh.

- (BOOL) isConnected

readnonatomicassigninherited

Một cờ cho biết liệu kênh này có đang kết nối hay không.

- (GCKDeviceManager*) deviceManager

readnonatomicweakinherited

Trình quản lý thiết bị mà kênh này đã đăng ký, nếu có.

Deprecated:: Nếu kênh này chưa được đăng ký bằng lớp GCKDeviceManager không dùng nữa, thì giá trị này sẽ là nil.

Lớp GCKMediaControlChannel Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tổng quan

Tóm tắt phương thức của thực thể

Tóm tắt về tài sản

Thông tin chi tiết về phương thức

Thông tin chi tiết về cơ sở lưu trú

Lớp GCKMediaControlChannel