#6397 无法导入音、视频素材

无法导入音视频素材通常由以下几个原因导致：

1. 文件格式不支持：请先确认文件扩展名属于受支持范围

   • 视频：mp4/mov/avi/mkv/webm/mpeg/ogg/mts/ts/wmv/flv
   • 音频：wav/mp3/m4a/flac/aac/wma/ogg
2. 文件路径或文件名不规范：路径或文件名包含中文、空格、表情、特殊符号时，底层 FFmpeg 工具容易解析失败。请将视频移动到全英文数字的浅层目录（如 D:\videos\test.mp4），并重命名为简洁名称。
3. 视频文件无音轨或已损坏：某些从网站在线下载的视频画面与声音流是分离的，合并出错时视频中没有 Audio 轨道。请先用播放器本地播放确认该视频是否有声音。
4. 特殊视频编码格式：如 AV1 编码可能导致 FFmpeg 无法正确提取音频流，可先用其他工具将视频转成标准 H.264/MP4 再导入。
5. 软件自身解压路径异常：请确保软件安装在纯英文数字路径（如 D:\pyVideoTrans），不要放在含中文或空格的目录中。

如果以上方法仍未解决，请提供：

• 软件左上角的版本号（必须是 v4.08-0802 或更高）
• 软件安装目录/logs/ 中最新日志文件底部约30行报错内容
• 具体提示的错误信息或截图

怎么更新

两种方式更新，请根据你的使用方式选择：

Windows 预打包版（双击 sp.exe 使用）

1. 前往官网下载页面：https://pyvideotrans.com/downpackage，下载最新的 补丁包（约300MB）或 完整版（约2.7GB）。

2. 如果你下载的是补丁包：

   • 先将压缩包解压，得到若干更新文件；
   • 将这些文件覆盖到软件主目录（即 sp.exe 所在目录），提示覆盖时选择“全部替换”。

3. 如果你下载的是完整版：

   • 解压到新的纯英文路径（如 D:\pyVideoTrans），将你原来软件的配置迁移过去（见下方注意事项），或直接使用新目录。
4. 启动 sp.exe 即可。

注意事项：

• 你的 API Key、配音角色等配置保存在 软件目录/videotrans/ 下的 params.json、cfg.json 文件中。补丁包不包含这些文件，覆盖后配置会自动保留，无需重新配置。
• 如果担心配置丢失，覆盖前可将 videotrans/ 下所有 .json 文件复制到别处备份。
• 覆盖时不要删除 videotrans/ 文件夹内的 json 文件，否则配置会重置。
• 解压路径不要含有中文、空格或特殊符号，例如不要放在 D:\视频 软件\pyVideoTrans。

源码部署版（MacOS / Linux / Windows 命令行）

在源码目录下执行：

git pull
uv sync
uv run sp.py

这样即可获取最新代码并更新依赖。

请查阅相关文档：

• 下载软件
• 版本更新记录