Tổng quan
Một bộ điều khiển cho các khung hiển thị 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 một 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 bộ điều khiển bằng cách thiết lập 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 chế độ điều khiển bằng cách gửi các lệnh thích hợp về nội dung nghe nhìn đến bộ 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 nội dung nghe nhìn nhận được từ bộ nhận. Bộ điều khiển sẽ 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 hiện tại và trạng thái của trình phát nội dung nghe nhìn. Ngoài ra, chế độ này còn vô hiệu hoá tất cả các chế độ kiểm soát trong khi yêu cầu đang được xử lý.
Hãy xem GCKUIMediaControllerDelegate để biết giao thức uỷ quyền.
- Năm thành lập
- 3.0
Kế thừa NSObject.
Tóm tắt phương thức của thực thể | |
| (instancetype) | - init |
| Khởi chạy một thực thể. Tuỳ chọn khác... | |
| (void) | - bindLabel:toMetadataKey: |
| Liên kết một UILabel với một khoá siêu dữ liệu. Tuỳ chọn khác... | |
| (void) | - bindLabel:toMetadataKey:withFormatter: |
| Liên kết một UILabel với một khoá siêu dữ liệu. Tuỳ chọn khác... | |
| (void) | - bindTextView:toMetadataKey: |
| Liên kết một UITextView với một khoá siêu dữ liệu. Tuỳ chọn khác... | |
| (void) | - bindTextView:toMetadataKey:withFormatter: |
| Liên kết một UITextView với một khoá siêu dữ liệu. Tuỳ chọn khác... | |
| (void) | - bindImageView:toImageHints: |
| Liên kết một UIImageView với một thực thể GCKUIImageHints. Tuỳ chọn khác... | |
| (void) | - unbindView: |
| Huỷ liên kết chế độ xem đã chỉ định. Tuỳ chọn khác... | |
| (void) | - unbindAllViews |
| Huỷ liên kết tất cả các khung hiển thị được liên kết. Tuỳ chọn khác... | |
| (GCKMediaRepeatMode) | - cycleRepeatMode |
| Thay đổi chế độ lặp lại của danh sách phát sang chế độ tiếp theo trong chu kỳ: Tuỳ chọn khác... | |
| (void) | - selectTracks |
| Một phương thức thuận tiện để hiển thị giao diện người dùng chọn phụ đề. Tuỳ chọn khác... | |
Tóm tắt về tài sản | |
| id< GCKUIMediaControllerDelegate > | delegate |
| Uỷ quyền nhận thông báo từ GCKUIMediaController. Tuỳ chọn khác... | |
| GCKSession * | session |
| Phiên được liên kết với bộ điều khiển này. Tuỳ chọn khác... | |
| BOOL | mediaLoaded |
| Có nội dung nghe nhìn hiện đang được tải (hoặc đang tải) trên thiết bị nhận hay không. Tuỳ chọn khác... | |
| BOOL | hasCurrentQueueItem |
| Có mục nào trong hàng đợi hay không. Tuỳ chọn khác... | |
| BOOL | hasLoadingQueueItem |
| Có mục nào đang được tải trước trong hàng đợi hay không. Tuỳ chọn khác... | |
| GCKMediaPlayerState | lastKnownPlayerState |
| Trạng thái gần đây nhất của trình phát nội dung nghe nhìn. Tuỳ chọn khác... | |
| NSTimeInterval | lastKnownStreamPosition |
| Vị trí luồng nội dung nghe nhìn đã biết gần đây nhất. Tuỳ chọn khác... | |
| UIButton * | playButton |
| Nút "phát". Tuỳ chọn khác... | |
| UIButton * | pauseButton |
| Nút "tạm dừng". Tuỳ chọn khác... | |
| GCKUIButton * | playPauseToggleButton |
| Nút bật/tắt "phát/tạm dừng". Tuỳ chọn khác... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| Một bộ điều khiển có nút "phát/tạm dừng". Tuỳ chọn khác... | |
| UIButton * | stopButton |
| Nút "dừng". Tuỳ chọn khác... | |
| GCKUIButton * | forward30SecondsButton |
| Nút tua đi 30 giây trong mục nội dung nghe nhìn đang phát. Tuỳ chọn khác... | |
| GCKUIButton * | rewind30SecondsButton |
| Nút tua lại 30 giây trong mục nội dung nghe nhìn đang phát. Tuỳ chọn khác... | |
| UIButton * | pauseQueueButton |
| Nút tạm dừng phát danh sách phát sau khi mục hiện tại phát xong. Tuỳ chọn khác... | |
| UIButton * | nextButton |
| Nút "tiếp theo". Tuỳ chọn khác... | |
| UIButton * | previousButton |
| Nút "trước". Tuỳ chọn khác... | |
| GCKUIButton * | repeatModeButton |
| Một nút để chuyển đổi giữa các chế độ lặp lại hàng đợi hiện có. Tuỳ chọn khác... | |
| UISlider * | streamPositionSlider |
| Một thanh trượt để hiển thị và thay đổi vị trí hiện tại của luồng phát. Tuỳ chọn khác... | |
| UIProgressView * | streamProgressView |
| Một khung hiển thị để cho biết tiến trình phát trực tiếp hiện tại. Tuỳ chọn khác... | |
| UILabel * | streamPositionLabel |
| Nhãn để hiển thị vị trí hiện tại của luồng, tính bằng phút và giây. Tuỳ chọn khác... | |
| 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. Tuỳ chọn khác... | |
| 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ừ đi vị trí), tính bằng phút và giây. Tuỳ chọn khác... | |
| GCKUIStreamPositionController * | streamPositionController |
| Bộ điều khiển vị trí luồng. Tuỳ chọn khác... | |
| BOOL | displayTimeRemainingAsNegativeValue |
| Liệu thời gian phát trực tiếp còn lại sẽ hiển thị dưới dạng giá trị âm hay không, ví dụ: "-1:23:45". Tuỳ chọn khác... | |
| UIButton * | tracksButton |
| Một nút để chọn bản âm thanh và/hoặc phụ đề hoặc phụ đề chi tiết. Tuỳ chọn khác... | |
| UILabel * | smartSubtitleLabel |
| Nhãn để hiển thị phụ đề cho nội dung nghe nhìn hiện đang được tải. Tuỳ chọn khác... | |
| 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. Tuỳ chọn khác... | |
Thông tin chi tiết về phương thức
| - (instancetype) init |
Khởi chạy một thực thể.
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
Liên kết một UILabel với một khoá siêu dữ liệu.
Chế độ xem này sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.
Hãy xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu được 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 một UILabel với một khoá siêu dữ liệu.
Chế độ xem này sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.
Hãy xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu được 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 một UITextView với một khoá siêu dữ liệu.
Chế độ xem này sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.
Hãy xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu được 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 một UITextView với một khoá siêu dữ liệu.
Chế độ xem này sẽ hiển thị giá trị hiện tại của trường siêu dữ liệu tương ứng.
Hãy xem GCKMediaMetadata để biết danh sách các khoá siêu dữ liệu được 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 một UIImageView với một thực thể GCKUIImageHints.
UIImagePicker 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) 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 khung hiển thị được liên kết.
| - (GCKMediaRepeatMode) cycleRepeatMode |
Thay đổi chế độ lặp lại của hàng đợi thành chế độ tiếp theo trong chu kỳ:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- Giá trị 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 chọn phụ đề.
Thông tin chi tiết về cơ sở lưu trú
|
readwritenonatomicweak |
Uỷ quyề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 |
Có nội dung nghe nhìn hiện đang được tải (hoặc đang tải) trên thiết bị nhận hay không.
Nếu không có phiên truyền nào đang hoạt động, thì giá trị này sẽ là NO.
|
readnonatomicassign |
Có mục nào trong hàng đợi hay không.
|
readnonatomicassign |
Có mục nào đang được tải trước trong hàng đợi hay không.
|
readnonatomicassign |
Trạng thái gần đây nhất của trình phát nội dung nghe nhìn.
Nếu không có phiên truyền nào đang hoạt động, thì đây sẽ là trạng thái của trình phát ngay trước khi phiên truyền gần đây nhất kết thúc. Nếu không có phiên trước đó, thì giá trị này sẽ là GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
Vị trí luồng nội dung nghe nhìn đã biết gần đây nhất.
Nếu không có phiên truyền nào đang hoạt động, thì đâ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 gần đây nhất kết thúc. Nếu không có phiên trước đó, thì giá trị này sẽ là kGCKInvalidTimeInterval.
|
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 được tải sẽ bắt đầu hoặc tiếp tục trên thiết bị nhận. Nút này sẽ bị vô hiệu hoá nếu quá trình phát đang diễn ra, 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 đang hoạt động.
|
readwritenonatomicweak |
Nút "tạm dừng".
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 được tải sẽ tạm dừng trên thiết bị nhận. Nút này sẽ bị vô hiệu hoá nếu nội dung nghe nhìn hiện đang được 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 đang đượ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 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 thiết bị nhận. 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 được tải sẽ tạm dừng hoặc tiếp tục trên thiết bị nhận. Nút này sẽ bị vô hiệu hoá nếu nội dung nghe nhìn hiện đang được 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 bị tạm dừng, 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 đang hoạt động.
|
readwritenonatomicstrong |
Một bộ điều khiển có nút "phát/tạm dừng".
Được dùng làm phần thay thế cho giao diện người dùng bật/tắt 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, quá trình phát nội dung nghe nhìn hiện đang được tải sẽ dừng trên thiết bị nhận. Nút này sẽ bị vô hiệu hoá 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 đ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ị vô hiệu hoá 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 đang hoạt động.
|
readwritenonatomicweak |
Nút tua lại 30 giây trong mục nội dung nghe nhìn đang phát.
Nút này sẽ bị vô hiệu hoá 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 đang hoạt động.
|
readwritenonatomicweak |
Nút tạm dừng phát danh sách phát sau khi mục hiện tại phát xong.
|
readwritenonatomicweak |
Nút "tiếp theo".
Khi người dùng nhấn vào nút này, chế độ phát sẽ chuyển sang mục nội dung nghe nhìn tiếp theo trong hàng đợi. Nút này sẽ bị vô hiệu hoá nếu thao tác không được hỗ trợ, 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 đang hoạt động.
|
readwritenonatomicweak |
Nút "trước".
Khi người dùng nhấn vào nút này, chế độ phát sẽ chuyển sang mục nội dung nghe nhìn trước đó trong hàng đợi. Nút này sẽ bị vô hiệu hoá nếu thao tác không được hỗ trợ, 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 đang hoạt động.
|
readwritenonatomicweak |
Một nút để chuyển đổi giữa các chế độ lặp lại hàng đợi hiện có.
(Xem GCKMediaRepeatMode.) Phương thức gọi phải đặt các biểu tượng thích hợp cho trạng thái UIControlStateNormal (tắt chế độ lặp lại), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll và GCKUIControlStateShuffle của nút. Trạng thái của nút này sẽ tự động cập nhật để phản ánh chế độ lặp lại hàng đợi hiện tại trên thiết bị nhận. Khi bạn nhấn vào nút này, chế độ lặp lại sẽ chuyển sang chế độ tiếp theo theo thứ tự:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
Nút này sẽ bị vô hiệu hoá nếu hiện không có phiên truyền nào đang hoạt động.
|
readwritenonatomicweak |
Một thanh trượt để hiển thị và thay đổi vị trí hiện tại của luồng phát.
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 đang được tải sẽ được cập nhật trên thiết bị nhận. Trong khi quá trình phát nội dung nghe nhìn đang diễn ra trên 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í hiện tại của luồng. Thanh trượt sẽ bị vô hiệu hoá nếu nội dung nghe nhìn hiện đang tải không hỗ trợ tính năng tìm kiếm, hoặc nếu không có nội dung nghe nhìn nào đang tải, hoặc nếu không có phiên truyền nào đang hoạt động.
|
readwritenonatomicweak |
Một khung hiển thị để cho biết tiến trình phát trực tiếp hiện tại.
Trong khi nội dung nghe nhìn đang phát trên receiver, giá trị của khung hiển thị sẽ được cập nhật theo thời gian thực để phản ánh vị trí hiện tại của luồng phát. Chế độ xem này sẽ bị tắt nếu nội dung nghe nhìn hiện đang được tải là một sự kiện phát trực tiếp, hoặc nếu không có nội dung nghe nhìn nào đang được tải, hoặc nếu không có phiên truyền nào đang hoạt động.
|
readwritenonatomicweak |
Nhãn để hiển thị vị trí hiện tại của luồng, 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 hiện 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á của "--:--".
|
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 đang được tải không có thời lượng (ví dụ: nếu đó là một luồng phát trực tiếp), hoặc nếu không có nội dung nghe nhìn nào đang đượ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ị một dạng bản địa hoá của "--:--".
|
readwritenonatomicweak |
Nhãn để hiển thị thời gian phát trực tuyến 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 hiện đang được tải không có thời lượng (ví dụ: nếu đó là một luồng phát trực tiếp), hoặc nếu không có nội dung nghe nhìn nào đang đượ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ị một dạng bản địa hoá của "--:--".
|
readwritenonatomicstrong |
Bộ điều khiển vị trí luồng.
Được dùng làm vị trí thay thế cho vị trí phát trực tuyến và/hoặc giao diện người dùng tìm kiếm do ứng dụng tuỳ chỉnh cung cấp. Hãy xem GCKUIStreamPositionController để biết chi tiết.
- Năm thành lập
- 3.4
|
readwritenonatomicassign |
Liệu thời gian phát trực tiếp còn lại sẽ 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.
|
readwritenonatomicweak |
Một nút để chọn bản âm thanh và/hoặc phụ đề hoặc phụ đề chi tiết.
Khi người dùng nhấn vào nút này, giao diện người dùng chọn phụ đề/phụ đề sẽ xuất hiện. Nút này sẽ bị vô hiệu hoá nếu nội dung nghe nhìn hiện đang tải không có bất kỳ bản phụ đề nào có thể chọn, hoặc nếu không có nội dung nghe nhìn nào đang tải, hoặc nếu không có phiên truyền nào đang hoạt động.
|
readwritenonatomicweak |
Nhãn để hiển thị phụ đề cho nội dung nghe nhìn hiện đang được tải.
Nếu bạn không đặt rõ ràng trường phụ đề 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 nội dung nghe nhìn, ví dụ: tên hãng phim đối với phim hoặc tên nghệ sĩ đối với bản nhạc.
|
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.