跳转到主要内容
SDK 会跟随你的内容播放器:观众在剧集中的位置,以及内容是否在播放。叠加广告只在内容播放时展示,观众暂停时结束;暂停广告在内容再次播放时结束。使用 Media3 播放器时,一次调用就能把这些都交给 SDK。

添加适配器

它支持 Media3 1.1 或更高版本,并使用你应用自己的 Media3 版本:添加它不会改变你的应用解析到的 Media3。

跟随播放器

  • 任何 Media3 Player: ExoPlayer、MediaController,或你自己的 Player。
  • 主 looper: SDK 在主线程读取播放器。在其他 looper 上创建的播放器不会被跟随(日志中有错误),内容视为未在播放。
  • 弱持有: SDK 绝不会让你的播放器保持存活。它在 ads.destroy() 或下一次 track 时放开。

多集共用一个播放器

大多数应用复用一个播放器并替换它的媒体项。每一集进入播放器后,用该集的 VideoAds 跟随它:
如果在 setMediaItem 之前跟随,新剧集的叠加广告和暂停广告会在 show 时抛出 Invalidated(ContentChanged):SDK 把上一个媒体项当成了这一集的。在 setMediaItem 之后再次跟随即可正常展示。

SDK 读取什么

适配器监听播放器自己的回调,因此观众一暂停叠加广告就会结束。

播放器插入的广告

如果你的播放器自己也播放广告(广告加载器、服务端插入的广告),这些广告中的时间不是内容:叠加广告不会展示在它们之上,SDK 读取的位置仍是内容的位置。