upyun-av-pretreatment

upyun 音视频处理 SDK

Install

$ npm install upyun-av-pretreatment

Example

var UpYunAV = require('./');

var client = new UpYunAV(yourbucket, operator, password);
var tasks = [
    {
        type: 'hls',
        hls_time: 6,
        bitrate: '500',
        rotate: 'auto',
        format: 'mp4'
    },
    {
        type: 'thumbnail',
        thumb_single: false,
        thumb_amount: 100,
        format: 'png'
    }
];

client.pretreatment('/video/20130514_190031.mp4', {
    bucket_name: yourbucket,
    tasks: new Buffer(JSON.stringify(tasks)).toString('base64'),
    notify_url: 'http://example.com/'
}, function(err, result) {
    console.log(arguments);
});

API

初始化 UpYunAV(yourbucket, operator, password)

• yourbucket: 空间名称
• operator: 操作员名称
• password: 操作员密码

处理 API .pretreatment(path, config, callback)

• path: 待处理的视频文件路径
• config: 处理参数
  • bucket_name: 所在空间名称
  • tasks：提交的任务数据，base64处理之后的字符串
  • notify_url: 异步回调地址，在处理完成之后将会进行异步通知
  • source: 待处理源文件路径

其中 task 通过下面三个步骤生成：

1. 组装业务参数；
2. 将业务参数转换为JSON字符串；
3. 对第二步生成的字符串进行 base64 encode 处理。

每次请求可以针对同一个文件提交最多10个处理任务

处理参数

又拍云的音视频处理服务目前支持三种类型的处理请求：

• 普通视频转码
• HLS切割
• 视频截图

1. 视频转码

| 参数 | 参数类型 | 必选 | 参数说明 | |-------------------|----------|-------|--------------------------------------------------------------------------------------------------------------| | type | string | true | 处理类型，进行视频转码时值必须为 video | | bitrate | integer | false | 视频比特率，单位kbit，未传递是按照视频原始比特率处理 | | scale | string | false | 视频分辨率，格式 "1024:768" ，不传递时按照原始分辨率处理 | | auto_scale | boolean | false | 是否根据分辨率自动调整视频长宽比例，仅当传递了 scale 参数时有效 | | frame_rate | ingeger | false | 设置帧率，每秒显示的帧数，常用帧率："24"、"25"、"30"等， 未传递时按照原始帧率处理 | | rotate | string | false | 旋转角度，默认按照原始视频角度处理 | | map_metadata | boolean | false | 是否保留视频meta信息，默认值 true | | disable_audio | boolean | false | 是否禁掉音频，默认 false | | disable_video | boolean | false | 是否禁掉视频，默认 false | | format | string | false | 视频输出格式，支持 mp4/flv，默认按照原始格式输出 | | accelerate_factor | float | false | 设置视频加速的倍数，取值范围［1.0， 10.0］这个值是一个浮点数，可以是"2.5"，表示加速2.5倍 | | save_as | string | false | 转码后输出的文件保存路径（同一个空间下），如果没有传递，会根据请求的参数生成一个文件名保存在原始文件同目录下 |

2. HLS转码切割

HLS 转码切割处理除了 hls_time 之外其他参数与普通视屏转码一致

| 参数 | 参数类型 | 必选 | 参数说明 | |----------|----------|------|---------------------------------------| | type | string | true | 处理类型，进行hls切片时值必须为 hls | | hls_time | integer | true | 指定切割的时间片长度 |

3. 视频截图

| 参数 | 参数类型 | 必选 | 参数说明 | |--------------|----------|-------|---------------------------------------------------------------| | type | string | true | 处理类型，截图时值必须为 thumbnail | | thumb_single | boolean | true | 是否仅截取单张图片，默认值 true | | thumb_amount | integer | false | 截图数量，当 thumb_single 参数的值为 false 是，本参数为必须 | | thumb_start | string | false | 截图开始时间，格式为 "00:04:13"，默认值为 "00:00:00" | | thumb_end | string | false | 截图结束时间，格式为 "00:04:13"，默认值为视频结束时间 | | thumb_scale | string | false | 截图尺寸，格式为 "1024:768"，默认值为视频原始尺寸 | | thumb_format | string | false | 截图输出格式，支持 png/jpg 格式，默认 jpg |

返回数据

成功提交处理请求之后，接口会针对每个提交的处理任务返回唯一的task_id，可以根据这个 task_id 查询处理进度。

特别地，返回的 task_id 的顺序与提交的任务参数 tasks 里的匹配对应。

[
    '35f0148d414a688a275bf915ba7cebb2',
    '98adbaa52b2f63d6d7f327a0ff223348',
    ...
]