查看 SIMID 支持

适用于 HTML5 的 Google 动态广告插播 (DAI) SDK 支持安全交互式媒体接口定义 (SIMID) 1.1 版。本指南介绍了 DAI SDK 支持的特定 SIMID 功能和消息。

了解广告素材到播放器的消息

下表列出了 SIMID 广告素材可以发送给 IMA DAI 的消息：

消息 说明
clickThru DAI SDK 会 ping DAI 广告代码中配置的点击后到达跟踪网址。DAI SDK 会忽略广告素材提供的任何自定义 URI 或导航选项。
getMediaState 返回媒体播放器的当前状态，包括 currentTime、duration、volume、muted、paused 和 fullscreen 属性。currentSrc 属性始终返回 null，因为 DAI 使用服务器端拼接的数据流。
log 将广告素材日志消息转发到 DAI SDK 调试控制台日志记录，以进行问题排查。
reportTracking 请求 DAI SDK ping 广告素材的跟踪网址。
requestPause 请求 DAI SDK 暂停媒体播放器。
requestPlay 请求 DAI SDK 在媒体播放器上恢复播放。
requestSkip 请求 DAI SDK 跳过当前广告。仅支持 VOD 数据流。如果广告素材为直播发送此消息，则会拒绝。

查看不受支持的广告素材到播放器的消息

DAI SDK 不处理以下 CreativeMessage 类型：

  • fatalError
  • requestChangeAdDuration
  • requestFullscreen
  • requestExitFullscreen
  • handleSkipShown
  • requestFocus
  • requestNavigation：始终被拒绝。播放器希望广告素材处理导航。
  • requestResize：始终被拒绝。DAI SDK 不支持广告素材调整大小。
  • requestStop：始终被拒绝。此类型适用于延长时长的使用情形，DAI 不支持此类情形。
  • requestChangeVolume：DAI SDK 会成功解析此事件，但不会对广告素材执行音量更改。

了解播放器到广告素材的消息

下表列出了 DAI SDK 支持发送给 SIMID 广告素材的消息：

消息 说明
init 在会话设置期间发送，包含环境数据和广告参数。
startCreative 通知广告素材启动并显示广告素材 iframe。
adStopped 通知广告会话已结束，包括原因代码。
adSkipped 通知广告素材用户或 DAI SDK 跳过了广告。仅支持 VOD 数据流。

查看不受支持的播放器到广告素材的消息

DAI SDK 不支持或不会向广告素材发送以下消息：

  • resize
  • appBackgrounded
  • appForegrounded
  • log

查看媒体状态更新

DAI SDK 会针对以下事件向广告素材发送 mediaStateUpdate 消息：

  • play
  • pause
  • stalled（正在缓冲）
  • seeking
  • seeked
  • timeupdate（定期）
  • volumechange（包括静音状态）

DAI SDK 不支持以下事件，并且在发生这些事件时不会发送媒体状态更新：

  • ended
  • durationchange
  • error