上传

您可以使用上传SDK上传,支持Web(JavaScript)、移动(Android、iOS)

您也可以通过控制台和第三方工具上传。

功能

简单易用的API,只需指定本地文件和OSS保存位置,

断点续传、多文件队列、超大文件、网络异常事件、安全机制,

自动触发媒体工作流。

触发媒体工作流

多媒体文件成功上传到媒体工作流指定的输入bucket和路径后,会自动触发媒体工作流的执行,按照媒体工作流指定的流程进行处理。

使用上传OSS文件来自动触发媒体工作流的机制,需要满足几个条件:

  • 匹配媒体工作流

    工作流触发匹配规则,参见 新增媒体,并且工作流的转态是激活

  • 匹配文件扩展名
    触发要求必须是多媒体文件,媒体库服务是通过文件扩展名来判断的。文件或者没有扩展名(文件名中不包含扩展名分割符号”.”),或者扩展名符合下面的规则:
    • 视频

      3gp、asf、avi、dat、dv、flv、f4v、gif、m2t、m3u8、m4v、mj2、mjpeg、mkv、mov、mp4、mpe、mpg、mpeg、mts、ogg、qt、rm、rmvb、swf、ts、vob、wmv、webm

    • 音频

      aac、ac3、acm、amr、ape、caf、flac、m4a、mp3、ra、wav、wma、aiff

  • 指定媒体属性

    触发时,也可以指定媒体属性,包括:标题、标签、描述、类目、封面URL、用户自定义数据。详细的属性说明,参见 新增媒体 文档中的请求参数。

安全性

一般的使用场景是通过客户端直接上传视频文件。此时需要考虑AK在客户端保存的安全问题。泄露后,不仅风险大,而且不容易更换。所以建议客户端访问应用服务来获取,并使用 访问控制服务 提供的 安全令牌

建议流程



  1. 请求安全令牌。

    每次上传前,用户通过视频应用(App或Web形式)访问业务方的应用服务,应用服务从访问控制服务获取安全令牌(Token),然后传回给视频应用。这样即保证了安全性,还可以对用户进行身份验证和权限控制,也可以记录用户上传的历史等。

    使用安全令牌之前,需要先 设置子账号和授权

    这里提供 Java代码示例。(其他语言的使用方法参考 STS文档)。

  2. 上传文件。

    把上传SDK集成到视频应用后,可以通过获取到的Token上传文件。参见 使用说明

    • Web

      由于js文件一般放在应用或CDN的域名下,而视频文件放在OSS的域名下,JavaScript上传文件时会涉及跨域请求,需要先 设置CORS

      JavaScript

    • 移动

      Android

      iOS