UCV视频转换器使用文档.doc

北京 广州 武 汉 手机上网用UC移动生活好伴侣 UC 影音 转换脚本使用文 档 文档级别 1北京 广州 武 汉 手机上网用UC移动生活好伴侣 目 录 0 UC 影音 转换脚本使用文档目 录 0 目 录 1 1 概述 2 1 1 软件说明 2 2 使用说明 2 2 1 运行环境 2 2 2 使用步骤 6 2 3 支持的输入格式 7 2 3 1 视频 7 2 3 2 音频 7 3 命令行参数定义 8 3 1 p 方案参数 可省略 8 3 2 u url 目录地址 必须 8 3 3 o 输出目录 可省略 8 3 4 t 指定标题 可省略 8 3 5 md5 MD5 文件名 可选 8 3 6 novideo 纯音频转换 可选 8 4 其他功能 9 4 1 画面裁剪 9 4 2 转换完成生成 UCS 文件 9 4 3 转换成功返回参数 10 5 使用示例 10 文档级别 2北京 广州 武 汉 手机上网用UC移动生活好伴侣 修订纪录 修订时间内容摘要作者 说明 对外文档中无需修订纪录 1 概述概述 1 1 软件说明软件说明 新的转换工具使用脚本语言 Python 编写简单需求代替旧的转换工具 因此新的转换 工具又成为转换脚本 转换脚本只有在线转换而简化了原来的本地转换功能 所以转换之后 均包括有转换后的视频文件和对应的 ucs 文件 虽然如此 把 ucs 忽略的话 转换后的视频 文件亦可本地播放 所以转换脚本仅仅把两者合二为一 转换脚本里面包含用 Python 文件和 tools 目录 解压缩即可使用 无需安装 2 使用说明使用说明 2 1 运行环境运行环境 操作系统 Windows XP Python 版本 2 5 2 7 Python 安装步骤 一 从 http www python org ftp python 网站上根据操作系统下载 Python 安装程序 如 Windows XP 32 位操作系统下载 python 2 5 4 msi 二 右击下载下来的文件 然后在弹出的菜单中单击 安装 I 进行 Python 的安 装如 图 1 图 1 三 出现 图 2 的界面后单击 Next 文档级别 3北京 广州 武 汉 手机上网用UC移动生活好伴侣 图 2 四 出现 图 3 的界面后选择或输入 Python 的安装目录 如默认安装到 C Python25 这个目录 然后单击 Next 文档级别 4北京 广州 武 汉 手机上网用UC移动生活好伴侣 图 3 五 出现 图 4 的界面后单击 Next 此处不需要做修改 按照默认设置即可 图 4 六 出现 图 5 的界面后单击 Finish 即可完成安装 文档级别 5北京 广州 武 汉 手机上网用UC移动生活好伴侣 图 5 七 完成 Python 的安装后 单击 开始 运行 在出现的界面中输入 cmd 命令 如 图 6 后单击 确定 图 6 八 在出现的控制台窗口 以下简称命令行 中进行如 图 7 中所示的操作 如 果能出现 2 就代表 Python 安装成功 其中 C Python25 为图 3 中 Python 的安 装目录 图 7 九 下面把 Python 的安装目录添加到系统变量中以便在非 Python 的安装目录下也 能使用 Python 在桌面上右击 我的电脑 在弹出的菜单上单击 属性 在弹出的对话框中单击 高级 标签 单击 环境变量 N 按钮 在弹出 的对话框中选择 系统变量 S 中的 Path 项 单击 编辑 I 按钮 在 弹出的对话框中的 变量值 V 右边的文本框中的末尾添加一个分号后再 添加 Python 的安装目录如 C Python25 单击 确定 单击 确定 单击 确定 如 图 8 文档级别 6北京 广州 武 汉 手机上网用UC移动生活好伴侣 图 8 2 2 使用步骤使用步骤 1 解压下载下来的 UCV 视频转换器程序包 pyConv 20100925 zip 中 pyConv 20100925 1 目录下的 pyConv 到 D 盘 2 在命令行 cd 到转换脚本所在路径 如图 9 3 在命令行输入 python main py 来运行转换脚本 运行成功后会看到转换脚本的 版本和帮助信息 如图 9 文档级别 7北京 广州 武 汉 手机上网用UC移动生活好伴侣 图 9 4 转换的命令是 main py options u http xx filename 或 python main py options u http xx filename 其中 options 是对视频的转换配置要求 具体参数 定义请看 3 命令行参数定义 u 是指 ucs 种子里面的 url 地址 此参数为必填且输 入正确才能成功连接播放 但是若仅仅用作本地转换功能 u 里面的 url 地址可以 忽略其正确性 filename 是指待转换的视频文件的全路径 如需要转换 C 盘下的 偏爱 mp3 这个文件 则 filename 为 C 偏爱 mp3 且是最后一个参数 2 3 支持的输入格式支持的输入格式 2 3 1 视频 支持的视频格式有 avi mkv mp4 asf flv f4v mov wmv rmvb rm 3gp 和 3gpp 不支持的格式暂时不能辨别 也不会返回错误 2 3 2 音频 支持的音频格式有 mp3 aac apc ape wma flac mp2 mpc ogg wav 和 ra 自动检测以上后缀名 自动进入纯音频转换模式 纯音频转换模式生成的文件 UC 影音进入纯音频播放模式播放 有频谱等显示 文档级别 8北京 广州 武 汉 手机上网用UC移动生活好伴侣 3 命令行参数定义命令行参数定义 3 1 p 方案参数 可省略 方案参数 可省略 1 0 代表流畅版 1 代表清晰版 2 代表 Q 屏版 例如清晰版 p 1 2 每次只能制定一个方案 如果需要转换多个方案 需要重复运行脚本 3 方案不存在 例如 p 4 4 这个方案不存在 提示 profile error 脚本退出 返回错误 码 4 若省略 默认为 p 0 流畅版 3 2 u url 目录地址 必须 目录地址 必须 1 指定的是 url 目录地址 通过加入文件名生成最终文件 url 例如 u 目录地址是 news flv 那么生成的 ucs 的 url 应该是 2 这个参数生成 ucs 的 url 字段 在线视频播放需要用到 3 必填参数 若仅用于本地转换 仍然需要填写但是可以忽略 u 目录地址的正确的 3 3 o 输出目录 可省略 输出目录 可省略 1 o 指定转换后的输出目录 所有临时文件 最终生成文件都在这个目录 包括 flv ucs 2 转换过程有些临时文件 在转换完成后需要删除 最终留下 flv 和 ucs 文件 3 目录不存在 会创建 不提示 4 目录有同名文件 会被覆盖 不提示 5 若省略 默认是 ucvideo 输出目录 所有输出文件均放着这个默认目录里 3 4 t 指定标题 可省略 指定标题 可省略 1 指定 ucs 的标题 指定后 输出到 ucs 里面的 title 字段 用作在线视频播放的标题 2 若省略 默认使用源视频标记的 title 若源视频没有标记 title 则使用源视频自己 的文件名 3 支持中文输入 过滤这些特殊字符 3 5 md5 MD5 文件名 可选 文件名 可选 1 MD5 文件名是以数字和 a f 字母组成的 2 MD5 以源视频文件路径算出 只要源视频文件路径不同 MD5 文件名便不相同 文档级别 9北京 广州 武 汉 手机上网用UC移动生活好伴侣 3 6 novideo 纯音频转换 可选纯音频转换 可选 1 指定了这个参数 按音频方案只转音频 不转视频 进入纯音频转换模式 2 若不选 则默认以视频方案转换 以上参数可以随意搭配使用 转换成功后会出现 finish 的文字 例如 4 其他功能其他功能 4 1 画面裁剪画面裁剪 因为源的视频的长宽比有很多种 例如 4 3 16 9 超宽屏的 为了保持客户端播放不变 形 所以需要对不是 4 3 的视频进行裁剪和加黑边 1 超宽屏视频按 16 9 比例裁剪两边 上线留黑边 变成 4 3 的视频 2 16 9 的视频按 4 3 裁剪 视频满屏 3 小于等于 4 3 的视频 按 4 3 比例 视频满屏 4 2 转换完成生成转换完成生成 UCS 文件文件 1 mode 字段 是 0 指明是点播 2 type 字段 是 0 指明是视频 1 是音频 3 filename 字段指定文件名 文档级别 10北京 广州 武 汉 手机上网用UC移动生活好伴侣 4 url 字段指明播放文件的正确地址 5 title 字段指明标题 6 size 字段指明文件大小 7 duration 字段指明视频时长 4 3 转换成功返回参数转换成功返回参