查看 SIMID 支持

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

了解广告素材到玩家的消息

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

消息	说明
clickThru	根据 URI 广告素材提供的信息处理广告点击。
fatalError	终止广告会话并报告广告素材中的严重错误。
getMediaState	返回媒体播放器的当前状态，包括 URI、currentTime、时长、音量和静音状态。
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，包括静音状态。