O SDK de Inserção de anúncios dinâmicos (DAI) do Interactive Media Ads (IMA) depende de informações de metadados incorporadas nos segmentos de mídia do stream (metadados em banda) ou no arquivo de manifesto de streaming (metadados no manifesto) para rastrear as posições dos espectadores e os eventos de anúncio do lado do cliente. Os metadados estão disponíveis no stream DAI em diferentes formatos, dependendo do tipo de transmissão que está sendo reproduzido. O SDK do IMA do Roku lida com todos os formatos de metadados por meio de uma única API.
Seu app é responsável por capturar metadados e encaminhá-los ao SDK de DAI do IMA. O SDK oferece o método
StreamManager.onMessage()
para transmitir essas informações. Esse método encaminha os metadados na forma de um objeto
msg
fornecido pela porta roVideo. Em seguida, esses objetos são processados pelo
SDK de DAI do IMA para estabelecer o tempo dos eventos de anúncios. É necessário um
único argumento:
msg
: um objeto do tipo msg fornecido pela porta roVideo.
Exemplo de código de metadados
Veja um exemplo de como processar os metadados da porta do Roku e fazer a transmissão
ao SDK do IMA usando StreamManager.onMessage()
.
Sub runLoop()
' Forward all timed metadata events to IMA.
m.top.video.timedMetaDataSelectionKeys = ["*"]
' Cycle through all the fields and set listeners.
' IMPORTANT: Failure to listen to the position and timedmetadata fields could
' result in ad impressions not being reported.
m.port = CreateObject("roMessagePort")
fields = m.top.video.getFields()
for each field in fields
m.top.video.observeField(field, m.port)
end for
while True
msg = wait(1000, m.port)
if m.top.video = invalid
print "exiting"
exit while
end if
m.streamManager.onMessage(msg)
currentTime = m.top.video.position
If currentTime > 3 And not m.top.adPlaying
m.top.video.enableTrickPlay = true
End If
end while
End Sub
Para mais informações sobre como incorporar os metadados do stream de processamento de loop no seu app, consulte o Guia explicativo do IMA para Roku. A seção de listener de eventos e início de stream do guia contém o loop de processamento de metadados.
Streams HLS CMAF
Os streams HLS da DAI lineares que usam o Common Media Application Framework (CMAF) transmitem metadados com marcação de tempo por meio de caixas eMSGv1 na banda, seguindo o padrão ID3 pelo CMAF. Essas caixas de eMSG são incorporadas no início de cada segmento de mídia, e cada eMSG ID3 contém um PTS relativo à última descontinuidade no stream.
Para o IMA Roku, todos os streams HLS CMAF enviam dados ID3 na banda usando o formato eMSGv0. O IMA combina as informações fornecidas pelo formato eMSGv0 com as informações do objeto de vídeo.
Para permitir a análise adequada de eventos ID3 de stream do CMAF de HLS, envie seu
objeto de vídeo na solicitação de stream usando
StreamRequest.videoObject
.