Ringkasan
Pengontrol untuk tampilan UI yang digunakan untuk mengontrol atau menampilkan status pemutaran media pada penerima Cast.
Aplikasi panggilan mendaftarkan kontrol UI terkait media dengan pengontrol dengan menyetel properti yang sesuai. Pengontrol kemudian merespons kejadian sentuh pada kontrol dengan mengeluarkan perintah media yang sesuai kepada penerima, dan memperbarui kontrol berdasarkan informasi status dan metadata media yang diterima dari penerima. Pengontrol secara otomatis mengaktifkan dan menonaktifkan kontrol UI yang sesuai untuk sesi dan status pemutar media saat ini. Selain itu, kode ini juga menonaktifkan semua kontrol saat permintaan sedang berlangsung.
Lihat GCKUIMediaControllerDelegate untuk protokol delegasi.
- Sejak
- 3,0
Mewarisi NSObject.
Ringkasan Metode Instance | |
(instancetype) | - init |
Menginisialisasi instance. Lainnya... | |
(void) | - bindLabel:toMetadataKey: |
Mengikat UILabel ke kunci metadata. Lainnya... | |
(void) | - bindLabel:toMetadataKey:withFormatter: |
Mengikat UILabel ke kunci metadata. Lainnya... | |
(void) | - bindTextView:toMetadataKey: |
Mengikat UITextView ke kunci metadata. Lainnya... | |
(void) | - bindTextView:toMetadataKey:withFormatter: |
Mengikat UITextView ke kunci metadata. Lainnya... | |
(void) | - bindImageView:toImageHints: |
Mengikat UIImageView ke instance GCKUIImageHints. Lainnya... | |
(void) | - bindControlView:toRewindForTime: |
Mengikat UIControl untuk memundurkan pemutaran item saat ini dengan nilai yang diteruskan sebagai detik. Lainnya... | |
(void) | - bindControlView:toForwardForTime: |
Mengikat UIControl untuk meneruskan pemutaran item saat ini dengan nilai yang diteruskan sebagai detik. Lainnya... | |
(void) | - unbindView: |
Melepaskan tampilan yang ditentukan. Lainnya... | |
(void) | - unbindAllViews |
Melepaskan semua tampilan terikat. Lainnya... | |
(GCKMediaRepeatMode) | - cycleRepeatMode |
Mengubah mode berulang untuk antrean ke mode berikutnya dalam siklus: Lainnya... | |
(void) | - selectTracks |
Metode praktis untuk menampilkan UI pemilihan trek media. Lainnya... | |
(void) | - skipAd |
Mengirim dan memantau permintaan lewati iklan. Lainnya... | |
Ringkasan Properti | |
id< GCKUIMediaControllerDelegate > | delegate |
Delegasi untuk menerima notifikasi dari GCKUIMediaController. Lainnya... | |
GCKSession * | session |
Sesi yang terkait dengan pengontrol ini. Lainnya... | |
BOOL | mediaLoaded |
Apakah ada media yang saat ini dimuat (atau dimuat) di penerima. Lainnya... | |
BOOL | hasCurrentQueueItem |
Apakah ada item saat ini dalam antrean. Lainnya... | |
BOOL | hasLoadingQueueItem |
Apakah ada item yang dipramuat dalam antrean. Lainnya... | |
GCKMediaPlayerState | lastKnownPlayerState |
Status pemutar media terbaru yang diketahui. Lainnya... | |
NSTimeInterval | lastKnownStreamPosition |
Posisi streaming media terbaru yang diketahui. Lainnya... | |
UIButton * | playButton |
Tombol "putar". Lainnya... | |
UIButton * | pauseButton |
Tombol "jeda". Lainnya... | |
GCKUIMultistateButton * | playPauseToggleButton |
Tombol "putar/jeda". Lainnya... | |
GCKUIPlayPauseToggleController * | playPauseToggleController |
Pengontrol tombol "putar/jeda". Lainnya... | |
UIButton * | stopButton |
Tombol "berhenti". Lainnya... | |
UIButton * | forward30SecondsButton |
Tombol untuk mencari 30 detik ke depan di item media yang sedang diputar. Lainnya... | |
UIButton * | rewind30SecondsButton |
Tombol untuk mencari 30 detik mundur di item media yang sedang diputar. Lainnya... | |
UIButton * | pauseQueueButton |
Tombol untuk menjeda pemutaran antrean setelah item saat ini selesai diputar. Lainnya... | |
UIButton * | nextButton |
Tombol "berikutnya". Lainnya... | |
UIButton * | previousButton |
Tombol "sebelumnya". Lainnya... | |
GCKUIMultistateButton * | repeatModeButton |
Tombol untuk bersepeda melalui mode pengulangan antrean yang tersedia. Lainnya... | |
UISlider * | streamPositionSlider |
Penggeser untuk menampilkan dan mengubah posisi streaming saat ini. Lainnya... | |
UIProgressView * | streamProgressView |
Tampilan untuk menampilkan progres streaming saat ini. Lainnya... | |
UILabel * | streamPositionLabel |
Label untuk menampilkan posisi streaming saat ini, dalam menit dan detik. Lainnya... | |
UILabel * | streamDurationLabel |
Label untuk menampilkan durasi streaming saat ini, dalam menit dan detik. Lainnya... | |
UILabel * | streamTimeRemainingLabel |
Label untuk menampilkan waktu streaming yang tersisa (durasi dikurangi posisi), dalam menit dan detik. Lainnya... | |
GCKUIStreamPositionController * | streamPositionController |
Pengontrol posisi aliran data. Lainnya... | |
GCKUIPlaybackRateController * | playbackRateController |
Pengontrol kecepatan pemutaran streaming. Lainnya... | |
BOOL | displayTimeRemainingAsNegativeValue |
Apakah sisa waktu streaming akan ditampilkan sebagai nilai negatif, misalnya, "-1:23:45". Lainnya... | |
BOOL | hideStreamPositionControlsForLiveContent |
Apakah kontrol posisi streaming (termasuk penggeser posisi streaming, label posisi streaming, label durasi streaming, dan tampilan progres streaming) harus disembunyikan dari konten live. Lainnya... | |
UIButton * | tracksButton |
Tombol untuk memilih trek audio dan/atau teks tertutup atau subtitel. Lainnya... | |
UILabel * | smartSubtitleLabel |
Label untuk menampilkan subtitel dari media yang sedang dimuat. Lainnya... | |
UIActivityIndicatorView * | mediaLoadingIndicator |
Tampilan indikator aktivitas untuk menunjukkan bahwa media sedang dalam status pemuatan. Lainnya... | |
UILabel * | skipAdLabel |
Label untuk menampilkan sisa waktu hingga iklan dapat dilewati. Lainnya... | |
UIButton * | skipAdButton |
Tombol untuk melewati iklan saat ini. Lainnya... | |
Detail Metode
- (instancetype) init |
Menginisialisasi instance.
- (void) bindLabel: | (UILabel *) | label | |
toMetadataKey: | (NSString *) | key | |
Mengikat UILabel ke kunci metadata.
Tampilan ini akan menampilkan nilai kolom metadata yang sesuai saat ini.
Buka GCKMediaMetadata untuk melihat daftar kunci metadata yang telah ditentukan.
- Parameters
-
label The UILabel that will display the value. key The metadata key.
- (void) bindLabel: | (UILabel *) | label | |
toMetadataKey: | (NSString *) | key | |
withFormatter: | (GCKUIValueFormatter) | formatter | |
Mengikat UILabel ke kunci metadata.
Tampilan ini akan menampilkan nilai kolom metadata yang sesuai saat ini.
Buka GCKMediaMetadata untuk melihat daftar kunci metadata yang telah ditentukan.
- 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 | |
Mengikat UITextView ke kunci metadata.
Tampilan ini akan menampilkan nilai kolom metadata yang sesuai saat ini.
Buka GCKMediaMetadata untuk melihat daftar kunci metadata yang telah ditentukan.
- Parameters
-
textView The UITextView that will display the value. key The metadata key.
- (void) bindTextView: | (UITextView *) | textView | |
toMetadataKey: | (NSString *) | key | |
withFormatter: | (GCKUIValueFormatter) | formatter | |
Mengikat UITextView ke kunci metadata.
Tampilan ini akan menampilkan nilai kolom metadata yang sesuai saat ini.
Buka GCKMediaMetadata untuk melihat daftar kunci metadata yang telah ditentukan.
- 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 | |
Mengikat UIImageView ke instance GCKUIImageHints.
GCKUIImagePicker yang saat ini terinstal akan digunakan untuk memilih gambar dari metadata tampilan.
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
- (void) bindControlView: | (UIControl *) | control | |
toRewindForTime: | (NSTimeInterval) | rewindSeconds | |
Mengikat UIControl
untuk memundurkan pemutaran item saat ini dengan nilai yang diteruskan sebagai detik.
Tampilan akan diperbarui berdasarkan status GCKCastSession
, status pemutaran jarak jauh, dan apakah ini merupakan livestream. Target juga ditambahkan ke UIControl
untuk mendapatkan peristiwa UIControlEventTouchUpInside
. Jangan tambahkan target jenis ini di UIControl
. Untuk mencatat peristiwa, gunakan metode 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 | |
Mengikat UIControl
untuk meneruskan pemutaran item saat ini dengan nilai yang diteruskan sebagai detik.
Tampilan akan diperbarui berdasarkan status GCKCastSession
, status pemutaran jarak jauh, dan apakah ini merupakan livestream. Target juga ditambahkan ke UIControl
untuk mendapatkan peristiwa UIControlEventTouchUpInside
. Jangan tambahkan target jenis ini di UIControl
. Untuk mencatat peristiwa, gunakan metode 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 |
Melepaskan tampilan yang ditentukan.
- Parameters
-
view The view to unbind.
- (void) unbindAllViews |
Melepaskan semua tampilan terikat.
- (GCKMediaRepeatMode) cycleRepeatMode |
Mengubah mode berulang untuk antrean ke mode berikutnya dalam siklus:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- Hasil
- Mode pengulangan baru.
- (void) selectTracks |
Metode praktis untuk menampilkan UI pemilihan trek media.
- (void) skipAd |
Mengirim dan memantau permintaan lewati iklan.
- Sejak
- 4,3
Detail Properti
|
readwritenonatomicweak |
Delegasi untuk menerima notifikasi dari GCKUIMediaController.
|
readnonatomicstrong |
Sesi yang terkait dengan pengontrol ini.
|
readnonatomicassign |
Apakah ada media yang saat ini dimuat (atau dimuat) di penerima.
Jika tidak ada sesi Transmisi yang aktif, ini akan menjadi NO
.
|
readnonatomicassign |
Apakah ada item saat ini dalam antrean.
|
readnonatomicassign |
Apakah ada item yang dipramuat dalam antrean.
|
readnonatomicassign |
Status pemutar media terbaru yang diketahui.
Jika tidak ada sesi Transmisi yang aktif, ini akan menjadi status pemutar tepat sebelum sesi terakhir berakhir. Jika tidak ada sesi sebelumnya, ini akan menjadi GCKMediaPlayerStateUnknown.
|
readnonatomicassign |
Posisi streaming media terbaru yang diketahui.
Jika tidak ada sesi Transmisi yang aktif, ini akan menjadi posisi streaming media tepat sebelum sesi terakhir berakhir. Jika tidak ada sesi sebelumnya, jumlah ini akan menjadi kGCKInvalidTimeInterval.
|
readwritenonatomicweak |
Tombol "putar".
Saat tombol diketuk, pemutaran media yang saat ini dimuat akan dimulai atau dilanjutkan di penerima. Tombol ini akan dinonaktifkan jika pemutaran sedang berlangsung, atau jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tombol "jeda".
Saat tombol diketuk, pemutaran media yang saat ini dimuat akan dijeda di penerima. Tombol ini akan dinonaktifkan jika media yang saat ini dimuat tidak mendukung jeda, atau jika pemutaran sedang tidak berlangsung, atau jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tombol "putar/jeda".
Pemanggil harus menetapkan ikon yang sesuai untuk status tombol GCKUIButtonStatePlay, GCKUIButtonStatePlayLive, dan GCKUIButtonStatePause, yaitu, ikon "jeda" untuk status putar, ikon "berhenti" untuk status putar-langsung, dan ikon "putar" untuk status jeda. Status tombol otomatis diperbarui untuk mencerminkan status pemutaran saat ini pada penerima. Saat tombol diketuk, pemutaran media yang sedang dimuat akan dijeda atau dilanjutkan di penerima. Tombol ini akan dinonaktifkan jika media yang saat ini dimuat tidak mendukung jeda, atau jika pemutaran tidak sedang berlangsung atau dijeda, atau jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicstrong |
Pengontrol tombol "putar/jeda".
Digunakan sebagai pengganti untuk UI tombol putar/jeda kustom yang disediakan aplikasi. Lihat GCKUIPlayPauseToggleController untuk detailnya.
- Sejak
- 3,4
|
readwritenonatomicweak |
Tombol "berhenti".
Saat tombol diketuk, pemutaran media yang saat ini dimuat akan dihentikan di penerima. Tombol akan dinonaktifkan jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tombol untuk mencari 30 detik ke depan di item media yang sedang diputar.
Tombol akan dinonaktifkan jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tombol untuk mencari 30 detik mundur di item media yang sedang diputar.
Tombol akan dinonaktifkan jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tombol untuk menjeda pemutaran antrean setelah item saat ini selesai diputar.
|
readwritenonatomicweak |
Tombol "berikutnya".
Saat tombol diketuk, pemutaran akan berpindah ke item media berikutnya dalam antrean. Tombol ini akan dinonaktifkan jika operasinya tidak didukung, atau jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tombol "sebelumnya".
Saat tombol diketuk, pemutaran akan berpindah ke item media sebelumnya dalam antrean. Tombol ini akan dinonaktifkan jika operasinya tidak didukung, atau jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tombol untuk bersepeda melalui mode pengulangan antrean yang tersedia.
(Lihat GCKMediaRepeatMode.) Pemanggil harus menyetel ikon yang sesuai untuk status tombol GCKUIButtonStateRepeatOff, GCKUIButtonStateRepeatSingle, GCKUIButtonStateRepeatAll, dan GCKUIButtonStateShuffle tombol. Status tombol secara otomatis diperbarui untuk mencerminkan mode pengulangan antrean saat ini pada penerima. Mengetuk siklus tombol akan beralih ke mode berulang berikutnya, dalam urutan:
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
Tombol akan dinonaktifkan jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Penggeser untuk menampilkan dan mengubah posisi streaming saat ini.
Saat nilai penggeser diubah oleh pengguna, posisi streaming media yang saat ini dimuat akan diperbarui di penerima. Saat pemutaran media sedang berlangsung di penerima, nilai penggeser akan diperbarui secara real time untuk mencerminkan posisi streaming saat ini. Penggeser akan dinonaktifkan jika media yang saat ini dimuat tidak mendukung pencarian, atau jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Tampilan untuk menampilkan progres streaming saat ini.
Saat pemutaran media sedang berlangsung di penerima, nilai penayangan diperbarui secara real time untuk mencerminkan posisi streaming saat ini. Tampilan akan dinonaktifkan jika media yang saat ini dimuat adalah live stream, atau jika tidak ada media yang saat ini dimuat, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Label untuk menampilkan posisi streaming saat ini, dalam menit dan detik.
Jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang aktif, label akan menampilkan bentuk "--:--" yang dilokalkan.
|
readwritenonatomicweak |
Label untuk menampilkan durasi streaming saat ini, dalam menit dan detik.
Jika media yang saat ini dimuat tidak memiliki durasi (misalnya, jika merupakan live stream), atau jika tidak ada media yang saat ini dimuat, atau jika tidak ada sesi Transmisi yang sedang aktif, label akan menampilkan bentuk yang dilokalkan untuk "--:--".
|
readwritenonatomicweak |
Label untuk menampilkan waktu streaming yang tersisa (durasi dikurangi posisi), dalam menit dan detik.
Jika media yang saat ini dimuat tidak memiliki durasi (misalnya, jika merupakan live stream), atau jika tidak ada media yang saat ini dimuat, atau jika tidak ada sesi Transmisi yang sedang aktif, label akan menampilkan bentuk yang dilokalkan untuk "--:--".
|
readwritenonatomicstrong |
Pengontrol posisi aliran data.
Digunakan sebagai pengganti untuk posisi streaming kustom yang disediakan aplikasi dan/atau UI pencari. Lihat GCKUIStreamPositionController untuk detailnya.
- Sejak
- 3,4
|
readwritenonatomicstrong |
Pengontrol kecepatan pemutaran streaming.
Lihat GCKUIPlaybackRateController untuk detailnya.
- Sejak
- 4,0
|
readwritenonatomicassign |
Apakah sisa waktu streaming akan ditampilkan sebagai nilai negatif, misalnya, "-1:23:45".
Secara default, properti ini disetel ke YES
.
|
readwritenonatomicassign |
Apakah kontrol posisi streaming (termasuk penggeser posisi streaming, label posisi streaming, label durasi streaming, dan tampilan progres streaming) harus disembunyikan dari konten live.
Nilai default-nya adalah NO
.
- Sejak
- 4,0
|
readwritenonatomicweak |
Tombol untuk memilih trek audio dan/atau teks tertutup atau subtitel.
Saat tombol diketuk, UI pemilihan trek media akan ditampilkan kepada pengguna. Tombol ini akan dinonaktifkan jika media yang saat ini dimuat tidak memiliki trek media yang dapat dipilih, atau jika tidak ada media yang dimuat saat ini, atau jika tidak ada sesi Transmisi yang sedang aktif.
|
readwritenonatomicweak |
Label untuk menampilkan subtitel dari media yang sedang dimuat.
Jika tidak ada kolom subtitel yang ditetapkan secara eksplisit dalam metadata, label akan menampilkan kolom metadata yang paling sesuai berdasarkan jenis media, misalnya nama studio untuk film atau nama artis untuk trek musik.
|
readwritenonatomicweak |
Tampilan indikator aktivitas untuk menunjukkan bahwa media sedang dalam status pemuatan.
|
readwritenonatomicweak |
Label untuk menampilkan sisa waktu hingga iklan dapat dilewati.
- Sejak
- 4,3
|
readwritenonatomicweak |
Tombol untuk melewati iklan saat ini.
- Sejak
- 4,3