乐橙云开发文档
控制台
更新日志
开始使用
核心概念
开发指南
设备能力与事件参考
API 参考
SDK 与工具
行业方案
平台与支持
控制台
更新日志
前往官网
快速入门
  • 开始使用
  • 核心概念
  • 开发指南
  • 设备能力与事件参考
  • API 参考
  • SDK 与工具
    • Android SDK
    • iOS SDK
    • 鸿蒙 SDK
    • PC SDK
    • 轻应用组件 ImouPlayer
    • 小程序插件与半屏小程序
    • 图片解密组件
    • 视频下载工具
      • 使用与集成
      • 排障
    • 服务端示例与签名工具
    • Postman 集合
    • 资源下载
  • 行业方案
  • 平台与支持
本页目录
步骤
相关参考

排障

排障

与资源包 docs/DEVELOPER.md 故障排查节一致。接口错误码见 createVideoDownloadStreamUrl。

步骤

对照下表定位后,再用创流得到的 RTSP 做独立拉流验证。

现象可能原因建议
创流 code != "0"token、设备、权限、参数看 result.msg;对照接口错误码
解密失败token 与创流请求不一致必须使用同一 params.token
FFmpeg 数秒内 End of file / Invalid data录像无片源、RTSP 已失效换 real 对比;确认 begin/end 有录像;创流后尽快拉流
Error parsing AU headersRTSP AAC 封装与解析差异多数可忽略,看是否仍能出 MP4
aac_adtstoasc 初始化失败或 exit -22误用视频 BSF,或无 AAC 时仍强制音频 BSF当前 Demo 仅 -bsf:a aac_adtstoasc,勿链式 hevc/h264
最后一片无法播放墙钟到点强杀进程向 stdin 发 q 并等待收尾
拉流超过设定总时长旧版用流时间戳当停表使用当前资源包(墙钟 stop)
桌面版未找到 FFmpeg安装包不完整或开发构建未校验 sidecar确认安装完整;源码构建先 npm run verify-sidecars
CLI 找不到 FFmpeg缺少 binaries/ 或 OS 不匹配确认 ffmpeg-x86_64-pc-windows-msvc.exe 或 Linux 对应文件;Linux chmod +x
输出路径异常 / 中文目录失败混用 \ 与 /,或非 UTF-8 配置用系统路径拼接;配置文件 UTF-8
录制弹出黑色控制台旧版未隐藏 FFmpeg 窗口换当前资源包

独立验证 RTSP(创流并解密后立即):

ffplay -rtsp_transport tcp "rtsp://..."
# 或
ffmpeg -rtsp_transport tcp -i "rtsp://..." -t 5 -f null -

若同样 EOF,问题在流侧而非本工具。

相关参考

  • 使用与集成
  • createVideoDownloadStreamUrl
  • 资源下载

商务合作:cloud_openteam@imou.com · 工单 · 获取帮助(公众号、小程序试用中心)

Copyright © 2015-2026 IMOU. All Rights Reserved. 浙ICP备16023676号

使用与集成
服务端示例与签名工具