cast. framework. PlayerManager
Mengontrol dan memantau pemutaran media.
- Menampilkan
-
non-null ErrorJika konstruktor digunakan secara langsung.PlayerManagerhanya boleh diakses dengan memanggil cast.framework.CastReceiverContext#getPlayerManager.
Metode
addEventListener
addEventListener(eventType, eventListener)
Menambahkan pemroses peristiwa yang memproses peristiwa pemutaran.
Parameter |
|
|---|---|
|
eventType |
(cast.framework.events.EventType non-null atau Array cast.framework.events.EventType non-null) Jenis peristiwa atau array jenis peristiwa |
|
eventListener |
function(non-null cast.framework.events.Event) |
- Menampilkan
-
non-null ErrorJika argumen yang diberikan tidak valid.
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Menambahkan perintah baru yang didukung ke daftar perintah media yang didukung yang ada.
Parameter |
|
|---|---|
|
supportedMediaCommands |
angka Bitmask perintah media yang didukung oleh aplikasi. |
|
broadcastStatus |
Opsional boolean
|
- Lihat juga
- cast.framework.messages.Command
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
Mengirim pesan status media ke semua pengirim (siaran). Aplikasi menggunakan ini untuk mengirim perubahan status kustom.
Parameter |
|
|---|---|
|
includeMedia |
Opsional boolean
|
|
requestId |
Opsional angka ID permintaan masuk yang menyebabkan respons ini. |
|
customData |
Opsional Objek Pesan status khusus data aplikasi. Nilai dapat berupa null. |
|
includeQueueItems |
Opsional boolean Apakah akan menyertakan item antrean dalam pesan status atau tidak. Secara default, kolom tersebut tidak disertakan. |
getAbsoluteTimeForMediaTime
getAbsoluteTimeForMediaTime(mediaTime) menampilkan angka
Mengonversi waktu media menjadi waktu absolut media. Waktu absolut hanya berlaku untuk live stream.
Parameter |
|
|---|---|
|
mediaTime |
angka Waktu media. |
- Hasil
-
nullable numberWaktu absolut ataunulljika tidak tersedia.
getAudioTracksManager
getAudioTracksManager() menampilkan cast.framework.AudioTracksManager
Mendapatkan instance AudioTracksManager.
- Hasil
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() menampilkan angka
Menampilkan waktu saat ini dari klip jeda yang sedang diputar, dalam detik.
- Hasil
-
nullable numberWaktu saat ini dalam detik di dalam klip jeda saat ini.nullsaat klip jedaPlayertidak diputar.
getBreakClipDurationSec
getBreakClipDurationSec() menampilkan angka
Menampilkan durasi klip jeda yang sedang diputar dalam detik.
- Hasil
-
nullable numberDurasi klip jeda saat ini.nullsaatPlayertidak memutar klip jeda.
getBreakManager
getBreakManager() menampilkan cast.framework.breaks.BreakManager
Mendapatkan instance BreakManager.
- Hasil
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() returns Array of non-null cast.framework.messages.Break
Menampilkan daftar jeda.
- Hasil
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportedMediaCommands() menampilkan angka
Mendapatkan perintah media yang didukung penerima saat ini.
Tidak seperti getSupportedMediaCommands(), nilai yang ditampilkan metode ini
berubah secara dinamis berdasarkan status pemutaran saat ini. Misalnya,
selama pemutaran iklan, perintah SEEK mungkin tidak didukung.
Metode ini hanya boleh dipanggil setelah memanggil penerima
CastReceiverContext#start, jika tidak, metode ini akan menampilkan 0.
- Lihat juga
- cast.framework.messages.Command
- Hasil
-
numberBitmask perintah media yang didukung oleh aplikasi.
getCurrentTimeSec
getCurrentTimeSec() menampilkan angka
Mendapatkan waktu pemutaran yang telah berlalu dari media saat ini.
- Hasil
-
numberWaktu yang telah berlalu, dalam detik. Nilai ini akan menjadi0jika tidak ada media yang diputar.
getDurationSec
getDurationSec() menampilkan angka
Mendapatkan durasi media yang sedang diputar, dalam detik.
- Hasil
-
numberDurasi media.NaNjika tidak ada media yang diputar.
getLiveSeekableRange
getLiveSeekableRange() menampilkan cast.framework.messages.LiveSeekableRange
Menampilkan rentang yang dapat dicari live dengan waktu mulai dan waktu berakhir dalam detik. Nilai didasarkan pada waktu media.
- Hasil
getMediaInformation
getMediaInformation() menampilkan cast.framework.messages.MediaInformation
Mendapatkan informasi media dari media saat ini.
- Hasil
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(absoluteTime) menampilkan angka
Mengonversi waktu absolut media ke waktu media. Waktu absolut hanya berlaku untuk live stream.
Parameter |
|
|---|---|
|
absoluteTime |
angka Waktu absolut media, sebagai waktu Epoch UNIX (detik sejak epoch Unix). |
- Hasil
-
nullable numberWaktu media ataunulljika tidak tersedia.
getPlaybackConfig
getPlaybackConfig() menampilkan cast.framework.PlaybackConfig
Menampilkan konfigurasi pemutaran atau null jika default belum
diganti.
- Hasil
-
nullable cast.framework.PlaybackConfig
getPlaybackRate
getPlaybackRate() menampilkan angka
Menampilkan kecepatan pemutaran saat ini.
Menampilkan 1 sebelum penerima CastReceiverContext#start dipanggil.
- Hasil
-
numberKecepatan pemutaran saat ini.
getPlayerState
getPlayerState() menampilkan cast.framework.messages.PlayerState
Mendapatkan status Player.
- Hasil
-
non-null cast.framework.messages.PlayerStateStatusPlayersaat ini.
getPreferredPlaybackRate
getPreferredPlaybackRate() menampilkan angka
Mendapatkan laju pemutaran yang diinginkan. Dapat digunakan pada peristiwa penonaktifan untuk menyimpan kecepatan pemutaran pilihan terbaru ke penyimpanan persisten, sehingga dapat digunakan dalam sesi berikutnya di opsi pemeran.
- Hasil
-
number
getPreferredTextLanguage
getPreferredTextLanguage() menampilkan string
Mendapatkan bahasa trek teks pilihan.
- Hasil
-
nullable string
getPreferredTextStyle
getPreferredTextStyle() menampilkan cast.framework.messages.TextTrackStyle
Mendapatkan gaya trek teks pilihan.
- Hasil
getQueueManager
getQueueManager() returns (cast.framework.QueueManager or undefined)
Mendapatkan instance QueueManager.
- Hasil
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() menampilkan angka
Mendapatkan waktu pemutaran yang telah berlalu dari media saat ini, tanpa mengurangi waktu jeda iklan.
- Hasil
-
numberWaktu yang telah berlalu, dalam detik. Nilai ini akan menjadi0jika tidak ada media yang diputar.
getRawSeekableRange
getRawSeekableRange() menampilkan cast.framework.messages.Range
Menampilkan rentang media yang dapat dicari saat ini.
CATATAN: Ini cocok dengan unit getRawCurrentTimeSec(), tetapi tidak
seek()!. Ini tidak memperhitungkan offset iklan atau media lainnya.
Kecuali jika Anda yakin bahwa Anda memerlukan nilai mentah, Anda harus menggunakan
getLiveSeekableRange() sebagai gantinya.
- Hasil
-
nullable cast.framework.messages.Range
getStartAbsoluteTime
getStartAbsoluteTime() menampilkan angka
Mendapatkan waktu mulai media absolut, sebagai waktu Epoch UNIX (detik sejak epoch Unix). Waktu absolut hanya berlaku untuk live stream.
- Hasil
-
nullable number
getStats
getStats() menampilkan cast.framework.stats.Stats
Menampilkan statistik pemutaran. Statistik digabungkan di seluruh sesi pemutaran jika sesuai.
- Hasil
-
non-null cast.framework.stats.Stats
getSupportedMediaCommands
getSupportedMediaCommands() menampilkan angka
Mendapatkan perintah media yang didukung penerima. Hanya boleh dipanggil setelah memanggil
CastReceiverContext#start(), jika tidak, metode ini akan menampilkan 0. Nilai perintah media yang didukung dikontrol sepenuhnya oleh aplikasi penerima .
Tidak otomatis diperbarui berdasarkan MediaStatus.
- Lihat juga
- cast.framework.messages.Command
- Hasil
-
numberBitmask perintah media yang didukung oleh aplikasi.
getTextTracksManager
getTextTracksManager() menampilkan cast.framework.TextTracksManager
Mendapatkan instance TextTracksManager.
- Hasil
-
non-null cast.framework.TextTracksManager
getTimedMetadata
getTimedMetadata() menampilkan Array cast.framework.TimedMetadata non-null
Menampilkan metadata berwaktu yang ditemukan selama penguraian manifes. Ini adalah
#EXT-X-DATERANGE di HLS dan EventStream di DASH.
- Hasil
-
non-null Array of non-null cast.framework.TimedMetadata
load
load(loadRequest) menampilkan Promise yang berisi void
Memulai permintaan untuk memuat media.
Parameter |
|
|---|---|
|
loadRequest |
cast.framework.messages.LoadRequestData Permintaan untuk memuat media. Nilai tidak boleh null. |
- Hasil
-
non-null Promise containing voidPromise yang di-resolve saat operasi berhasil, atau ditolak jika gagal.
pause
pause()
Menjeda media yang sedang diputar.
putar
play()
Memutar media yang saat ini dijeda.
removeEventListener
removeEventListener(eventType, eventListener)
Menghapus pemroses peristiwa yang ditambahkan untuk peristiwa pemutaran tertentu. Jika tidak ada pemroses peristiwa yang cocok, panggilan ini akan diabaikan.
Parameter |
|
|---|---|
|
eventType |
(cast.framework.events.EventType non-null atau Array cast.framework.events.EventType non-null) eventType atau array jenis peristiwa |
|
eventListener |
function(non-null cast.framework.events.Event) |
removeSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Menghapus perintah dari daftar perintah media yang didukung.
Parameter |
|
|---|---|
|
supportedMediaCommands |
angka Bitmask perintah media yang didukung oleh aplikasi. |
|
broadcastStatus |
Opsional boolean
|
- Lihat juga
- cast.framework.messages.Command
cari
seek(seekTime)
Mencari di media saat ini.
Parameter |
|
|---|---|
|
seekTime |
angka |
sendCustomState
sendCustomState(state)
Mengirim status kustom dari logika pemutaran aplikasi ke logika UI.
Metode ini membantu mengaktifkan pemisahan logika pemutaran dan UI.
Dengan mempertahankan pemisahan antara logika dan UI, pengguna dapat menggunakan logika UI yang sama untuk pemutaran lokal dan kontrol jarak jauh.
Status kustom yang dikirim oleh metode ini tersedia untuk UI melalui
PlayerData.
Parameter |
|
|---|---|
|
dengan status tersembunyi akhir |
Objek Objek status kustom. Nilai tidak boleh null. |
- Lihat juga
- cast.framework.ui.PlayerData#customState
sendError
sendError(senderId, requestId, type, reason, customData)
Mengirim error ke pengirim tertentu.
Parameter |
|
|---|---|
|
senderId |
string ID pengirim. |
|
requestId |
angka ID permintaan masuk yang menyebabkan error ini. |
|
jenis |
cast.framework.messages.ErrorType Jenis error. Nilai tidak boleh null. |
|
alasan |
Opsional cast.framework.messages.ErrorReason Alasan error. Nilai dapat berupa null. |
|
customData |
Opsional Objek Pesan error data kustom spesifik per aplikasi. Nilai dapat berupa null. |
sendLocalMediaRequest
sendLocalMediaRequest(request)
Mengirim permintaan media lokal.
Parameter |
|
|---|---|
|
minta |
cast.framework.messages.RequestData Nilai tidak boleh null. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
Mengirim pesan status media ke pengirim tertentu.
Parameter |
|
|---|---|
|
senderId |
string ID pengirim. |
|
requestId |
angka ID permintaan masuk yang menyebabkan respons ini. |
|
includeMedia |
Opsional boolean
|
|
customData |
Opsional Objek Pesan status khusus data aplikasi. Nilai dapat berupa null. |
|
includeQueueItems |
Opsional boolean Apakah akan menyertakan item antrean dalam pesan status atau tidak. Secara default, kolom tersebut tidak disertakan. |
setIdleReason
setIdleReason(idleReason)
Menetapkan alasan pemutar berada dalam status IDLE.
Hal ini memungkinkan aplikasi yang ingin memaksakan status IDLE
untuk menunjukkan alasan melakukannya (misalnya, error kustom).
Alasan tidak ada aktivitas dikirim dalam pesan status berikutnya.
Catatan Sebagian besar aplikasi tidak perlu menetapkan nilai ini. Ini hanya diperlukan
jika aplikasi perlu membuat Player beralih ke status IDLE dalam keadaan
khusus dan idleReason default tidak mencerminkan perilaku yang diinginkan.
Parameter |
|
|---|---|
|
idleReason |
cast.framework.messages.IdleReason Alasan berada dalam
status Nilai tidak boleh null. |
setMediaElement
setMediaElement(mediaElement)
Menetapkan HTMLMediaElement yang akan digunakan. Jika Promise dari
HTMLMediaElement ditetapkan, media akan mulai diputar setelah Promise diselesaikan.
Parameter |
|
|---|---|
|
mediaElement |
(HTMLMediaElement non-null atau Promise non-null yang berisi HTMLMediaElement non-null)
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Menetapkan informasi media.
Parameter |
|
|---|---|
|
mediaInformation |
cast.framework.messages.MediaInformation Nilai tidak boleh null. |
|
opt_broadcast |
Opsional boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(handler)
Menetapkan pengendali untuk menampilkan atau mengubah cast.framework.PlaybackConfig,
untuk permintaan pemuatan tertentu. Parameter handler adalah
LoadRequestData dan PlaybackConfig default untuk penerima (disediakan
di CastReceiverOptions). Handler harus menampilkan konfigurasi
pemutaran yang diubah, atau null untuk mencegah media diputar. Nilai
yang ditampilkan juga dapat berupa Promise untuk memungkinkan menunggu data dari server.
Parameter |
|
|---|---|
|
handler |
function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig) Fungsi untuk menyediakan konfigurasi pemutaran khusus permintaan. Nilai dapat berupa null. |
setMediaUrlResolver
setMediaUrlResolver(resolver)
Menetapkan pengendali untuk menampilkan URL media untuk permintaan LOAD.
Handler ini dapat digunakan untuk menghindari publikasi URL konten media
sebagai bagian dari status media. Secara default, contentId media digunakan sebagai URL konten.
Parameter |
|
|---|---|
|
resolver |
function(non-null cast.framework.messages.LoadRequestData) Fungsi untuk menyelesaikan URL konten media. Nilai dapat berupa null. |
setMessageInterceptor
setMessageInterceptor(type, interceptor)
Menetapkan interceptor untuk pesan masuk dan keluar.
Interceptor dapat memperbarui data permintaan, dan harus menampilkan data yang diperbarui, Promise dengan data yang diperbarui (jika data tidak dapat ditampilkan segera), atau null jika permintaan tidak boleh ditangani.
Catatan: jika pencegat pesan LOAD disediakan, tetapi tidak ada pencegat
PRELOAD terpisah, pencegat LOAD akan dipanggil untuk pesan
PRELOAD.
Parameter |
|
|---|---|
|
jenis |
cast.framework.messages.MessageType Nilai tidak boleh null. |
|
interceptor |
function(non-null cast.framework.messages.RequestData) Nilai dapat berupa null. |
setPlaybackConfig
setPlaybackConfig(playbackConfig)
Menetapkan konfigurasi pemutaran di PlayerManager.
Parameter |
|
|---|---|
|
playbackConfig |
Nilai tidak boleh null. |
setSupportedMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Menetapkan perintah media yang didukung oleh penerima.
Parameter |
|
|---|---|
|
supportedMediaCommands |
angka Bitmask perintah media yang didukung oleh aplikasi. |
|
broadcastStatus |
Opsional boolean
|
- Lihat juga
- cast.framework.messages.Command
berhenti
stop()
Menghentikan media yang sedang diputar.