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

文档级别：UC影音_转换脚本使用文档目 录UC影音_转换脚本使用文档目 录0目 录11 概述21.1 背景21.2 软件说明21.3 术语解释22 使用说明22.1 运行环境22.2 使用步骤22.3 支持的输入格式32.3.1 视频32.3.2 音频33 命令行参数定义33.1 -p 方案参数（可省略）33.2 -u url目录地址（必须）43.3 -o 输出目录（可省略）43.4 -t 指定标题（可省略）43.5 -md5 MD5文件名（可选）43.6 -novideo 纯音频转换（可选)44 其他功能54.1 画面裁剪54.2 转换完成生成UCS文件54.3 转换成功返回参数65 参考文档6修订纪录修订时间内容摘要作者（说明：对外文档中无需修订纪录）1 概述1.1 软件说明新的转换工具使用脚本语言（Python）编写简单需求代替旧的转换工具，因此新的转换工具又成为转换脚本。转换脚本只有在线转换而简化了原来的本地转换功能，所以转换之后均包括有转换后的视频文件和对应的ucs文件。虽然如此，把ucs忽略的话，转换后的视频文件亦可本地播放，所以转换脚本仅仅把两者合二为一。转换脚本里面包含用Python文件和tools目录，解压缩即可使用，无需安装。2 使用说明2.1 运行环境电脑上需安装Python2.5或以上版本，否则将无法使用转换脚本。2.2 使用步骤1. 在命令行cd到转换脚本所在路径2. 在命令行输入 python main.py来运行转换脚本，运行成功后会看到转换脚本的版本和帮助信息，如图。3. 转换的命令是main.py options -u http:/xx/ filename。其中options是对视频的转换配置要求，具体参数定义请看3.命令行参数定义。-u是指ucs种子里面的url地址，此参数为必填且输入正确才能成功连接播放。但是若仅仅用作本地转换功能，-u里面的url地址可以忽略其正确性。Filename是指待转换的视频文件所在地址。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影音进入纯音频播放模式播放，有频谱等显示。3 命令行参数定义3.1 -p 方案参数（可省略）1. 0 代表流畅版，1 代表清晰版，2 代表Q屏版。例如清晰版 -p 12. 每次只能制定一个方案，如果需要转换多个方案，需要重复运行脚本3. 方案不存在, 例如-p 4，4这个方案不存在，提示profile error,脚本退出，返回错误码。4. 若省略，默认为-p 0 （流畅版）3.2 -u url目录地址（必须）1. 指定的是url目录地址，通过加入文件名生成最终文件url。例如-u目录地址是 /youku/，转换生成的文件名是news.flv那么生成的ucs的url应该是/youku/news.flv2. 这个参数生成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文件名便不相同。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 字段指定文件名 4. url 字段指明播放的正确地址 5. title 字段指明标题 6. size 字段指明文件大小 7. duration 字段指明视频时长 4.3 转换成功返回参数1. 格式为 duration=xxx:fn_count=xxx，例如duration