gsy-live-and-ads

直播(RTMP/RTSP/HLS)、贴片广告 (PreRoll AD)、静音、切码率、无缝切源、切换过程保留最后一帧。

SKILL.md

GitHub

gsy-live-and-ads

直播接入要点

  • setUp(url, false, title) —— cacheWithPlay 必须 false。
  • onResume / player.onVideoResume(false):seek=false 避免拉流跳变(见 GSYVideoView#L549)。
  • 内核选择:
    • RTMP / RTSP:必须 IJK;System / Exo / Aliyun 各有兼容性差异。
    • HLS:Exo 更稳;Ijk 需要开启硬解 GSYVideoType.enableMediaCodec() 才顺。
  • 关键参数:
    • builder.setNeedShowWifiTip(false)(后台 App 不打断)
    • builder.setReleaseWhenLossAudio(false)(丢音频焦点不释放)
    • builder.setSurfaceErrorPlay(true)

对 IJK 加 low-latency:通过 VideoOptionModel 注入 ffmpeg option,见 BasePlayerManager 与 GSYVideoManager.instance().setOptionModelList(list)。常用 option:analyzemaxduration=100、probesize=10240、flush_packets=1、fflags=nobuffer、packet-buffering=0、framedrop=1。

广告 AD

  • 双 Manager 双 Player:GSYVideoADManager.instance() 负责广告 player,GSYVideoManager.instance() 负责主片;两者共存不打架。
  • 组件 GSYADVideoPlayer 与"广告示例"GSYSampleADVideoPlayer 都继承 StandardGSYVideoPlayer。
  • Activity 基类:GSYBaseADActivityDetail,提供 getGSYVideoADPlayer() / initADVideo() / startAD(String adUrl, String url) / onADEnd。

startAD(...) 关键调用序

  1. Activity 里持有主 player + AD player 两个 View;
  2. initADVideo() 装配(内部会连锁 OrientationUtils);
  3. startAD(adUrl, mainUrl) 播广告;
  4. AD complete → SDK 内部隐藏 AD player、start 主 player;
  5. 用户点"跳过"→ getGSYVideoADPlayer().onAutoCompletion()。

无缝切源 / 切码率

Exo 内核用 Exo2PlayerManager.setCurrentMediaSource(...) 或 Demo 里的 GSYExo2MediaPlayer.setMediaSources(...);Ijk 则重新 setUp + startPlayLogic。切换的过程中要求"不闪黑",用:

广告 / 主片全屏切换的两个陷阱

  • 主片全屏 → 广告插入:GSYVideoADManager 无内部 OrientationUtils;GSYBaseADActivityDetail 已处理,但自定义子类需重写 getGSYVideoADPlayer() 返回 AD player 才能被基类的旋转/回退纳管。
  • 广告全屏返回 → 直接销毁 AD player:onBackPressed 需要判断 GSYVideoManager.backFromWindowFull(this) || GSYVideoADManager.backFromWindowFull(this)。

Demo 对照

v14.0.0 RTSP 与倍速

  • FORMAT timeout 为微秒(20_000_000L = 20 秒),明确配置的 rtsp_transport 会透传。
  • PLAYER rtsp-live-max-buffer-ms 在 prepare 前设置,0 关闭,500..60000 毫秒用于正常 1× 直播队列恢复。恢复会丢弃旧媒体并产生跳跃/音频间隙,不是自动重连。
  • 初始化重定向覆盖 OPTIONS/DESCRIBE/SETUP/首次 PLAY;不支持播放中 REDIRECT 或任意跨端口控制会话。
  • soundtouch=1 为 0.25×–4× 软件变速;soundtouch=0 为设备相关平台范围。引擎切换和 EOF 按真实音频排空处理,终止错误后需要 reset 或重建。
  • 详见 QUESTION.md 与 v14 发布说明。

常见坑

  • 直播卡顿升级 → 检查是否开启 cacheWithPlay(对直播来说必须关)。
  • 广告 onAutoComplete 后主片没自动 setUp → 检查是不是把 setStartAfterPrepared(false) 传给了主 builder。
  • RTMP 断流回收后重连白屏 → onVideoResume(false) + player.getCurrentPlayer().onVideoReset() 再 startPlayLogic()。