抖音开放平台Logo
开发者文档
小程序
控制台
  • 开发教程与代码示例
  • 入门
  • 小程序框架
  • 小程序运行时
  • 自定义组件
  • 基础教程
  • 小程序登录
  • 用户登录态签名
  • 开发 web-view 组件
  • 开发 video 视频组件
  • 3分钟调通code2session
  • 在网络资源请求添加 referer 规则
  • 画布
  • 分包加载
  • 流加载
  • 小程序webhook
  • 多线程 Worker
  • 播放加密视频
  • 视频诊断工具
  • 实现转发和挂载
  • 获取页面节点信息
  • 响应显示区域变化
  • 敏感数据处理
  • 能力教程
  • 性能优化
  • 安全

    • 视频诊断工具
    收藏
    我的收藏

    视频诊断工具用于辅助开发者排查、解决视频组件相关问题。

    使用方式

    从小程序控制台进入指定小程序，选择「运营 > 反馈中心 > 用户反馈」，即可查看用户反馈。
    从抖音 30.3.0 开始，每一条 7 天内的视频相关反馈，可以通过点击「更多信息 > 视频诊断信息」查看诊断结果。
    视频诊断信息中，展示了可能存在的视频问题、排查定位问题相关的信息或排查思路、建议处理方案。开发者可以根据提供的诊断信息，完成相关视频问题的自查和修复，从而提升用户的观看体验。
    ​

    视频问题诊断

    目前已支持以下视频问题的诊断：

    视频组件宽度/高度为 0

    诊断结果
    排查思路
      1.检查是否有使用 tt.getSystemInfo 、tt.getSystemInfoSync 返回的信息来设置视频组件宽度或高度，由于这两个接口需要在 Page.onReady 后进行调用，过早的调用可能会导致获取到的系统信息不准确，从而导致最终设置的视频高度、宽度为 0，从而引起黑屏、白屏、有声音无画面等问题。
      2.检查是否最终设置的视频组件高度或宽度为 0 。
    ​

    内存/ CPU 占用过高引起的播放问题

    诊断结果
    排查思路
      1.检查页面中是否同时渲染了 3 个以上视频组件，由于视频播放会占用比较多的资源，建议不要同时渲染超过 3个以上的视频，如有需要，可以先用图片或其他内容替代，等到需要播放时，再渲染视频组件。
      2.检查小程序是否有其他可能的导致内存或 CPU 占用过高的使用方式，可结合列举的小程序页面和客户端性能分析工具进行排查。
    ​

    用户网络环境差引起的播放问题

    诊断结果
    排查思路
    用户侧网络差引起的播放问题，可以通过适当降低视频码率或视频清晰度减少相关问题反馈。

    视频资源问题引起的播放异常

    诊断结果
    排查思路
      1.视频资源 4xx 问题：检查列举的视频资源是否存在 4xx 问题，若存在，可更新为可以正常访问的视频资源。
      2.视频资源为空问题：检查列举的小程序页面中，是否存在设置空的视频资源的使用方式。
    ​

    视频码率过高引起的卡顿/黑屏问题

    诊断结果
    排查思路
    检查列举的相关视频资源中是否存在码率过高的问题，若存在，可适当的降低视频码率。
    ​
    ​