Tổng quan
Bộ điều khiển cho các chế độ xem giao diện người dùng dùng để kiểm soát hoặc hiển thị trạng thái phát nội dung nghe nhìn trên thiết bị nhận Cast.
Ứng dụng gọi đăng ký các chế độ đ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 trình đ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 sẽ 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 đưa ra các lệnh nội dung đa phương tiện thích hợp cho trình thu nhận và 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 nội dung nghe nhìn nhận được từ trình thu. Bộ điều khiển này tự động bật và tắt các nút điều khiển trên giao diện người dùng cho phù hợp với phiên hoạt động hiện tại và trạng thái của trình phát nội dung đa phương tiện. Ngoài ra, chế độ này còn tắt tất cả các chế độ kiểm soát khi xử lý yêu cầu.
Xem GCKUIMediaControllerDelegate để biết giao thức uỷ quyền.
- Năm thành lập
- 3
Kế thừa NSObject.
Tóm tắt phương thức thực thể | |
(instancetype) | - init |
Khởi chạy một thực thể. Xem thêm... | |
(void) | - bindLabel:toMetadataKey: |
Liên kết UILabel với khoá siêu dữ liệu. Xem thêm... | |
(void) | - bindLabel:toMetadataKey:withFormatter: |
Liên kết UILabel với khoá siêu dữ liệu. Xem thêm... | |
(void) | - bindTextView:toMetadataKey: |
Liên kết UITextView với một khoá siêu dữ liệu. Xem thêm... | |
(void) | - bindTextView:toMetadataKey:withFormatter: |
Liên kết UITextView với một khoá siêu dữ liệu. Xem thêm... | |
(void) | - bindImageView:toImageHints: |
Liên kết UIImageView với một thực thể GCKUIImageHints. Xem thêm... | |
(void) | - bindControlView:toRewindForTime: |
Liên kết UIControl để tua lại quá trình phát mục hiện tại theo giá trị đã truyền dưới dạng giây. Xem thêm... | |
(void) | - bindControlView:toForwardForTime: |
Liên kết UIControl để chuyển tiếp việc phát mục hiện tại theo giá trị đã truyền dưới dạng giây. Xem thêm... | |
(void) | - unbindView: |
Huỷ liên kết khung hiển thị đã chỉ định. Xem thêm... | |
(void) | - unbindAllViews |
Huỷ liên kết tất cả khung hiển thị liên kết. Xem thêm... | |
(GCKMediaRepeatMode) | - cycleRepeatMode |
Thay đổi chế độ lặp lại của 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 chọn bản nhạc đa phương tiện. Xem thêm... | |
(void) | - skipAd |
Gửi và theo dõi yêu cầu bỏ qua quảng cáo. Xem thêm... | |
Tóm tắt về thuộc tính | |
id< GCKUIMediaControllerDelegate > | delegate |
Thực thể đại diện để nhận thông báo từ GCKUIMediaController. Xem thêm... | |
GCKSession * | session |
Phiên được liên kết với bộ điều khiển này. Xem thêm... | |
BOOL | mediaLoaded |
Liệu có phương tiện nào đang được tải (hoặc đang tải) trên bộ thu không. Xem thêm... | |
BOOL | hasCurrentQueueItem |
Liệu có mục hiện tại trong hàng đợi hay không. Xem thêm... | |
BOOL | hasLoadingQueueItem |
Liệu có mục nào đang được tải trước trong hàng đợi hay không. Xem thêm... | |
GCKMediaPlayerState | lastKnownPlayerState |
Trạng thái trình phát nội dung đa phương tiện đã biết mới nhất. Xem thêm... | |
NSTimeInterval | lastKnownStreamPosition |
Vị trí luồng nội dung đa phương tiện đã biết mới nhất. Xem thêm... | |
UIButton * | playButton |
Nút "phát". Xem thêm... | |
UIButton * | pauseButton |
Nút "tạm dừng". Xem thêm... | |
GCKUIMultistateButton * | playPauseToggleButton |
Nút bật tắt "phát/tạm dừng". Xem thêm... | |
GCKUIPlayPauseToggleController * | playPauseToggleController |
Bộ điều khiển bật/tắt "phát/tạm dừng". Xem thêm... | |
UIButton * | stopButton |
Nút "dừng". Xem thêm... | |
UIButton * | forward30SecondsButton |
Nút để tua đi 30 giây trong mục nội dung nghe nhìn đang phát. Xem thêm... | |
UIButton * | rewind30SecondsButton |
Nút để tua lại 30 giây trong mục nội dung đa phương tiện hiện đang phát. Xem thêm... | |
UIButton * | pauseQueueButton |
Nút để tạm dừng phát trong danh sách chờ sau khi phát xong mục hiện tại. Xem thêm... | |
UIButton * | nextButton |
Nút "tiếp theo". Xem thêm... | |
UIButton * | previousButton |
Nút "trước". Xem thêm... | |
GCKUIMultistateButton * | repeatModeButton |
Một nút để chuyển qua các chế độ lặp lại của hàng đợi hiện có. Xem thêm... | |
UISlider * | streamPositionSlider |
Thanh trượt để hiển thị và thay đổi vị trí phát trực tiếp hiện tại. Xem thêm... | |
UIProgressView * | streamProgressView |
Khung hiển thị để hiển thị tiến trình phát trực tuyến hiện tại. Xem 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. Xem 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. Xem thêm... | |
UILabel * | streamTimeRemainingLabel |
Nhãn hiển thị thời gian phát trực tiếp còn lại (thời lượng trừ đi vị trí), tính bằng phút và giây. Xem thêm... | |
GCKUIStreamPositionController * | streamPositionController |
Bộ điều khiển vị trí luồng. Xem thêm... | |
GCKUIPlaybackRateController * | playbackRateController |
Trình kiểm soát tốc độ phát của sự kiện phát trực tiếp. Xem thêm... | |
BOOL | displayTimeRemainingAsNegativeValue |
Thời gian phát trực tiếp còn lại có hiển thị dưới dạng giá trị âm hay không, ví dụ: "-1:23:45". Xem thêm... | |
BOOL | hideStreamPositionControlsForLiveContent |
Liệu các nút điều khiển vị trí sự kiện phát trực tiếp (bao gồm cả thanh trượt vị trí sự kiện phát trực tiếp, nhãn vị trí sự kiện phát trực tiếp, nhãn thời lượng sự kiện phát trực tiếp và chế độ xem tiến trình phát trực tiếp) có bị ẩn đối với nội dung phát trực tiếp hay không. Xem thêm... | |
UIButton * | tracksButton |
Nút để chọn bản âm thanh và/hoặc phụ đề. Xem thêm... | |
UILabel * | smartSubtitleLabel |
Một nhãn để hiển thị phụ đề cho nội dung nghe nhìn đang tải. Xem thêm... | |
UIActivityIndicatorView * | mediaLoadingIndicator |
Một khung hiển thị chỉ báo hoạt động để cho biết rằng nội dung nghe nhìn đang ở trạng thái tải. Xem thêm... | |
UILabel * | skipAdLabel |
Nhãn hiển thị khoảng thời gian còn lại cho đến khi có thể bỏ qua quảng cáo. Xem thêm... | |
UIButton * | skipAdButton |
Nút để bỏ qua quảng cáo hiện tại. Xem thêm... | |
Chi tiết phương pháp
- (instancetype) init |
Khởi chạy một thực thể.
- (void) bindLabel: | (UILabel *) | label | |
toMetadataKey: | (NSString *) | key | |
Liên kết UILabel với khoá siêu dữ liệu.
Khung hiển thị 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 khoá siêu dữ liệu định sẵn.
- 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 khoá siêu dữ liệu.
Khung hiển thị 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 khoá siêu dữ liệu định sẵn.
- 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 một khoá siêu dữ liệu.
Khung hiển thị 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 khoá siêu dữ liệu định sẵn.
- 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 một khoá siêu dữ liệu.
Khung hiển thị 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 khoá siêu dữ liệu định sẵn.
- 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.
GCKUIImagePicker hiện đã cài đặt sẽ được dùng để chọn một hình ảnh trong siêu dữ liệu cho khung hiển thị.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
- (void) bindControlView: | (UIControl *) | control | |
toRewindForTime: | (NSTimeInterval) | rewindSeconds | |
Liên kết UIControl
để tua lại quá trình phát mục hiện tại theo giá trị đã truyền dưới dạng giây.
Chế độ xem sẽ được cập nhật dựa trên trạng thái GCKCastSession
, trạng thái phát từ xa và việc đó có phải là sự kiện phát trực tiếp hay không. Mục tiêu cũng được thêm vào UIControl
để ghi lại sự kiện UIControlEventTouchUpInside
. Không thêm mục tiêu thuộc loại này trên UIControl
. Thay vào đó, để ghi lại sự kiện này, hãy sử dụng các phương thức GCKUIMediaControllerDelegate
.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton
.rewindSeconds The number of seconds to rewind the media.
- (void) bindControlView: | (UIControl *) | control | |
toForwardForTime: | (NSTimeInterval) | forwardSeconds | |
Liên kết UIControl
để chuyển tiếp việc phát mục hiện tại theo giá trị đã truyền dưới dạng giây.
Chế độ xem sẽ được cập nhật dựa trên trạng thái GCKCastSession
, trạng thái phát từ xa và việc đó có phải là sự kiện phát trực tiếp hay không. Mục tiêu cũng được thêm vào UIControl
để ghi lại sự kiện UIControlEventTouchUpInside
. Không thêm mục tiêu thuộc loại này trên UIControl
. Thay vào đó, để ghi lại sự kiện này, hãy sử dụng các phương thức GCKUIMediaControllerDelegate
.
- Parameters
-
control The UI element that the user interacts with. Typically this would be an instance of UIButton
.forwardSeconds The number of seconds to skip the media.
- (void) unbindView: | (UIView *) | view |
Huỷ liên kết khung hiển thị đã chỉ định.
- Parameters
-
view The view to unbind.
- (void) unbindAllViews |
Huỷ liên kết tất cả khung hiển thị 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ả bóng
- 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 chọn bản nhạc đa phương tiện.
- (void) skipAd |
Gửi và theo dõi yêu cầu bỏ qua quảng cáo.
- Năm thành lập
- 4,3
Chi tiết về cơ sở lưu trú
|
readwritenonatomicweak |
Thực thể đại diện để nhận thông báo từ GCKUIMediaController.
|
readnonatomicstrong |
Phiên được liên kết với bộ điều khiển này.
|
readnonatomicassign |
Liệu có phương tiện nào đang được tải (hoặc đang tải) trên bộ thu không.
Nếu không có phiên truyền nào đang hoạt động, giá trị này sẽ là NO
.
|
readnonatomicassign |
Liệu có mục hiện tại trong hàng đợi hay không.
|
readnonatomicassign |
Liệu có mục nào đang được tải trước trong hàng đợi hay không.
|
readnonatomicassign |
Trạng thái trình phát nội dung đa phương tiện đã biết mới nhất.
Nếu không có phiên Truyền nào đang hoạt động, đây sẽ là trạng thái trình phát ngay trước khi phiên cuối cùng kết thúc. Nếu không có phiên nào trước đó, giá trị này sẽ là GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
Vị trí luồng nội dung đa phương tiện đã biết mới nhất.
Nếu không có phiên Truyền nào đang hoạt động, đây sẽ là vị trí phát trực tuyến của nội dung nghe nhìn ngay trước khi phiên cuối cùng kết thúc. Nếu không có phiên nào trước đó, giá sẽ là kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
Nút "phát".
Khi người dùng nhấn vào nút này, nội dung nghe nhìn hiện đã tải sẽ bắt đầu hoặc được tiếp tục trên bộ thu. Nút này sẽ bị tắt nếu đang phát, nếu nội dung nghe nhìn hiện chưa tải hoặc nếu không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Nút "tạm dừng".
Khi người dùng nhấn vào nút này, việc phát nội dung nghe nhìn hiện đã tải sẽ tạm dừng trên bộ thu. Nút này sẽ bị tắt nếu nội dung nghe nhìn đang tải không hỗ trợ tính năng tạm dừng, hoặc nếu quá trình phát hiện không diễn ra, 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 đang hoạt động.
|
readwritenonatomicweak |
Nút bật tắt "phát/tạm dừng".
Phương thức gọi phải đặt các biểu tượng thích hợp cho trạng thái nút GCKUIButtonStatePlay, GCKUIButtonStatePlayLive và GCKUIButtonStatePause của nút, cụ thể là biểu tượng "tạm dừng" cho trạng thái phát, biểu tượng "dừng" cho trạng thái phát trực tiếp và biểu tượng "phát" cho trạng thái tạm dừng. Trạng thái của nút được 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 này, việc phát nội dung nghe nhìn đang tải sẽ tạm dừng hoặc đượ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ính năng tạm dừng, hoặc nếu quá trình phát hiện không diễn ra hoặc đang tạm dừng, hoặc nếu chưa 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.
|
readwritenonatomicstrong |
Bộ điều khiển bật/tắt "phát/tạm dừng".
Được dùng làm nút độc lập cho giao diện người dùng bật/tắt tính năng phát/tạm dừng tuỳ chỉnh do ứng dụng cung cấp. Hãy xem GCKUIPlayPauseToggleController để biết chi tiết.
- Năm thành lập
- 3,4
|
readwritenonatomicweak |
Nút "dừng".
Khi người dùng nhấn vào nút này, việc phát nội dung nghe nhìn hiện đã tải sẽ dừng trên bộ thu. Nút này sẽ bị tắt nếu nội dung nghe nhìn hiện không tải hoặc nếu không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Nút để tua đi 30 giây trong mục nội dung nghe nhìn đang phát.
Nút này sẽ bị tắt nếu nội dung nghe nhìn hiện không tải hoặc nếu không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Nút để tua lại 30 giây trong mục nội dung đa phương tiện hiện đang phát.
Nút này sẽ bị tắt nếu nội dung nghe nhìn hiện không tải hoặc nếu không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Nút để tạm dừng phát trong danh sách chờ sau khi phát xong mục hiện tại.
|
readwritenonatomicweak |
Nút "tiếp theo".
Khi người dùng nhấn vào nút này, nội dung phát sẽ 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 nếu hiện chưa tải nội dung nghe nhìn nào hoặc nếu không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Nút "trước".
Khi người dùng nhấn vào nút này, nội dung phát 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 nếu hiện chưa tải nội dung nghe nhìn nào hoặc nếu không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Một nút để chuyển qua các chế độ lặp lại của hàng đợi hiện có.
(Hãy xem GCKMediaRepeatMode.) Phương thức gọi nên đặt biểu tượng thích hợp cho trạng thái nút GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll và GCKUIButtonStateShuffle của nút. Trạng thái của nút được tự động cập nhật để phản ánh chế độ lặp lại trong hàng đợi hiện tại trên bộ thu. Thao tác 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 không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Thanh trượt để hiển thị và thay đổi vị trí phát trực tiếp hiện tại.
Khi người dùng thay đổi giá trị của thanh trượt, vị trí phát trực tuyến của nội dung nghe nhìn hiện đã tải sẽ được cập nhật trên bộ thu. Trong khi đang phát nội dung nghe nhìn trên thiết bị nhận, giá trị của thanh trượt sẽ được cập nhật theo thời gian thực để phản ánh vị trí phát trực tuyến hiện tại. Thanh trượt sẽ bị tắt nếu nội dung nghe nhìn đang tải không hỗ trợ tính năng tìm kiếm, hoặc nếu chưa 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.
|
readwritenonatomicweak |
Khung hiển thị để hiển thị tiến trình phát trực tuyến hiện tại.
Trong khi đang phát nội dung đa phương tiện trên thiết bị nhận, giá trị của lượt xem được cập nhật theo thời gian thực để phản ánh vị trí phát trực tuyến hiện tại. Chế độ xem sẽ bị tắt nếu nội dung nghe nhìn đang tải là nội dung phát trực tiếp, hoặc nếu chưa có nội dung nghe nhìn nào được tải hoặc không có phiên Truyền nào đang hoạt động.
|
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 hoá.
|
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 đang tải không có thời lượng (ví dụ: nếu là nội dung phát trực tiếp), hoặc nếu nội dung đa phương tiện hiện không đượ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 hoá.
|
readwritenonatomicweak |
Nhãn hiển thị thời gian phát trực tiếp còn lại (thời lượng trừ đi vị trí), tính bằng phút và giây.
Nếu nội dung nghe nhìn đang tải không có thời lượng (ví dụ: nếu là nội dung phát trực tiếp), hoặc nếu nội dung đa phương tiện hiện không đượ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 hoá.
|
readwritenonatomicstrong |
Bộ điều khiển vị trí luồng.
Được dùng làm vị trí dự phòng cho một vị trí luồng tuỳ chỉnh, do ứng dụng cung cấp và/hoặc giao diện người dùng tìm kiếm. Hãy xem GCKUIStreamPositionController để biết chi tiết.
- Năm thành lập
- 3,4
|
readwritenonatomicstrong |
Trình kiểm soát tốc độ phát của sự kiện phát trực tiếp.
Hãy xem GCKUIPlaybackRateController để biết chi tiết.
- Năm thành lập
- 4
|
readwritenonatomicassign |
Thời gian phát trực tiếp 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
.
|
readwritenonatomicassign |
Liệu các nút điều khiển vị trí sự kiện phát trực tiếp (bao gồm cả thanh trượt vị trí sự kiện phát trực tiếp, nhãn vị trí sự kiện phát trực tiếp, nhãn thời lượng sự kiện phát trực tiếp và chế độ xem tiến trình phát trực tiếp) có bị ẩn đối với nội dung phát trực tiếp hay không.
Giá trị mặc định là NO
.
- Năm thành lập
- 4
|
readwritenonatomicweak |
Nút để chọn 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 lựa chọn bản nhạc đa phương tiện sẽ hiển thị. Nút này sẽ bị tắt nếu nội dung nghe nhìn đã tải hiện không có bản nội dung nghe nhìn nào có thể chọn, hoặc nếu hiện chưa tải nội dung nghe nhìn nào hoặc nếu không có phiên Truyền nào đang hoạt động.
|
readwritenonatomicweak |
Một nhãn để hiển thị phụ đề cho nội dung nghe nhìn đang tải.
Nếu không có trường phụ đề nào được thiết lập rõ ràng trong siêu dữ liệu, thì hãng thu âm sẽ hiển thị trường siêu dữ liệu phù hợp nhất dựa trên loại nội dung đa phương tiện, chẳng hạn như tên phòng thu của một bộ phim hoặc tên nghệ sĩ của một bản nhạc.
|
readwritenonatomicweak |
Một khung hiển thị chỉ báo hoạt động để cho biết rằng nội dung nghe nhìn đang ở trạng thái tải.
|
readwritenonatomicweak |
Nhãn hiển thị khoảng thời gian còn lại cho đến khi có thể bỏ qua quảng cáo.
- Năm thành lập
- 4,3
|
readwritenonatomicweak |
Nút để bỏ qua quảng cáo hiện tại.
- Năm thành lập
- 4,3