StreamManager
Dinamik reklam ekleme akışlarını yönetir. DAI arka ucuyla etkileşimleri yönetir ve izleme ping'lerinin yanı sıra akış ve reklam etkinliklerini yayıncıya yönlendirir. Bu yönetici, belirli bir reklamın yöneticisi değil, tüm akışın yöneticisi olduğundan BaseAdsManager'dan devralmaz.
Marka
StreamManager
yeni StreamManager(videoElement, adUiElement, uiSettings)
Parametre |
|
|---|---|
|
videoElement |
Oynatmanın gerçekleşeceği HTML video öğesi. Değer boş olmamalıdır. |
|
adUiElement |
İsteğe bağlı Reklam kullanıcı arayüzü öğelerini tutmak için kullanılacak HTML öğesi. Bu öğe, video oynatmayla aynı yükseklik ve genişliğe sahip olmalı ve öğe ile doğrudan yer paylaşımlı olmalıdır. Sağlanmazsa kullanıcı arayüzü gösterilmez ve atlanabilir reklamlar gibi kullanıcı arayüzü gerektiren hiçbir reklam istenmez. Değer boş olmamalıdır. |
|
uiSettings |
İsteğe bağlı Bu akış için kullanılacak kullanıcı arayüzü ayarları. Değer boş olmamalıdır. |
- Fırlatma
-
.
Yöntemler
contentTimeForStreamTime
contentTimeForStreamTime(streamTime), sayı döndürür
Belirli bir akış süresi için reklamsız içerik süresini döndürür. Canlı yayınlar için belirtilen yayın süresini döndürür.
Parametre |
|
|---|---|
|
streamTime |
sayı eklenen reklamlarla yayın süresi (saniye cinsinden). |
- İlerlemeler
-
numberReklamlar kaldırıldıktan sonra belirtilen yayın süresine karşılık gelen içerik süresi.
odak
odak()
Atla düğmesine (varsa) odaklanılmasını sağlar. Bu simge yoksa odak, simgeler veya etkileşimli reklam öğeleri gibi etkileşimli öğelere getirilir.
getAdSkippableState
getAdAtlanabilirState() boole döndürür
Reklam atlanabiliyorsa true değerini döndürür. Bu değer değiştiğinde StreamManager, bir StreamEvent.SKIPPABLE_STATE_CHANGED etkinliği tetikler.
- İlerlemeler
-
booleanReklam şu anda atlanabilirse doğru, atlanabiliyorsa false (yanlış) değerini alır.
loadStreamMetadata
loadStreamMetadata()
SDK'nın reklam meta verilerini yüklemesini ve ardından StreamEvent.LOADED'u yayınlamasını ister. Bu komut, akış manifesti üçüncü taraf video birleştiriciden alındıktan sonra manuel olarak tetiklenmelidir. Bu özellik yalnızca üçüncü taraf video birleştiriciyle Kapsül Yayınlama VOD için kullanılır ve diğer akış istekleri için kullanılamaz.
onTimedMetadata
onTimedMetadata(metadata)
İşlenmiş meta verilerin yer aldığı bir sözlükten geçer. Sözlükte, değer olarak kullanıcı tanımlı meta veri dizesine sahip "TXXX" anahtarı beklenir. Oynatıcınız ham meta veriler sağlıyorsa bunun yerine StreamManager.processMetadata'yı çağırın.
Parametre |
|
|---|---|
|
metadata |
Nesne Meta veri sözlüğü. Değer boş olmamalıdır. |
previousCuePointForStreamTime
beforeCuePointForStreamTime(streamTime), CuePoint değerini döndürür
Belirtilen akış zamanı için önceki işaret noktasını döndürür. Böyle bir işaret noktası yoksa boş değerini döndürür. Bu, geri atlama gibi özellikleri uygulamak için kullanılır ve yayıncı, kullanıcının kullanıcıyı bir reklam arasına döndürmek için arama yaptığını algıladığında çağrılır.
Parametre |
|
|---|---|
|
streamTime |
sayı ulaşılır. |
- İlerlemeler
-
nullable CuePointbelirtilen akış süresi için önceki işaret noktasıdır.
processMetadata
processMetadata(type, data, timestamp)
Canlı yayınlar için zamanlanmış meta verileri işler. Video oynatıcınız zaman damgalarıyla birlikte ayrıştırılmamış meta veriler sağlıyorsa bunu kullanın. Aksi takdirde StreamManager.onTimedMetadata'yı çağırın.
Parametre |
|
|---|---|
|
tür |
dize Meta veri türü. HLS için "ID3" veya DASH için etkinlik mesajı şeması kimlik URI'si olmalıdır. |
|
veri |
(boş olmayan Uint8Array veya dize) Ham etiket verileri. ID3 için ham etiket verilerinin tamamı olmalıdır. DASH etkinlik mesajları için mesaj verileri dizesidir. |
|
timestamp |
sayı Verilerin işlenmesi gereken süre (saniye cinsinden). DASH için etkinlik mesajı başlangıç zamanıdır. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
Bir canlı yayının yaklaşan reklam istekleri için kullanılan tüm reklam etiketi parametrelerini değiştirir.
Parametre |
|
|---|---|
|
adTagParameters |
Dize özellikleri olan nesne Yeni reklam etiketi parametreleri. Dize değerleri içermelidir. Değer boş olmamalıdır. |
requestStream
requestStream(streamRequest)
Sağlanan akış parametrelerini kullanarak bir akışın yüklenmesini ister.
Parametre |
|
|---|---|
|
streamRequest |
akış meta verilerini yüklemek için parametreler içerir. Değer boş olmamalıdır. |
reset
sıfırlama()
Akış yöneticisini sıfırlar ve sürekli yoklamaları kaldırır.
setClickElement
setClickElement(clickElement)
Reklam tıklama öğesini ayarlar. Bu öğe, reklam oynatılırken tıklama veya dokunma alıcısı olarak kullanılır ve geçerli sayfadan ayrılmasına neden olabilir. Bu işlemin desteği sonlandırılmıştır. Bunun yerine, StreamManager'a bir adUiElement geçirilmelidir. StreamManager oluşturucusuna bir adUiElement verilirse bu yöntem işlem yok haline gelir.
Parametre |
|
|---|---|
|
clickElement |
Öğe Reklam tıklaması olarak kullanılan öğe. Değer boş olabilir. |
- Kullanımdan Kaldırıldı
- Bunun yerine StreamManager oluşturucuya bir adUiElement sağlayın.
streamTimeForContentTime
StreamTimeForContentTime(contentTime), sayı döndürür
Belirli bir içerik süresi için reklamların akış süresini döndürür. Canlı yayınlar için belirtilen içerik süresini döndürür.
Parametre |
|
|---|---|
|
contentTime |
sayı hiç reklam içermeyen içerik süresi (saniye cinsinden). |
- İlerlemeler
-
numberreklamlar eklendikten sonra belirtilen içerik süresine karşılık gelen akış süresi.