Lớp GCKMediaControlChannel

Tài liệu tham khảo về lớp GCKMediaControlChannel

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 phải có một trạng thái nội dung phương tiện hợp lệ (tức là không có giá trị rỗng) nếu không sẽ trả về kGCKInvalidRequestID và sẽ không gửi yêu cầu. Trạng thái nội dung nghe nhìn được yêu cầu tự động khi kênh kết nối, có trong quá trình tải lạ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ở nên 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. Khi sử dụng kênh này, bạn phải 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à các phương thức chỉ hoạt động trên các luồng sẽ được gọi trong khi trạng thái nội dung đa phương tiện không phải là null.

Nếu một yêu cầu được bắt đầu, 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 không thành công. Nếu một yêu cầu được khởi động thành công nhưng cuối cùng không thành công, 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 ủy 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. Thêm...
 
(NSInteger) - loadMedia:
 Tải và bắt đầu phát một mục nội dung đa phương tiện mới. Thêm...
 
(NSInteger) - loadMedia:autoplay:
 Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn. Thêm...
 
(NSInteger) - loadMedia:autoplay:playPosition:
 Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn. Thêm...
 
(NSInteger) - loadMedia:autoplay:playPosition:customData:
 Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn. Thêm...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:
 Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn. Thêm...
 
(NSInteger) - loadMedia:autoplay:playPosition:activeTrackIDs:customData:
 Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn. Thêm...
 
(NSInteger) - setActiveTrackIDs:
 Đặt các kênh đang hoạt động. Thêm...
 
(NSInteger) - setTextTrackStyle:
 Đặt kiểu bản nhạc. Thêm...
 
(NSInteger) - pause
 Tạm dừng phát mục nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - pauseWithCustomData:
 Tạm dừng phát mục nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - stop
 Dừng phát mục nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - stopWithCustomData:
 Dừng phát mục nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - play
 Bắt đầu (hoặc tiếp tục) phát nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - playWithCustomData:
 Bắt đầu (hoặc tiếp tục) phát nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - seekToTimeInterval:
 Tìm vị trí mới trong mục nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - seekToTimeInterval:resumeState:
 Tìm vị trí mới trong mục nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - seekToTimeInterval:resumeState:customData:
 Tìm vị trí mới trong mục nội dung đa phương tiện hiện tại. Thêm...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:
 Tải và bắt đầu phát một hàng đợi các mục nội dung đa phương tiện mới (không bắt buộc). Thêm...
 
(NSInteger) - queueLoadItems:startIndex:repeatMode:customData:
 Tải và bắt đầu phát một hàng đợi các mục nội dung đa phương tiện mới (không bắt buộc). Thêm...
 
(NSInteger) - queueLoadItems:startIndex:playPosition:repeatMode:customData:
 Tải và bắt đầu phát một hàng đợi các mục nội dung đa phương tiện mới (không bắt buộc). Thêm...
 
(NSInteger) - queueInsertItems:beforeItemWithID:
 Chèn danh sách các mục nội dung đa phương tiện mới vào hàng đợi. Thêm...
 
(NSInteger) - queueInsertItems:beforeItemWithID:customData:
 Chèn danh sách các mục nội dung đa phương tiện mới vào hàng đợi. Thêm...
 
(NSInteger) - queueInsertItem:beforeItemWithID:
 Phương thức tiện lợi có thể chèn một mục vào hàng đợi. Thêm...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:
 Phương thức tiện lợi có thể chèn một mục vào hàng đợi và đặt mục đó làm mục hiện tại. Thêm...
 
(NSInteger) - queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
 Phương thức tiện lợi có thể chèn một mục vào hàng đợi và đặt mục đó làm mục hiện tại. Thêm...
 
(NSInteger) - queueUpdateItems:
 Cập nhật danh sách chờ. Thêm...
 
(NSInteger) - queueUpdateItems:customData:
 Cập nhật danh sách chờ. Thêm...
 
(NSInteger) - queueRemoveItemsWithIDs:
 Xoá một danh sách các mục nội dung đa phương tiện khỏi danh sách chờ. Thêm...
 
(NSInteger) - queueRemoveItemsWithIDs:customData:
 Xoá một danh sách các mục nội dung đa phương tiện khỏi danh sách chờ. Thêm...
 
(NSInteger) - queueRemoveItemWithID:
 Phương thức tiện lợi giúp xoá một mục khỏi danh sách chờ. Thêm...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:
 Sắp xếp lại danh sách các mục nội dung đa phương tiện trong hàng đợi. Thêm...
 
(NSInteger) - queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
 Sắp xếp lại danh sách các mục nội dung đa phương tiện trong hàng đợi. Thêm...
 
(NSInteger) - queueMoveItemWithID:beforeItemWithID:
 Phương thức tiện lợi giúp di chuyển một mục trong hàng đợi. Thêm...
 
(NSInteger) - queueJumpToItemWithID:
 Chuyển đến mục có mã nhận dạng được chỉ định trong hàng đợi. Thêm...
 
(NSInteger) - queueJumpToItemWithID:customData:
 Chuyển đến mục có mã nhận dạng được chỉ định trong hàng đợi. Thêm...
 
(NSInteger) - queueJumpToItemWithID:playPosition:customData:
 Chuyển đến mục có mã nhận dạng được chỉ định trong hàng đợi. Thêm...
 
(NSInteger) - queueNextItem
 Chuyển đến mục tiếp theo trong hàng đợi. Thêm...
 
(NSInteger) - queuePreviousItem
 Chuyển về mục trước trong hàng đợi. Thêm...
 
(NSInteger) - queueSetRepeatMode:
 Đặt chế độ lặp lại hàng đợi. Thêm...
 
(NSInteger) - setStreamVolume:
 Đặt âm lượng của luồng. Thêm...
 
(NSInteger) - setStreamVolume:customData:
 Đặt âm lượng của luồng. Thêm...
 
(NSInteger) - setStreamMuted:
 Thiết lập liệu có tắt tiếng luồng không. Thêm...
 
(NSInteger) - setStreamMuted:customData:
 Thiết lập liệu có tắt tiếng luồng không. Thêm...
 
(NSInteger) - requestStatus
 Yêu cầu thông tin về trạng thái nội dung nghe nhìn mới nhất từ người nhận. Thêm...
 
(NSTimeInterval) - approximateStreamPosition
 Trả về vị trí ước tính của luồng dữ liệu như được tính từ lần nhận thông tin gần đây nhất về luồng và thời gian đã trôi qua kể từ lần cập nhật đó. Thêm...
 
(BOOL) - cancelRequestWithID:
 Hủy một yêu cầu đang diễn ra. Thêm...
 
(instancetype) - initWithNamespace:
 Trình khởi tạo được chỉ định. Thêm...
 
(void) - didReceiveTextMessage:
 Được gọi khi nhận được tin nhắn văn bản trên kênh này. Thêm...
 
(BOOL) - sendTextMessage:
 Gửi tin nhắn văn bản trên kênh này. Thêm...
 
(BOOL) - sendTextMessage:error:
 Gửi tin nhắn văn bản trên kênh này. Thêm...
 
(NSInteger) - generateRequestID
 Tạo mã yêu cầu cho một tin nhắn mới. Thêm...
 
(NSNumber *__nullable) - generateRequestNumber
 Một phương thức tiện lợi bao bọc kết quả của generateRequestID trong một NSNumber. Thêm...
 
(void) - didConnect
 Được gọi khi kênh này được kết nối, cho biết rằng hiện bạn có thể trao đổi tin nhắn với thiết bị Truyền qua kênh này. Thêm...
 
(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 tin nhắn với thiết bị Truyền qua kênh này nữa. Thêm...
 

Tóm tắt thuộc tính

GCKMediaStatusmediaStatus
 Trạng thái nội dung nghe nhìn cho nội dung nghe nhìn hiện được tải, nếu có; nếu không thì sẽ là nil. Thêm...
 
NSTimeInterval timeSinceLastMediaStatusUpdate
 Khoảng thời gian đã trôi qua kể từ lần nhận được thông tin cập nhật trạng thái nội dung nghe nhìn gần đây nhất. Thêm...
 
GCKErrorlastError
 Thông tin chi tiết về lỗi trong yêu cầu gần đây nhất (nếu có) hoặc nil nếu yêu cầu gần nhất thành công. Thêm...
 
id< GCKMediaControlChannelDelegatedelegate
 Người được ủy quyền nhận thông báo về các thay đổi đối với trạng thái của kênh. Thêm...
 
NSString * protocolNamespace
 Không gian tên của kênh. Thêm...
 
BOOL isConnected
 Cờ cho biết liệu kênh này hiện có được kết nối hay không. Thêm...
 
GCKDeviceManagerdeviceManager
 Trình quản lý thiết bị mà kênh này đã đăng ký, nếu có. Thêm...
 

Chi tiết 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 đa phương tiện mới.

Parameters
mediaInfoAn object describing the media item to load.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay 

Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn.

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition 

Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn.

Parameters
mediaInfoAn object describing the media item to load.
autoplayWhether playback should start immediately.
playPositionThe initial playback position.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs 

Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) loadMedia: (GCKMediaInformation *)  mediaInfo
autoplay: (BOOL)  autoplay
playPosition: (NSTimeInterval)  playPosition
activeTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs
customData: (id __nullable)  customData 

Tải và bắt đầu phát một mục nội dung đa phương tiện mới nếu muốn.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) setActiveTrackIDs: (NSArray< NSNumber * > *__nullable)  activeTrackIDs

Đặt các kênh đang hoạt động.

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

Parameters
activeTrackIDsAn array of integers specifying the active tracks.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư. Có thể là nil hoặc một mảng trống để đặt các kênh đang hoạt động thành danh sách trống.
- (NSInteger) setTextTrackStyle: (GCKMediaTextTrackStyle *__nullable)  textTrackStyle

Đặt kiểu bản nhạc.

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

Parameters
textTrackStyleThe text track style. The style will not be changed if this is nil.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (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ành công nếu hiện không có trạng thái nội dung nghe nhìn.

Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (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ành công nếu hiện không có trạng thái nội dung nghe nhìn.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (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ành công nếu hiện không có trạng thái nội dung nghe nhìn. Nếu một hàng đợi hiện đang được tải, hàng đợi đó sẽ bị xóa.

Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (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ành công nếu hiện không có trạng thái nội dung nghe nhìn. Nếu một hàng đợi hiện đang được tải, hàng đợi đó sẽ bị xóa.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) play

Bắt đầu (hoặc tiếp tục) phát nội dung đa phương tiện hiện tại.

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

Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) playWithCustomData: (id __nullable)  customData

Bắt đầu (hoặc tiếp tục) phát nội dung đa phương tiện hiện tại.

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

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position

Tìm 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ành công nếu hiện không có trạng thái nội dung nghe nhìn.

Parameters
positionThe new position from the beginning of the stream.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState 

Tìm 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ành công nếu hiện không có trạng thái nội dung nghe nhìn.

Parameters
positionThe new position interval from the beginning of the stream.
resumeStateThe action to take after the seek operation has finished.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) seekToTimeInterval: (NSTimeInterval)  position
resumeState: (GCKMediaControlChannelResumeState resumeState
customData: (id __nullable)  customData 

Tìm 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ành công nếu hiện không có trạng thái nội dung nghe nhìn.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode 

Tải và bắt đầu phát một hàng đợi các mục nội dung đa phương tiện mới (không bắt buộc).

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueLoadItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
startIndex: (NSUInteger)  startIndex
repeatMode: (GCKMediaRepeatMode repeatMode
customData: (id __nullable)  customData 

Tải và bắt đầu phát một hàng đợi các mục nội dung đa phương tiện mới (không bắt buộc).

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào 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à bắt đầu phát một hàng đợi các mục nội dung đa phương tiện mới (không bắt buộc).

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào 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 đa phương tiện mới vào hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào 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 đa phương tiện mới vào hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueInsertItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

Phương thức tiện lợi có thể chèn một mục vào hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID 

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

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueInsertAndPlayItem: (GCKMediaQueueItem *)  item
beforeItemWithID: (NSUInteger)  beforeItemID
playPosition: (NSTimeInterval)  playPosition
customData: (id __nullable)  customData 

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

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems

Cập nhật danh sách chờ.

Parameters
queueItemsThe list of updated items.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *)  queueItems
customData: (id __nullable)  customData 

Cập nhật danh sách chờ.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *)  itemIDs

Xoá một danh sách các mục nội dung đa phương tiện khỏi danh sách chờ.

Nếu hàng đợi trống do đó, phiên phương tiện hiện tại sẽ bị chấm dứt.

Parameters
itemIDsAn array of media item IDs identifying the items to remove. Must not be nil or empty.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào 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 đa phương tiện khỏi danh sách chờ.

Nếu hàng đợi trống do đó, phiên phương tiện hiện tại sẽ bị chấm dứt.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueRemoveItemWithID: (NSUInteger)  itemID

Phương thức tiện lợi giúp xoá một mục khỏi danh sách chờ.

Parameters
itemIDThe ID of the item to remove.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào 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 đa phương tiện trong hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào 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 đa phương tiện trong hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueMoveItemWithID: (NSUInteger)  itemID
beforeItemWithID: (NSUInteger)  beforeItemID 

Phương thức tiện lợi giúp di chuyển một mục trong hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID

Chuyển đến mục có mã nhận dạng được chỉ định trong hàng đợi.

Parameters
itemIDThe ID of the item to jump to.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi tin nhắn.
- (NSInteger) queueJumpToItemWithID: (NSUInteger)  itemID
customData: (id __nullable)  customData 

Chuyển đến mục có mã nhận dạng được chỉ định trong hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi tin nhắn.
- (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 hàng đợi.

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.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi tin nhắn.
- (NSInteger) queueNextItem

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

Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi tin nhắn.
- (NSInteger) queuePreviousItem

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

Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi tin nhắn.
- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode repeatMode

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

Parameters
repeatModeThe new repeat mode.
Trả về
Mã yêu cầu của yêu cầu này hoặc kGCKInvalidRequestID nếu không thể gửi thông báo hoặc có bất kỳ thông số nào không hợp lệ.
- (NSInteger) setStreamVolume: (float)  volume

Đặt âm lượng của luồng.

Yêu cầu sẽ không thành công nếu không có phiên đa phương tiện hiện tại.

Parameters
volumeThe new volume, in the range [0.0 - 1.0].
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) setStreamVolume: (float)  volume
customData: (id __nullable)  customData 

Đặt âm lượng của luồng.

Yêu cầu sẽ không thành công nếu không có phiên đa phương tiện hiện tại.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) setStreamMuted: (BOOL)  muted

Thiết lập liệu có tắt tiếng luồng không.

Yêu cầu sẽ không thành công nếu không có phiên đa phương tiện hiện tại.

Parameters
mutedWhether the stream should be muted or unmuted.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) setStreamMuted: (BOOL)  muted
customData: (id __nullable)  customData 

Thiết lập liệu có tắt tiếng luồng không.

Yêu cầu sẽ không thành công nếu không có phiên đa phương tiện hiện tại.

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.
Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSInteger) requestStatus

Yêu cầu thông tin về trạng thái nội dung nghe nhìn mới nhất từ người nhận.

Trả về
Mã yêu cầu hoặc kGCKInvalidRequestID nếu không thể gửi thư.
- (NSTimeInterval) approximateStreamPosition

Trả về vị trí ước tính của luồng dữ liệu như được tính từ lần nhận thông tin gần đây nhất về luồng và thời gian đã trôi qua kể từ lần cập nhật đó.

Trả về 0 nếu kênh chưa được kết nối hoặc nếu không có phương tiện nào được tải hiện tại.

- (BOOL) cancelRequestWithID: (NSInteger)  requestID

Hủy một yêu cầu đang diễn ra.

Việc huỷ một yêu cầu không ngăn việc thực thi yêu cầu đó mà 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, vì vậy mọi trạng thái liên kết với quá trình theo dõi yêu cầu sẽ bị xoá.

Parameters
requestIDThe ID of the request to cancel.
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 đó.
- (instancetype) initWithNamespace: (NSString *)  protocolNamespace

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

Tạo một GCKCastChannel mới với vùng chứa tên đã cho.

Parameters
protocolNamespaceThe namespace.

Được triển khai trong GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *)  message

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

Cách triển khai mặc định là không hoạt động.

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

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

Parameters
messageThe message.
Trả về
YES khi gửi thành công hoặc NO nếu không gửi được tin nhắn (vì kênh không được kết nối hoặc do vùng đệm gửi quá đầy hiện tại).
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
messageThe message.
errorA pointer at which to store the error result. May be nil.
Trả về
YES 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 tin nhắn mới.

Trả về
Mã đượ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 tiện lợi bao bọc kết quả của generateRequestID trong một NSNumber.

Trả về
Mã đượ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 được kết nối, cho biết rằng hiện bạn có thể trao đổi tin nhắn với thiết bị Truyền qua kênh này.

Cách 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 tin nhắn với thiết bị Truyền qua kênh này nữa.

Cách triển khai mặc định là không hoạt động.

Chi tiết thuộc tính

- (GCKMediaStatus*) mediaStatus
readnonatomicstrong

Trạng thái nội dung nghe nhìn cho nội dung nghe nhìn hiện được tải, nếu có; nếu không thì sẽ là nil.

- (NSTimeInterval) timeSinceLastMediaStatusUpdate
readnonatomicassign

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

Nếu một yêu cầu trạng thái hiện đang diễn ra, thì giá trị này sẽ là 0.

- (GCKError*) lastError
readnonatomiccopy

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

- (id<GCKMediaControlChannelDelegate>) delegate
readwritenonatomicweak

Người được ủy quyền nhận thông báo về các thay đổi đối với trạng thái của kênh.

- (NSString*) protocolNamespace
readnonatomiccopyinherited

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

- (BOOL) isConnected
readnonatomicassigninherited

Cờ cho biết liệu kênh này hiện có được 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 không được đăng ký bằng lớp GCKDeviceManager không còn được dùng nữa, thì đây sẽ là nil.