Tổng quan

Bộ điều khiển cho các chế độ xem giao diện người dùng được dùng để điều khiển hoặc hiển thị trạng thái phát nội dung nghe nhìn trên Bộ thu truyền.

Ứng dụng gọi đăng ký các bộ điều khiển trên giao diện người dùng liên quan đến nội dung nghe nhìn với bộ điều khiển bằng cách đặt các thuộc tính thích hợp. Sau đó, bộ điều khiển này phản hồi các sự kiện chạm trên các nút điều khiển bằng cách tạo các lệnh nội dung đa phương tiện thích hợp cho người nhận, đồng thời cập nhật các chế độ điều khiển dựa trên thông tin trạng thái và siêu dữ liệu đa phương tiện nhận được từ người nhận. Bộ điều khiển này sẽ tự động bật và tắt các chế độ điều khiển trên giao diện người dùng cho phù hợp với trạng thái hiện tại của phiên và trình phát nội dung nghe nhìn. Nó cũng tắt tất cả các tùy chọn điều khiển khi có một yêu cầu đang diễn ra.

Hãy xem GCKUIMediaControllerDelegate để biết giao thức ủy quyền.

Since: 3.0

Kế thừa NSObject.

Tóm tắt phương thức của thực thể
(instancetype)	- init
	Khởi tạo một thực thể. Thêm...

(void)	- bindLabel:toMetadataKey:
	Liên kết UILabel với một khoá siêu dữ liệu. Thêm...

(void)	- bindLabel:toMetadataKey:withFormatter:
	Liên kết UILabel với một khoá siêu dữ liệu. Thêm...

(void)	- bindTextView:toMetadataKey:
	Liên kết UITextView với khoá siêu dữ liệu. Thêm...

(void)	- bindTextView:toMetadataKey:withFormatter:
	Liên kết UITextView với khoá siêu dữ liệu. Thêm...

(void)	- bindImageView:toImageHints:
	Liên kết UIImageView với một thực thể GCKUIImageHints. Thêm...

(void)	- unbindView:
	Huỷ liên kết chế độ xem đã chỉ định. Thêm...

(void)	- unbindAllViews
	Huỷ liên kết tất cả các chế độ xem liên kết. Thêm...

(GCKMediaRepeatMode)	- cycleRepeatMode
	Thay đổi chế độ lặp lại cho hàng đợi thành chế độ tiếp theo trong chu kỳ: Thêm...

(void)	- selectTracks
	Một phương thức thuận tiện để hiển thị giao diện người dùng của lựa chọn nội dung đa phương tiện. Thêm...

Tóm tắt thuộc tính
id< GCKUIMediaControllerDelegate >	delegate
	Người được ủy quyền nhận thông báo từ GCKUIMediaController. Thêm...

GCKSession *	session
	Phiên được liên kết với bộ điều khiển này. Thêm...

BOOL	mediaLoaded
	Hiện có phương tiện đang tải (hoặc đang tải) trên bộ thu hay không. Thêm...

BOOL	hasCurrentQueueItem
	Liệu có mục hiện tại trong hàng đợi hay không. Thêm...

BOOL	hasLoadingQueueItem
	Liệu có một mục đang được tải trước trong hàng đợi hay không. Thêm...

GCKMediaPlayerState	lastKnownPlayerState
	Trạng thái mới nhất của trình phát nội dung nghe nhìn đã biết. Thêm...

NSTimeInterval	lastKnownStreamPosition
	Vị trí luồng phương tiện mới nhất đã biết. Thêm...

UIButton *	playButton
	Nút "phát". Thêm...

UIButton *	pauseButton
	Nút "tạm dừng". Thêm...

GCKUIButton *	playPauseToggleButton
	Nút bật tắt "phát/tạm dừng". Thêm...

GCKUIPlayPauseToggleController *	playPauseToggleController
	Trình điều khiển bật/tắt "phát/tạm dừng". Thêm...

UIButton *	stopButton
	Nút "dừng". Thêm...

GCKUIButton *	forward30SecondsButton
	Nút để tua đi 30 giây trong mục nội dung đa phương tiện đang phát. Thêm...

GCKUIButton *	rewind30SecondsButton
	Nút để tua lại 30 giây trong mục nội dung đa phương tiện đang phát. Thêm...

UIButton *	pauseQueueButton
	Một nút để tạm dừng phát hàng đợi sau khi mục hiện tại phát xong. Thêm...

UIButton *	nextButton
	Nút "tiếp theo". Thêm...

UIButton *	previousButton
	Nút "trước". Thêm...

GCKUIButton *	repeatModeButton
	Một nút để đạp xe qua các chế độ lặp lại của hàng đợi có sẵn. Thêm...

UISlider *	streamPositionSlider
	Thanh trượt để hiển thị và thay đổi vị trí luồng hiện tại. Thêm...

UIProgressView *	streamProgressView
	Chế độ xem để hiển thị tiến trình luồng hiện tại. Thêm...

UILabel *	streamPositionLabel
	Nhãn để hiển thị vị trí luồng hiện tại, tính bằng phút và giây. Thêm...

UILabel *	streamDurationLabel
	Nhãn để hiển thị thời lượng phát trực tiếp hiện tại tính bằng phút và giây. Thêm...

UILabel *	streamTimeRemainingLabel
	Nhãn để hiển thị thời gian phát trực tuyến còn lại (thời lượng trừ vị trí), tính bằng phút và giây. Thêm...

GCKUIStreamPositionController *	streamPositionController
	Bộ điều khiển tích hợp luồng. Thêm...

BOOL	displayTimeRemainingAsNegativeValue
	Liệu thời gian phát trực tuyến còn lại có hiển thị dưới dạng giá trị âm hay không, ví dụ: "-1:23:45". Thêm...

UIButton *	tracksButton
	Một nút để chọn các bản âm thanh và/hoặc phụ đề. Thêm...

UILabel *	smartSubtitleLabel
	Nhãn để hiển thị phụ đề cho nội dung nghe nhìn hiện đã tải. Thêm...

UIActivityIndicatorView *	mediaLoadingIndicator
	Chế độ xem chỉ báo hoạt động để cho biết nội dung nghe nhìn đang ở trạng thái tải. Thêm...

Chi tiết phương thức

- (instancetype) init

Khởi tạo một thực thể.

- (void) bindLabel:	(UILabel *)	label
toMetadataKey:	(NSString *)	key

Liên kết UILabel với một khoá siêu dữ liệu.

Chế độ xem sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.

Xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu xác định trước.

Parameters

label	The UILabel that will display the value.
key	The metadata key.

- (void) bindLabel:	(UILabel *)	label
toMetadataKey:	(NSString *)	key
withFormatter:	(GCKUIValueFormatter)	formatter

Liên kết UILabel với một khoá siêu dữ liệu.

Chế độ xem sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.

Xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu xác định trước.

Parameters

label	The UILabel that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

- (void) bindTextView:	(UITextView *)	textView
toMetadataKey:	(NSString *)	key

Liên kết UITextView với khoá siêu dữ liệu.

Chế độ xem sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.

Xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu xác định trước.

Parameters

textView	The UITextView that will display the value.
key	The metadata key.

- (void) bindTextView:	(UITextView *)	textView
toMetadataKey:	(NSString *)	key
withFormatter:	(GCKUIValueFormatter)	formatter

Liên kết UITextView với khoá siêu dữ liệu.

Chế độ xem sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.

Xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu xác định trước.

Parameters

textView	The UITextView that will display the value.
key	The metadata key.
formatter	A block that will produce the desired string representation of the value.

- (void) bindImageView:	(UIImageView *)	imageView
toImageHints:	(GCKUIImageHints *)	imageHints

Liên kết UIImageView với một thực thể GCKUIImageHints.

UIImagePicker hiện được cài đặt sẽ được sử dụng để chọn hình ảnh từ siêu dữ liệu cho chế độ xem.

Parameters

imageView	The UIImageView that will display the selected image.
imageHints	The image hints.

- (void) unbindView: (UIView *) view

Huỷ liên kết chế độ xem đã chỉ định.

Parameters

view	The view to unbind.

- (void) unbindAllViews

Huỷ liên kết tất cả các chế độ xem liên kết.

- (GCKMediaRepeatMode) cycleRepeatMode

Thay đổi chế độ lặp lại cho hàng đợi thành chế độ tiếp theo trong chu kỳ:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

Trả về: Chế độ lặp lại mới.

- (void) selectTracks

Một phương thức thuận tiện để hiển thị giao diện người dùng của lựa chọn nội dung đa phương tiện.

Chi tiết thuộc tính

- (id<GCKUIMediaControllerDelegate>) delegate

readwritenonatomicweak

Người được ủy quyền nhận thông báo từ GCKUIMediaController.

- (GCKSession*) session

readnonatomicstrong

Phiên được liên kết với bộ điều khiển này.

- (BOOL) mediaLoaded

readnonatomicassign

Hiện có phương tiện đang tải (hoặc đang tải) trên bộ thu hay không.

Nếu không có phiên Truyền nào đang hoạt động, thì phiên này sẽ là NO.

- (BOOL) hasCurrentQueueItem

readnonatomicassign

Liệu có mục hiện tại trong hàng đợi hay không.

- (BOOL) hasLoadingQueueItem

readnonatomicassign

Liệu có một mục đang được tải trước trong hàng đợi hay không.

- (GCKMediaPlayerState) lastKnownPlayerState

readnonatomicassign

Trạng thái mới nhất của trình phát nội dung nghe nhìn đã biết.

Nếu không có phiên Truyền nào đang hoạt động, đây sẽ là trạng thái người chơi ngay trước khi phiên cuối cùng kết thúc. Nếu không có phiên trước đó, đây sẽ là GCKMediaPlayerStateUnknown.

- (NSTimeInterval) lastKnownStreamPosition

readnonatomicassign

Vị trí luồng phương tiện mới nhất đã biết.

Nếu không có phiên Truyền nào đang hoạt động, đây sẽ là vị trí luồng của phương tiện ngay trước khi phiên cuối cùng kết thúc. Nếu không có phiên trước đó, đây sẽ là kGCKInvalidTimeInterval.

- (UIButton*) playButton

readwritenonatomicweak

Nút "phát".

Khi người dùng nhấn vào nút này, quá trình phát nội dung nghe nhìn hiện đang tải sẽ được bắt đầu hoặc tiếp tục trên thiết bị nhận. Nút này sẽ bị tắt nếu quá trình phát đang diễn ra, hoặc hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (UIButton*) pauseButton

readwritenonatomicweak

Nút "tạm dừng".

Khi người dùng nhấn vào nút, bản phát nội dung nghe nhìn đang tải hiện đang bị tạm dừng trên thiết bị nhận. Nút này sẽ bị tắt nếu nội dung nghe nhìn hiện đã tải không hỗ trợ tạm dừng, hoặc nếu hiện không phát nội dung, hoặc hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (GCKUIButton*) playPauseToggleButton

readwritenonatomicweak

Nút bật tắt "phát/tạm dừng".

Phương thức gọi nên đặt biểu tượng phù hợp cho trạng thái GCKUIControlStatePlay và GCKUIControlStatePause của nút, cụ thể là biểu tượng "tạm dừng" cho trạng thái phát và biểu tượng "phát" cho trạng thái tạm dừng. Trạng thái của nút sẽ tự động cập nhật để phản ánh trạng thái phát hiện tại trên bộ thu. Khi người dùng nhấn vào nút, bản phát nội dung nghe nhìn đang tải hiện đang bị tạm dừng hoặc tiếp tục trên bộ thu. Nút này sẽ bị tắt nếu nội dung nghe nhìn hiện đã tải không hỗ trợ tạm dừng, hoặc nếu nội dung phát hiện không phát hoặc đang tạm dừng, hoặc nếu không có nội dung nghe nhìn nào được tải hoặc nếu không có phiên Truyền nào hiện đang hoạt động.

- (GCKUIPlayPauseToggleController*) playPauseToggleController

readwritenonatomicstrong

Trình điều khiển bật/tắt "phát/tạm dừng".

Được dùng làm trạng thái độc lập cho giao diện người dùng bật/tắt tùy chỉnh do ứng dụng cung cấp. Hãy xem GCKUIPlayPauseToggleController để biết chi tiết.

Since: 3,4

- (UIButton*) stopButton

readwritenonatomicweak

Nút "dừng".

Khi nhấn vào nút này, quá trình phát nội dung nghe nhìn đang tải hiện đang dừng trên thiết bị nhận. Nút này sẽ bị tắt nếu hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (GCKUIButton*) forward30SecondsButton

readwritenonatomicweak

Nút để tua đi 30 giây trong mục nội dung đa phương tiện đang phát.

Nút này sẽ bị tắt nếu hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (GCKUIButton*) rewind30SecondsButton

readwritenonatomicweak

Nút để tua lại 30 giây trong mục nội dung đa phương tiện đang phát.

Nút này sẽ bị tắt nếu hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (UIButton*) pauseQueueButton

readwritenonatomicweak

Một nút để tạm dừng phát hàng đợi sau khi mục hiện tại phát xong.

- (UIButton*) nextButton

readwritenonatomicweak

Nút "tiếp theo".

Khi bạn nhấn vào nút, tính năng phát sẽ được chuyển sang mục nội dung đa phương tiện tiếp theo trong hàng đợi. Nút này sẽ bị tắt nếu thao tác này không được hỗ trợ, hoặc hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (UIButton*) previousButton

readwritenonatomicweak

Nút "trước".

Khi bạn nhấn vào nút, bản phát lại sẽ chuyển về mục nội dung đa phương tiện trước trong hàng đợi. Nút này sẽ bị tắt nếu thao tác này không được hỗ trợ, hoặc hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (GCKUIButton*) repeatModeButton

readwritenonatomicweak

Một nút để đạp xe qua các chế độ lặp lại của hàng đợi có sẵn.

(Xem GCKMediaRepeatMode.) Phương thức gọi phải đặt các biểu tượng phù hợp với trạng thái UIControlStateBình thường (đã tắt chế độ lặp lại), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll và GCKUIControlStateShuffle. Trạng thái của nút sẽ tự động cập nhật để phản ánh chế độ lặp lại hàng đợi hiện tại trên bộ thu. Nhấn vào nút sẽ chuyển sang chế độ lặp lại tiếp theo, theo thứ tự:

GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle

Nút này sẽ bị tắt nếu hiện không có phiên Truyền nào.

- (UISlider*) streamPositionSlider

readwritenonatomicweak

Thanh trượt để hiển thị và thay đổi vị trí luồng hiện tại.

Khi người dùng thay đổi giá trị của thanh trượt, vị trí luồng của phương tiện được tải hiện tại sẽ được cập nhật trên trình nhận. Khi đang phát nội dung đa phương tiện trên thiết bị nhận, giá trị của thanh trượt được cập nhật theo thời gian thực để phản ánh vị trí luồng hiện tại. Thanh trượt sẽ bị tắt nếu nội dung nghe nhìn hiện đã tải không hỗ trợ tìm kiếm hoặc nếu hiện không có nội dung nghe nhìn nào được tải hoặc nếu hiện không có phiên Truyền nào.

- (UIProgressView*) streamProgressView

readwritenonatomicweak

Chế độ xem để hiển thị tiến trình luồng hiện tại.

Khi phát nội dung đa phương tiện đang diễn ra trên bộ thu, giá trị của thành phần hiển thị được cập nhật theo thời gian thực để phản ánh vị trí của luồng hiện tại. Chế độ xem này sẽ bị tắt nếu nội dung nghe nhìn hiện được tải là luồng trực tiếp hoặc nếu hiện không có nội dung nghe nhìn nào được tải hoặc nếu không có phiên Truyền nào đang hoạt động.

- (UILabel*) streamPositionLabel

readwritenonatomicweak

Nhãn để hiển thị vị trí luồng hiện tại, tính bằng phút và giây.

Nếu hiện không có nội dung nghe nhìn nào được tải hoặc nếu không có phiên Truyền nào đang hoạt động, thì nhãn sẽ hiển thị dạng "--:--" đã bản địa hóa.

- (UILabel*) streamDurationLabel

readwritenonatomicweak

Nhãn để hiển thị thời lượng phát trực tiếp hiện tại tính bằng phút và giây.

Nếu nội dung nghe nhìn hiện đã tải không có thời lượng (ví dụ: nếu nội dung đó là luồng trực tiếp) hoặc nếu nội dung nghe nhìn hiện chưa được tải hoặc nếu hiện không có phiên Truyền nào, thì nhãn sẽ hiển thị một dạng đã bản địa hoá là "--:-".

- (UILabel*) streamTimeRemainingLabel

readwritenonatomicweak

Nhãn để hiển thị thời gian phát trực tuyến còn lại (thời lượng trừ vị trí), tính bằng phút và giây.

Nếu nội dung nghe nhìn hiện đã tải không có thời lượng (ví dụ: nếu nội dung đó là luồng trực tiếp) hoặc nếu nội dung nghe nhìn hiện chưa được tải hoặc nếu hiện không có phiên Truyền nào, thì nhãn sẽ hiển thị một dạng đã bản địa hoá là "--:-".

- (GCKUIStreamPositionController*) streamPositionController

readwritenonatomicstrong

Bộ điều khiển tích hợp luồng.

Được dùng làm trạng thái độc lập cho vị trí luồng tuỳ chỉnh do ứng dụng cung cấp và/hoặc tìm kiếm giao diện người dùng. Hãy xem GCKUIStreamPositionController để biết chi tiết.

Since: 3,4

- (BOOL) displayTimeRemainingAsNegativeValue

readwritenonatomicassign

Liệu thời gian phát trực tuyến còn lại có hiển thị dưới dạng giá trị âm hay không, ví dụ: "-1:23:45".

Theo mặc định, thuộc tính này được đặt thành YES.

- (UIButton*) tracksButton

readwritenonatomicweak

Một nút để chọn các bản âm thanh và/hoặc phụ đề.

Khi người dùng nhấn vào nút này, giao diện người dùng của lựa chọn nội dung nghe nhìn sẽ hiển thị với người dùng. Nút này sẽ bị tắt nếu nội dung nghe nhìn hiện đã tải không có bản nhạc/nội dung nghe nhìn có thể chọn nào, hoặc nội dung nghe nhìn hiện đã được tải hoặc nếu hiện không có phiên Truyền nào.

- (UILabel*) smartSubtitleLabel

readwritenonatomicweak

Nhãn để hiển thị phụ đề cho nội dung nghe nhìn hiện đã tải.

Nếu không có trường phụ đề được đặt rõ ràng trong siêu dữ liệu, nhãn sẽ hiển thị trường siêu dữ liệu phù hợp nhất dựa trên loại phương tiện, ví dụ như tên studio cho phim hoặc tên nghệ sĩ cho bản nhạc.

- (UIActivityIndicatorView*) mediaLoadingIndicator

readwritenonatomicweak

Chế độ xem chỉ báo hoạt động để cho biết nội dung nghe nhìn đang ở trạng thái tải.

Lớp GCKUIMediaController

Tổng quan

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

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

Chi tiết phương thức

Chi tiết thuộc tính