Processar metadados cronometrados em streams da DAI linear

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.