查看 SIMID 支持

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

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

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

消息	说明
clickThru	根据广告素材提供的 URI 处理广告点击。
fatalError	终止广告会话并报告广告素材中的严重错误。
getMediaState	返回媒体播放器的当前状态，包括 URI、currentTime、duration、volume 和 muted 状态。
log	将广告素材日志消息转发给 IMA SDK 以进行调试。
reportTracking	请求 IMA SDK 代表广告素材 ping 跟踪网址。
requestChangeAdDuration	请求修改广告会话的总时长。
requestNavigation	请求导航到外部 URI。
requestPause	请求 IMA SDK 暂停媒体播放器。
requestPlay	请求 IMA SDK 恢复或播放媒体播放器。
requestResize	请求调整视频播放器的大小。如果播放器允许调整大小，IMA SDK 会调整播放器的大小。
requestSkip	请求 SDK 跳过当前广告。
requestStop	请求 SDK 停止广告会话。
handleSkipShown	通知 IMA SDK 广告素材已显示广告跳过界面。
requestFocus	请求广告素材的 iframe 获得焦点。

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

IMA SDK 不处理以下 CreativeMessage 类型：

• requestChangeVolume
• requestFullscreen
• requestExitFullscreen

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

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

消息	说明
init	在会话设置期间发送，包含环境数据和广告参数。
startCreative	通知广告素材启动并显示广告素材 iframe。
adStopped	通知广告会话已结束，包括原因代码。
adSkipped	通知广告素材用户或 IMA SDK 跳过了广告。
resize	通知广告素材播放器或视频尺寸发生了变化。
appBackgrounded	通知广告素材应用已进入后台。
appForegrounded	通知广告素材应用已返回到前台。
fatalError	通知广告素材播放器端发生了错误。
log	将日志消息从播放器发送到广告素材。
focusIn	通知广告素材已获得焦点。

查看媒体状态更新

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

• play
• pause
• stalled（正在缓冲）
• seeking
• seeked
• ended
• durationchange
• timeupdate，定期发送。
• volumechange，包括静音状态。