如何基于OSS和MPS,快速搭建音视频文件上传服务?

背景

本文主要介绍如何基于OSS服务和MPS的上传SDK,快速搭建一个音视频文件上传服务。

优势

使用MPS的上传SDK上传音视频文件,具有以下优势:

  • 增加文件列表管理功能。
  • 增加STS Token 超时更新功能。
  • 增加上传过程中网络抖动时的自动重试功能。
  • 文件断点续传功能。
  • 自动触发MPS服务的媒体工作流。
  • 配置媒体标题、标签、描述、类目、封面URL、等功能。

注意:

  1. 断点续传的限制条件:不允许跨生命周期。JS端页面不能刷新、关闭,android/iOS不能关闭APP、手机。
  2. 同一本地文件只能上传一次。

上传服务架构图

_1

服务端搭建

考虑移动端AK安全性问题,选用STS的方式上传文件。关于STS如何增加上传的安全性,请参考RAM和STS使用指南

STS开通流程

  1. 开通OSS服务,创建Bucket,并登录OSS控制台
  2. 在OSS概览页中找到基础配置区域,单击 安全令牌,如下图所示:
    _2
  3. 进入到 安全令牌快捷配置 页面。
    _3
  4. 系进行自动授权,请务必保存下图中三个红框内的参数。单击保存AK信息后,对话框会关闭,STS的开通完成。
    _4

_5

搭建一个应用服务器

应用服务器示例的配置

为了方便开发,本教程提供了三个语言的版本示例程序供您下载。

Java: 下载地址
PHP: 下载地址
Ruby: 下载地址

每个语言包下载下来后,都会有一个配置文件config.json如下所示:

{
    "AccessKeyID" : "",
    "AccessKeySecret" : "",
    "RoleArn" : "",
    "TokenExpireTime" : "900",
    "PolicyFile": "policy/all_policy.txt"
}

说明:

  1. AccessKeyID: 填写上述图标红的参数1的内容。
  2. AccessKeySecret: 填写上述图标红的参数2的内容。
  3. RoleArn: 填写上述图标红的参数3的内容。
  4. TokenExpireTime: 指Android/iOS应用取到这个Token的失效时间,注意,最少是900s,默认值可以不修改。
  5. PolicyFile: 填写的是该Token所要拥有的权限列表的文件, 默认值可以不修改。

本文档准备了三种最常用token权限文件,放于policy目录下面。分别是:

  • all_policy.txt:指定了该token拥有对该账号下创建Bucket、删除Bucket、上传文件、下载文件、删除文件的权限 。
  • bucket_read_policy.txt:指定了该token拥有该账号下对指定Bucket的读权限。
  • bucket_read_write_policy.txt: 指定了该token拥有该账号下对指定Bucket的读写权限。

如果您想要指定这个Token只能对指定的bucket有读写权限, 请把(bucket_read_policy.txt、 bucket_read_write_policy.txt)这些文件里面$BUCKET_NAME直接替换成指定的bucket名字。

返回的格式解析:

{
    "status":200,
    "AccessKeyId":"STS.3pYjsdgdgagdasdg",
    "AccessKeySecret":"rpnwO9kvEgetGdrddgsR2YrTtI",
   "Security":"CAES+wMIARKAAZhjH0EUOIhJMQBMjRywXq7MQ/cjLYg80Aho1ek0Jm63XMhr9Oc5s3qaPer8p1YaX1NTDiCFZWFkvlHf1pQhuxfKBc+mRR9KAbHUefqH+rdjZqjTF7p2m1wJXP8S6k+G2MpHrUe6TYBkJ43GhhTVFMuM3BZajY3VjZWOXBIODRIR1FKZjIiEjMzMzE0MjY0NzM5MTE4NjkxMSoLY2xpZGSSDgSDGAGESGTETqOio6c2RrLWRlbW8vKgoUYWNzOm9zczoqOio6c2RrLWRlbW9KEDExNDg5MzAxMDcyNDY4MThSBTI2ODQyWg9Bc3N1bWVkUm9sZVVzZXJgAGoSMzMzMTQyNjQ3MzkxMTg2OTExcglzZGstZGVtbzI=",
   "Expiration":"2015-12-12T07:49:09Z",
}

说明(下面四个变量将构成了一个Token。):

  • status:表示获取Token的状态,获取成功时,返回值是200。
  • AccessKeyId: 表示Android/iOS应用初始化OSSClient获取的 AccessKeyId。
  • AccessKeySecret: 表示Android/iOS应用初始化OSSClient获取AccessKeySecret。
  • SecurityToken:表示Android/iOS应用初始化的Token。
  • Expiration: 表示该Token失效的时间。主要在Android SDK会自动判断是否失效,自动获取Token。

代码示例的运行方法:

  • 对于JAVA版本 (依赖于java 1.7),将包下载解压后

运行方法:java -jar oss-token-server.jar (port)。如果不指定port(端口), 直接运行java –jar oss-token-server.jar,程序会监听7080端口。如果想让程序执行在9000端口,运行java –jar app-token-server.jar 9000 , 其他端口也类似。

  • 对于PHP版本,将包下载解压后,修改config.json这个文件,直接运行php sts.php 即能生成Token,将程序部署到指定的地址。

使用MPS客户端SDK

客户端示例代码:

为了方便开发,本教程提供了三个语言的版本示例程序供您下载。

H5: 下载地址
Android: 下载地址
iOS: 下载地址

SDK核心代码:

JS端:

在使用JS SDK之前,先对要上传视频的OSS Bucket 已经开启了CORS访问权限。下载JS的Demo,在浏览器中打开, 在页面上进行参数配置:

  • 配置”HTTP地址”为上面配置的应用服务器地址,如http://127.0.0.1:7080/
  • 配置用户Bucket。
  • 配置Bucket的endpoint。
  • 点击选择文件,选中要上传的文件。
  • 点击开始上传按钮。
// 初始化客户端
var uploader = new VODUpload({
    // 开始上传
    'onUploadstarted': function (uploadInfo) {;},
    // 文件上传成功
    'onUploadSucceed': function (uploadInfo) {console.log("上传成功");},
    // 文件上传失败
    'onUploadFailed': function (uploadInfo, code, message) {console.log("上传失败");},
    // 文件上传进度,单位:字节
    'onUploadProgress': function (uploadInfo, totalSize, uploadedSize) {console.log("上传进度");},
    // 安全令牌超时
    'onUploadTokenExpired': function (uploadInfo) {console.log("token超时");}
});
// 获取sts信息
result = httpGet(httpServer);
stsToken = JSON.parse(result);
uploader.init(stsToken.AccessKeyId, stsToken.AccessKeySecret, stsToken.SecurityToken, stsToken.Expiration);
// 添加文件
uploader.addFile(event.target.files[i], endpoint, bucket, object, userData);
// 开始上传
uploader.startUpload();
Android端:

确保Android端已经添加如下权限:

<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>

下载Android端Demo,进行如下修改:

  • 修改MainActivity里面的serverUrl为应用服务器配置地址,如http://192.168.0.2:7080/
  • 配置用户Bucket。
  • 配置用户Bucket对应的endpoint。
  • 运行Demo,点击添加文件。
  • 点击上传,在OSS对应Bucket的uploadtest/目录下查看文件是否已经上传成功。

主要代码:

VODUploadClient uploader = new VODUploadClientImpl(getApplicationContext());
VODUploadCallback callback = new VODUploadCallback() {
    @Override
    public void onUploadSucceed(UploadFileInfo info) {;}
    @Override
    public void onUploadFailed(UploadFileInfo info, String code, String message) {;}
    @Override
    public void onUploadProgress(UploadFileInfo info, long uploadedSize, long totalSize) {;}
    @Override
    public void onUploadTokenExpired(UploadFileInfo info) {
        // 获取并更新 sts token。
         uploader.resumeWithToken("<accessKeyId>", "<accessKeySecret>", "<secretToken>", "<expireTime>");
    }
    @Override
    public void onUploadRetry(UploadFileInfo info, String code, String message) {;}
    @Override
    public void onUploadRetryResume(UploadFileInfo info) {;}
    @Override
    public boolean onUploadStarted(UploadFileInfo uploadFileInfo) {;}
};
// 获取sts token并初始化
uploader.init("<accessKeyId>", "<accessKeySecret>", "<secretToken>", "<expireTime>", callback);
// 添加文件
uploader.addFile("<uploadFilePath>", "<endpoint>", "<bucketName>", "<objectKey>");
// 开始上传
uploader.start();
iOS端:

下载iOS端Demo,进行如下修改:

  • 修改VODUploadDemo.m里面的serverUrl为应用服务器配置地址,如http://192.168.0.2:7080/
  • 配置用户Bucket。
  • 配置用户Bucket对应的endpoint。
  • 运行Demo,点击添加文件。
  • 点击上传,在OSS对应Bucket的uploadtest/目录下查看文件是否已经上传成功。

主要代码:

// 回调初始化
OnUploadStartedListener testUploadStartedCallbackFunc = ^(UploadFileInfo* fileInfo) {;};
OnUploadSucceedListener testSuccessCallbackFunc = ^(NSString* filePath){;};
OnUploadFailedListener testFailedCallbackFunc = ^(NSString* filePath, NSString* code, NSString* message){;};
OnUploadProgressListener testProgressCallbackFunc = ^(NSString* filePath, long uploadedSize, long totalSize) {;};
OnUploadTokenExpiredListener testTokenExpiredCallbackFunc = ^{
    // 获取并更新sts token
    [uploader resumeWithToken:<accessKeyId>
          accessKeySecret:<accessKeySecret>
          secretToken:<secretToken>
          expireTime:<expireTime>]
};
OnUploadRertyListener testUploadRertyListener = ^{;};
OnUploadRertyResumeListener testUploadRertyResumeListener = ^{;};
VODUploadListener *listener;
listener = [[VODUploadListener alloc] init];
listener.started = testUploadStartedCallbackFunc;
listener.success = testSuccessCallbackFunc;
listener.failure = testFailedCallbackFunc;
listener.progress = testProgressCallbackFunc;
listener.expire = testTokenExpiredCallbackFunc;
listener.retry = testUploadRertyListener;
listener.retryResume = testUploadRertyResumeListener;
// 获取Token
// 上传客户端初始化
VODUploadClient *uploader;
[uploader init:<accessKeyId>
          accessKeySecret:<accessKeySecret>
          secretToken:<secretToken>
          expireTime:<expireTime>
          listener:listener];
// 添加文件
[uploader addFile:<uploadFilePath>
        endpoint:<endpoint>
        bucket:<bucketName>
        object:<objectKey>];
// 开始上传
[uploader start];
以下Java示例代码演示了如何在服务端上传媒资文件至视频点播,媒资类型支持音频、视频和图片。 * <p> * 一、音视频上传目前支持4种方式上传: * * 1.上传本地文件,使用分片上传,并支持断点续传,参见testUploadVideo函数。 * 1.1 当断点续传关闭时,最大支持上传任务执行时间为3000秒,具体可上传文件大小与您的网络带宽及磁盘读写能力有关。 * 1.2 当断点续传开启时,最大支持48.8TB的单个文件,注意,断点续传开启后,上传任务执行过程中,同时会将当前上传位置写入本地磁盘文件,影响您上传文件的速度,请您根据文件大小选择是否开启 * * 2.上传网络流,可指定文件URL进行上传,支持断点续传,最大支持48.8TB的单个文件。 * 该上传方式需要先将网络文件下载到本地磁盘,再进行上传,所以要保证本地磁盘有充足的空间。参见testUploadURLStream函数。 * * 3.上传文件流,可指定本地文件进行上传,不支持断点续传,最大支持5GB的单个文件。参见testUploadFileStream函数。 * * 4.流式上传,可指定输入流进行上传,支持文件流和网络流等,不支持断点续传,最大支持5GB的单个文件。参见testUploadStream函数。 * <p> * * 二、图片上传目前支持2种方式上传: * 1.上传本地文件,不支持断点续传,最大支持5GB的单个文件,参见testUploadImageLocalFile函数 * 2.上传文件流和网络流,InputStream参数必选,不支持断点续传,最大支持5GB的单个文件。参见testUploadImageStream函数。 * 注:图片上传完成后,会返回图片ID和图片地址,也可通过GetImageInfo查询图片信息,参见接口文档 https://help.aliyun.com/document_detail/89742.html * <p> * * 三、m3u8文件上传目前支持2种方式: * 1.上传本地m3u8音视频文件(包括所有分片文件)到点播,需指定本地m3u8索引文件地址和所有分片地址。 * 2.上传网络m3u8音视频文件(包括所有分片文件)到点播,需指定m3u8索引文件和分片文件的URL地址。 * * 注: * 1) 上传网络m3u8音视频文件时需要保证地址可访问,如果有权限限制,请设置带签名信息的地址,且保证足够长的有效期,防止地址无法访问导致上传失败 * 2) m3u8文件上传暂不支持进度回调 * <p> * * 四、上传进度回调通知: * 1.默认上传进度回调函数:视频点播上传SDK内部默认开启上传进度回调函数,输出不同事件通知的日志,您可以设置关闭该上传进度通知及日志输出; * 2.自定义上传进度回调函数:您可根据自已的业务场景重新定义不同事件处理的方式,只需要修改上传回调示例函数即可。 * <p> * * 五、辅助媒资上传目前支持2种方式: * 1.上传本地文件,不支持断点续传,最大支持5GB的单个文件,参见testUploadAttachedMediaLocalFile函数 * 2.上传文件流和网络流,InputStream参数必选,不支持断点续传,最大支持5GB的单个文件。参见testUploadAttachedMediaStream函数。 * <p> * * 六、支持STS方式上传: * 1.您需要实现VoDRefreshSTSTokenListener接口的onRefreshSTSToken方法,用于生成STS信息, * 当文件上传时间超过STS过期时间时,SDK内部会定期调用此方法刷新您的STS信息进行后续文件的上传。 * <p> * * 七、可指定上传脚本部署的ECS区域(设置Request的EcsRegionId参数,取值参考存储区域标识:https://help.aliyun.com/document_detail/98194.html), * 如果与点播存储(OSS)区域相同,则自动使用内网上传文件至存储,上传更快且更省公网流量 * 由于点播API只提供外网域名访问,因此部署上传脚本的ECS服务器必须具有访问外网的权限。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值