Per discutere e fornire feedback sui nostri prodotti, unisciti al canale Discord ufficiale di Ad Manager nel server della community di Google Advertising and Measurement.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Class StreamManager

Gestisce gli stream di inserimento di annunci dinamici. Questa classe gestisce le interazioni con i server DAI, gestisce i ping di monitoraggio ed emette eventi di stream e annuncio.

Costruttori
`constructor`

Metodi
`addEventListener`	Aggiunge un listener per il tipo di evento specificato.
`contentTimeForStreamTime`	Restituisce la durata dei contenuti senza annunci per un determinato tempo di stream.
`focus`	Imposta lo stato attivo sul pulsante Salta, se presente.
`getAdSkippableState`	Restituisce un valore `true` se l'utente può saltare l'annuncio corrente.
`loadStreamMetadata`	Richiede all'SDK DAI di caricare i metadati dell'annuncio ed emette un evento di stream `LOADED`.
`onTimedMetadata`	Passa in un dizionario di metadati elaborati.
`previousCuePointForStreamTime`	Restituisce il cue point precedente per il tempo dello stream specificato.
`processMetadata`	Elabora i metadati temporizzati per gli stream.
`removeEventListener`	Rimuove un listener per il tipo di evento StreamEvent specificato.
`replaceAdTagParameters`	Sostituisce tutti i parametri dei tag annuncio utilizzati per le richieste di annunci imminenti per un live streaming.
`requestStream`	Richiede il caricamento di uno stream per IMA DAI utilizzando i parametri dello stream forniti.
`reset`	Reimposta lo stream manager e rimuove qualsiasi polling continuo.
`streamTimeForContentTime`	Restituisce il tempo totale di streaming con gli annunci per un determinato periodo di tempo dei contenuti.

Costruttori

costruttore

new StreamManager(videoElement: HTMLVideoElement, adUiElement?: HTMLElement, uiSettings?: UiSettings): StreamManager

Parametri
`videoElement: HTMLVideoElement`	L'elemento video HTML in cui avviene la riproduzione.
`Optional adUiElement: HTMLElement`	L'elemento in cui viene eseguito il rendering dell'interfaccia utente dell'annuncio.
`Optional uiSettings: UiSettings`	Le impostazioni della UI da utilizzare per questo stream.

Resi
`StreamManager`

Metodi

addEventListener

addEventListener(type: Type | Type[], listener: ((event: StreamEvent) => void)): void

Aggiunge un listener per il tipo di evento specificato.

Parametri
`type: Type \| Type[]`	Il tipo di evento dell'annuncio o un array di tipi di eventi.
`listener: ((event: StreamEvent) => void)`	Una funzione di callback per il listener dell'annuncio.

contentTimeForStreamTime

contentTimeForStreamTime(streamTime: number): number

Restituisce la durata dei contenuti senza annunci per un determinato tempo di stream. Restituisce l'ora dello stream specificata per i live streaming.

Parametri
`streamTime: number`	Il tempo di streaming in secondi, che combina contenuti e annunci.

Resi
`number`	il tempo dei contenuti per il tempo dello stream specificato, esclusi gli annunci.

focus

focus(): void

Imposta lo stato attivo sul pulsante Salta, se presente. Se non è presente, lo stato attivo viene ripristinato sull'elemento interattivo.

getAdSkippableState

getAdSkippableState(): boolean

Restituisce un valore true se l'utente può saltare l'annuncio corrente. Quando questo valore cambia, la classe StreamManager emette un evento di flusso SKIPPABLE_STATE_CHANGED.

Resi
`boolean`	`true` se l'utente può saltare l'annuncio corrente, `false` altrimenti.

loadStreamMetadata

loadStreamMetadata(): void

Richiede all'SDK DAI di caricare i metadati dell'annuncio ed emette un evento di stream LOADED. Chiama manualmente questo metodo quando recuperi il manifest dello stream dal tuo assemblatore di video di terze parti. Questo metodo è valido solo per gli stream VOD con pubblicazione di pod con stitcher video di terze parti.

onTimedMetadata

onTimedMetadata(metadata: { 
  [key: string]: string; 
}): void

Passa in un dizionario di metadati elaborati. Il dizionario prevede la chiave esatta "TXXX" con la stringa di metadati definita dall'utente come valore. Se il tuo lettore fornisce metadati non elaborati, chiama il metodo StreamManager.processMetadata.

Parametri
`metadata: { [key: string]: string; }`	Il dizionario dei metadati.

previousCuePointForStreamTime

previousCuePointForStreamTime(streamTime: number): CuePoint

Restituisce il cue point precedente per il tempo dello stream specificato. Se non esiste alcun cue point precedente, restituisce null. Utilizza questo metodo per implementare funzionalità come lo snapback chiamando il metodo quando l'utente cerca di tornare a un'interruzione pubblicitaria.

Parametri
`streamTime: number`	il tempo di riproduzione a cui l'utente vuole passare.

Resi
`CuePoint`	il cue point precedente per l'ora dello stream specificata.

processMetadata

processMetadata(type: string, data: string | Uint8Array, timestamp: number): void

Elabora i metadati temporizzati per gli stream. Utilizza questo metodo se il tuo video player fornisce metadati non analizzati con timestamp. In caso contrario, chiama StreamManager.onTimedMetadata.

Parametri
`type: string`	Tipo di metadati. Deve essere la stringa `'ID3'` per HLS o l'URI ID schema del messaggio dell'evento per DASH.
`data: string \| Uint8Array`	Dati tag non elaborati. Per ID3, devono essere i dati grezzi completi del tag. Per i messaggi di evento DASH, si tratta della stringa di dati del messaggio.
`timestamp: number`	Tempo in secondi in cui elaborare i dati. Per DASH, questo parametro è l'ora di inizio del messaggio dell'evento.

removeEventListener

removeEventListener(type: Type, listener: ((event: StreamEvent) => void)): void

Rimuove un listener per il tipo di evento StreamEvent specificato. Per rimuovere correttamente un listener, il parametro listener che passi a questo metodo deve essere uguale per riferimento a quello passato in precedenza al metodo addEventListener.

Parametri
`type: Type`	Il tipo di evento per cui rimuovere il listener.
`listener: ((event: StreamEvent) => void)`	La funzione per rimuovere un utente come ascoltatore.

replaceAdTagParameters

replaceAdTagParameters(adTagParameters: { 
  [key:
              string]: string; 
}): void

Sostituisce tutti i parametri dei tag annuncio utilizzati per le richieste di annunci imminenti per un live streaming.

Parametri
`adTagParameters: { [key: string]: string; }`	I parametri del tag annuncio di sostituzione. Devono avere valori stringa.

requestStream

requestStream(streamRequest: StreamRequest): void

Richiede il caricamento di uno stream per IMA DAI utilizzando i parametri dello stream forniti.

Parametri
`streamRequest: StreamRequest`	contiene i parametri per caricare i metadati dello stream.

reset

reset(): void

Reimposta Stream Manager e rimuove qualsiasi polling continuo.

streamTimeForContentTime

streamTimeForContentTime(contentTime: number): number

Restituisce il tempo totale di streaming con gli annunci per un determinato periodo di tempo dei contenuti. Restituisce l'ora dei contenuti specificata per i live streaming.

Parametri
`contentTime: number`	il tempo dei contenuti senza annunci in secondi.

Resi
`number`	il tempo totale di streaming corrispondente al tempo dei contenuti specificato dopo l'inserimento degli annunci da parte di DAI.

Class StreamManager Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.