cast. framework. PlayerManager
Mengontrol dan memantau pemutaran media.
- Menampilkan
-
non-null Error
Jika konstruktor digunakan secara langsung.PlayerManager
hanya dapat 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 non-null dari cast.framework.events.EventType non-null Jenis peristiwa atau array jenis peristiwa |
PemrosesPeristiwa |
function(cast.framework.events.Event non-null) |
- Menampilkan
-
non-null Error
Jika argumen yang diberikan tidak valid.
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Menambahkan perintah baru yang didukung ke daftar perintah media yang didukung.
Parameter |
|
---|---|
didukungMediaCommands |
nomor Bitmask perintah media yang didukung oleh aplikasi. |
statusSiaran |
Opsional boolean
|
- Lihat juga
- cast.framework.messages.Command
statusSiaran
siapStatus(includeMedia, requestId, customData, includeQueueItems)
Mengirim pesan status media ke semua pengirim (siaran). Aplikasi menggunakannya untuk mengirimkan perubahan status kustom.
Parameter |
|
---|---|
includeMedia |
Opsional boolean
|
ID permintaan |
Opsional nomor ID permintaan masuk yang menyebabkan respons ini. |
datakustom |
Opsional Object Data kustom khusus aplikasi status pesan. Nilai dapat berupa null. |
includeQueueItems |
Opsional boolean Apakah akan menyertakan item antrean dalam pesan status. Secara default, laporan ini tidak disertakan. |
getAbsoluteTimeForMediaTime
getAbsoluteTimeForMediaTime(mediaTime) menampilkan jumlah
Mengonversi waktu media ke waktu absolut media. Waktu absolut hanya berlaku untuk live stream.
Parameter |
|
---|---|
WaktuMedia |
nomor Waktu media. |
- Hasil
-
nullable number
Waktu absolut ataunull
jika tidak tersedia.
getAudioTracksManager
getAudioTracksManager() menampilkan cast.framework.AudioTracksManager
Mendapatkan instance AudioTracksManager
.
- Hasil
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSecSec mengembalikan nomor
Menampilkan waktu saat ini dari klip jeda yang sedang diputar, dalam detik.
- Hasil
-
nullable number
Waktu saat ini dalam detik di dalam klip jeda saat ini.null
saatPlayer
tidak memutar klip jeda.
getBreakClipDurationSec
getBreakClipDurationSec() menampilkan jumlah
Menampilkan durasi klip jeda yang sedang diputar dalam detik.
- Hasil
-
nullable number
Durasi klip jeda saat ini.null
saatPlayer
tidak memutar klip jeda.
getBreakManager
getBreakManager() menampilkan cast.framework.breaks.BreakManager
Mendapatkan instance BreakManager
.
- Hasil
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() menampilkan Array cast.framework.messages.Break non-null
Menampilkan daftar jeda.
- Hasil
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportedMediaCommands() mengembalikan nomor
Mendapatkan perintah media yang didukung penerima saat ini.
Tidak seperti getSupportedMediaCommands()
, nilai yang ditampilkan dari 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 penerima CastReceiverContext#start
dipanggil, jika tidak, metode akan menampilkan 0
.
- Lihat juga
- cast.framework.messages.Command
- Hasil
-
number
Bitmask perintah media yang didukung oleh aplikasi.
getCurrentTimeSec
getCurrentTimeSec() mengembalikan nomor
Mendapatkan waktu pemutaran yang berlalu untuk media saat ini.
- Hasil
-
number
Waktu yang berlalu, dalam detik. Ini akan menjadi0
jika tidak ada media yang diputar.
getDurationSec
getDurationSec() menampilkan jumlah
Mendapatkan durasi media yang sedang diputar, dalam detik.
- Hasil
-
number
Durasi media.NaN
jika tidak ada media yang diputar.
getLiveSeekableRange
getLiveSeekableRange() menampilkan cast.framework.messages.LiveSeekableRange
Menampilkan rentang yang dapat dicari secara langsung dengan waktu mulai dan waktu berakhir dalam detik. Nilainya berdasarkan waktu media.
- Hasil
getMediaInformation
getMediaInformation() menampilkan cast.framework.messages.MediaInformation
Mendapatkan informasi media dari media saat ini.
- Hasil
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(absoluteTime) menampilkan jumlah
Mengonversi waktu absolut media ke waktu media. Waktu absolut hanya berlaku untuk live stream.
Parameter |
|
---|---|
WaktuAbsolut |
nomor Waktu absolut media, sebagai waktu Epoch UNIX (detik sejak epoch Unix). |
- Hasil
-
nullable number
Waktu media ataunull
jika tidak tersedia.
getPlaybackConfig
getPlaybackConfig() menampilkan cast.framework.PlaybackConfig
Menampilkan konfigurasi pemutaran.
- Hasil
-
nullable cast.framework.PlaybackConfig
getPlaybackRate
getPlaybackRate() mengembalikan nomor
Menampilkan kecepatan pemutaran saat ini.
Menampilkan 1
sebelum penerima CastReceiverContext#start
dipanggil.
- Hasil
-
number
Rasio pemutaran saat ini.
getPlayerState
getPlayerState() menampilkan cast.framework.messages.PlayerState
Mendapatkan status Player
.
- Hasil
-
non-null cast.framework.messages.PlayerState
StatusPlayer
saat ini.
getPreferredPlaybackRate
getPreferredPlaybackRate() mengembalikan jumlah
Mendapatkan kecepatan pemutaran yang diinginkan. Dapat digunakan pada peristiwa penonaktifan untuk menyimpan kecepatan pemutaran terbaru ke penyimpanan persisten, sehingga dapat digunakan pada sesi berikutnya di opsi transmisi.
- 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 yang diinginkan.
- Hasil
getQueueManager
getQueueManager() menampilkan (cast.framework.QueueManager atau undefined)
Mendapatkan instance QueueManager
.
- Hasil
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() mengembalikan nomor
Mendapatkan waktu pemutaran yang berlalu untuk media saat ini, tanpa mengurangi waktu jeda iklan.
- Hasil
-
number
Waktu yang berlalu, dalam detik. Ini akan menjadi0
jika tidak ada media yang diputar.
getStartAbsoluteTime
getStartAbsoluteTime() mengembalikan nomor
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 selama seluruh sesi pemutaran jika sesuai.
- Hasil
-
non-null cast.framework.stats.Stats
getSupportedMediaCommands
getSupportedMediaCommands() mengembalikan nomor
Mendapatkan perintah media yang didukung penerima. Hanya boleh dipanggil setelah memanggil CastReceiverContext#start()
, jika tidak, 0
akan ditampilkan. Nilai perintah media
yang didukung hanya dikontrol oleh aplikasi penerima .
Data ini tidak otomatis diperbarui berdasarkan MediaStatus
.
- Lihat juga
- cast.framework.messages.Command
- Hasil
-
number
Bitmask 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 non-null cast.framework.TimedMetadata
Menampilkan metadata dengan waktu 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 kosong. |
- Hasil
-
non-null Promise containing void
Promise yang di-resolve saat operasi berhasil, atau ditolak jika gagal.
jeda
jeda()
Menjeda media yang sedang diputar.
play
putar()
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 non-null dari cast.framework.events.EventType non-null eventType atau array jenis peristiwa |
PemrosesPeristiwa |
function(cast.framework.events.Event non-null) |
menghapusSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Menghapus perintah dari daftar perintah media yang didukung.
Parameter |
|
---|---|
didukungMediaCommands |
nomor Bitmask perintah media yang didukung oleh aplikasi. |
statusSiaran |
Opsional boolean
|
- Lihat juga
- cast.framework.messages.Command
cari
seek(findkTime)
Cari di media saat ini.
Parameter |
|
---|---|
pencarianTime |
nomor |
sendCustomState
sendCustomState(status)
Mengirim status kustom dari logika pemutaran aplikasi ke logika UI.
Metode ini membantu memungkinkan pemisahan logika pemutaran dan UI.
Dengan mempertahankan pemisahan antara logika dan UI, Anda dapat menggunakan logika UI yang sama
untuk pemutaran lokal dan remote control.
Status kustom yang dikirim oleh metode ini tersedia untuk UI melalui
PlayerData
.
Parameter |
|
---|---|
dengan status tersembunyi akhir |
Object Objek status kustom. Nilai tidak boleh kosong. |
- Lihat juga
- cast.framework.ui.PlayerData#customState
sendError
sendError(senderId, requestId, type, reason, customData)
Mengirim error ke pengirim tertentu.
Parameter |
|
---|---|
pengirimId |
string ID pengirim. |
ID permintaan |
nomor ID permintaan masuk yang menyebabkan error ini. |
tipe |
cast.framework.messages.ErrorType Jenis error. Nilai tidak boleh kosong. |
alasan |
Opsional cast.framework.messages.ErrorReason Alasan error. Nilai dapat berupa null. |
datakustom |
Opsional Object Data kustom khusus aplikasi pesan error. Nilai dapat berupa null. |
sendLocalMediaRequest
sendLocalMediaRequest(permintaan)
Mengirim permintaan media lokal.
Parameter |
|
---|---|
minta |
cast.framework.messages.RequestData Nilai tidak boleh kosong. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
Mengirim pesan status media ke pengirim tertentu.
Parameter |
|
---|---|
pengirimId |
string ID pengirim. |
ID permintaan |
nomor ID permintaan masuk yang menyebabkan respons ini. |
includeMedia |
Opsional boolean
|
datakustom |
Opsional Object Data kustom khusus aplikasi status pesan. Nilai dapat berupa null. |
includeQueueItems |
Opsional boolean Apakah akan menyertakan item antrean dalam pesan status. Secara default, laporan ini tidak disertakan. |
setIdleReason
setIdleReason(idleReason)
Menetapkan alasan pemutar berada dalam status IDLE
.
Hal ini memungkinkan aplikasi yang ingin memaksa 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. Hanya diperlukan
jika aplikasi perlu membuat Player
beralih ke status IDLE
dalam keadaan
khusus dan status tidak ada aktivitas default tidak mencerminkan perilaku
yang diinginkan.
Parameter |
|
---|---|
alasan tidak ada aktivitas |
cast.framework.messages.IdleReason Alasan berada dalam
status Nilai tidak boleh kosong. |
setMediaElement
setMediaElement(mediaElement)
Menetapkan HTMLMediaElement
yang akan digunakan. Jika Promise
dari
HTMLMediaElement
ditetapkan, media akan memulai pemutaran setelah Promise
diselesaikan.
Parameter |
|
---|---|
elemenmedia |
(HTMLMediaElement non-null atau Promise non-null yang berisi HTMLMediaElement non-null)
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Menetapkan informasi media.
Parameter |
|
---|---|
mediaInformasi |
cast.framework.messages.MediaInformation Nilai tidak boleh kosong. |
siaran_siaran |
Opsional boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(handler)
Menetapkan pengendali untuk menampilkan atau mengubah cast.framework.PlaybackConfig, untuk permintaan pemuatan tertentu. Parameter pengendali adalah
LoadRequestData
dan PlaybackConfig
default untuk penerima (disediakan
dalam CastReceiverOptions
). Pengendali harus menampilkan konfigurasi
pemutaran yang dimodifikasi, atau null
untuk mencegah media diputar. Nilai
yang ditampilkan mungkin juga Promise
agar dapat menunggu data dari server.
Parameter |
|
---|---|
handler |
function(cast.framework.messages.LoadRequestData non-null, cast.framework.PlaybackConfig non-null) Fungsi untuk memberikan konfigurasi pemutaran khusus permintaan. Nilai dapat berupa null. |
setMediaUrlResolver
setMediaUrlResolver(resolver)
Menetapkan pengendali untuk menampilkan URL media untuk permintaan LOAD
.
Pengendali ini dapat digunakan agar URL konten media tidak dipublikasikan
sebagai bagian dari status media. Secara default, media contentId
digunakan sebagai URL konten.
Parameter |
|
---|---|
resolver |
function(cast.framework.messages.LoadRequestData non-null) Fungsi untuk me-resolve URL konten media. Nilai dapat berupa null. |
setMessageInterceptor
setMessageInterceptor(jenis, interseptor)
Menetapkan pencegat pesan masuk dan keluar.
Pencegat dapat memperbarui data permintaan, dan harus menampilkan data yang diperbarui, Promise
dengan data yang diperbarui (jika data tidak dapat segera dikembalikan), atau null
jika permintaan tidak perlu ditangani.
Catatan: jika interseptor pesan LOAD
disediakan, tetapi tidak ada
intersep PRELOAD
terpisah yang disediakan, intersepsi LOAD
akan dipanggil
untuk pesan PRELOAD
.
Parameter |
|
---|---|
tipe |
cast.framework.messages.MessageType Nilai tidak boleh kosong. |
interseptor |
function(cast.framework.messages.RequestData non-null) Nilai dapat berupa null. |
setPlaybackConfig
setPlaybackConfig(playbackConfig)
Menetapkan konfigurasi pemutaran di PlayerManager
.
Parameter |
|
---|---|
playbackConfig |
Nilai tidak boleh kosong. |
setSupportMediaMedia
setSupportedMediaCommands(supportedMediaCommands, statusStatus)
Menyetel perintah media yang didukung oleh penerima.
Parameter |
|
---|---|
didukungMediaCommands |
nomor Bitmask perintah media yang didukung oleh aplikasi. |
statusSiaran |
Opsional boolean
|
- Lihat juga
- cast.framework.messages.Command
stop
stop()
Menghentikan media yang sedang diputar.