google. ima. AdsManager
Menyediakan API publik luar untuk penayang dan berkomunikasi dengan instance internal pengelola iklan.
Metode
ciutkan
ciutkan()
Ciutkan iklan saat ini. Ini adalah kondisi tanpa pengoperasian untuk HTML5 SDK.
konfigurasikanAdsManager
configureAdsManager(konten, adsRenderingSettings)
Menetapkan parameter yang diperlukan untuk mendapatkan referensi ke AdManager ini dari peristiwa AdsManagerLoaded.
Parameter |
|
---|---|
konten |
Objek Objek yang memutar konten penayang. Nilai tidak boleh kosong. |
adsRenderingSettings |
Opsional AdsRenderingSettings Setelan opsional untuk mengontrol rendering iklan. Nilai mungkin null. |
hancurkan
menghancurkan()
Menghapus aset iklan yang dimuat pada runtime yang perlu dihapus dengan benar pada saat penyelesaian iklan, serta menghentikan iklan dan semua pelacakan.
hapusAdBreak
hapusAdBreak()
Jika jeda iklan sedang diputar, hapus dan lanjutkan konten. Jika tidak, abaikan jeda iklan terjadwal berikutnya. Misalnya, ini dapat dipanggil segera setelah pengelola iklan dimuat untuk mengabaikan preroll tanpa kehilangan midroll atau postroll di masa mendatang. Ini merupakan tanpa pengoperasian, kecuali jika permintaan iklan menampilkan respons playlist atau VMAP.
luaskan
luaskan()
Luaskan iklan saat ini. Ini adalah kondisi tanpa pengoperasian untuk HTML5 SDK.
focus
fokus()
Menempatkan fokus pada tombol lewati, jika ada. Jika tidak ada, fokus akan ditempatkan pada elemen interaktif, termasuk ikon atau materi iklan interaktif.
getAdSkipState
getAdSkipState() menampilkan boolean
Menampilkan true jika iklan saat ini dapat dilewati. Saat nilai ini berubah, AdsManager
akan mengaktifkan peristiwa AdEvent.SKIPPABLE_STATE_CHANGED
.
- Hasil
-
boolean
Benar jika iklan saat ini dapat dilewati, dan menampilkan false untuk kondisi lainnya.
getCuePoints
getCuePoints() menampilkan Array angka
Menampilkan array offset dalam detik yang menunjukkan kapan jeda iklan terjadwal akan diputar. Preroll diwakili oleh 0, dan postroll diwakili oleh -1. Array kosong menunjukkan bahwa iklan atau pod iklan tidak memiliki jadwal dan dapat diputar kapan saja.
- Hasil
-
non-null Array of number
Daftar selisih waktu dalam detik.
MendapatkanRemainingTime
getRemainingTime() menampilkan jumlah
Mendapatkan sisa waktu iklan saat ini yang sedang diputar. Jika iklan belum dimuat atau sudah selesai diputar, API akan menampilkan -1.
- Hasil
-
number
Menampilkan waktu yang tersisa untuk iklan saat ini. Jika sisa waktu tidak ditentukan untuk iklan saat ini (misalnya iklan kustom), nilainya akan menampilkan -1.
getVolume
getVolume() menampilkan jumlah
Dapatkan volume untuk iklan saat ini.
- Hasil
-
number
Volume iklan saat ini, dari 0 (dibisukan) hingga 1 (paling keras).
init
init(lebar, tinggi, viewMode, videoElement)
Panggil init untuk menginisialisasi pengalaman iklan di pengelola iklan.
Parameter |
|
---|---|
lebar |
angka Lebar iklan yang dipilih. |
tinggi |
angka Tinggi iklan yang dipilih. |
mode tampilan |
ModeTampilan Mode tampilan yang dipilih. Nilai tidak boleh kosong. |
elemenVideo |
Opsional ElemenVideoHTML Elemen video untuk pemutaran kustom. Elemen video ini menggantikan elemen yang disediakan di konstruktor AdDisplayContainer. Hanya gunakan properti ini jika benar-benar diperlukan - jika tidak, sebaiknya tentukan elemen video ini saat membuat AdDisplayContainer. Nilai mungkin null. |
isCustomClickTrackingUsed
isCustomClickTrackingUsed() menampilkan boolean
Menampilkan true jika elemen pelacakan klik kustom digunakan untuk pelacakan klik pada iklan saat ini. Pelacakan klik kustom hanya digunakan jika elemen pelacakan klik opsional disediakan untuk AdDisplayContainer
, pemutaran kustom digunakan, dan iklan saat ini bukan iklan AdSense/AdX.
- Hasil
-
boolean
Apakah pelacakan klik kustom digunakan.
isCustomPlaybackUsed
isCustomPlaybackUsed() menampilkan boolean
Menampilkan true jika elemen video kustom digunakan untuk memutar iklan saat ini. Pemutaran kustom terjadi saat elemen video opsional diberikan ke AdDisplayContainer
di platform tempat elemen video kustom akan memberikan pengalaman penayangan iklan yang lebih lancar.
- Hasil
-
boolean
Apakah pemutaran kustom digunakan.
jeda
jeda()
Menjeda iklan yang sedang diputar. Fungsi ini tidak akan beroperasi jika overlay statis ditampilkan atau jika iklan belum dimuat atau selesai diputar.
resize
ubah ukuran(lebar, tinggi, viewMode)
Mengubah ukuran iklan saat ini.
Parameter |
|
---|---|
lebar |
angka Lebar slot iklan baru. |
tinggi |
angka Tinggi slot iklan baru. |
mode tampilan |
ModeTampilan Mode tampilan baru. Nilai tidak boleh kosong. |
resume
resume()
Melanjutkan iklan saat ini yang dimuat dan dijeda. Fungsi ini akan menjadi tanpa pengoperasian saat overlay statis ditampilkan atau jika iklan belum dimuat atau selesai diputar.
setVolume
setVolume(volume)
Tetapkan volume untuk iklan saat ini.
Parameter |
|
---|---|
volume |
angka Volume yang disetel, dari 0 (dibisukan) hingga 1 (paling keras). |
lewati
lewati()
Lewati iklan saat ini jika AdsManager.getAdSkippableState()
benar. Saat dipanggil dalam keadaan lain, lewati tidak akan berpengaruh. Setelah
lewati selesai, AdsManager
akan mengaktifkan
peristiwa AdEvent.SKIPPED
.
mulai
mulai()
Mulai putar iklan.
Developer harus memanggil AdDisplayContainer.initialize()
terlebih dahulu.
stop
stop()
Berhenti memutar iklan. Jika sudah diaktifkan, penayang akan kembali ke konten.
updateAdsRenderingSettings
updateAdsRenderingSettings(adsRenderingSettings) -
Memperbarui setelan rendering iklan. Ini harus digunakan secara khusus untuk kasus penggunaan VMAP di antara jeda iklan saat setelan rendering iklan seperti kecepatan bit perlu diperbarui.
Parameter |
|
---|---|
adsRenderingSettings |
AdsRenderingSettings Setelan rendering iklan yang diperbarui. Nilai tidak boleh kosong. |