【视频点播最佳实践】使用OSS SDK上传视频到点播

摘要：场景点播上传SDK缺乏需要的语言版本（如C/C++、Go等）或相应的功能（如网络流上传、追加上传），可以直接使用OSS的SDK进行上传。准备工作确认已开通点播服务并完成了相关配置。确认已准备了阿里云账号AK，并授予了上传权限。

场景

点播上传SDK缺乏需要的语言版本（如C/C++、Go等）或相应的功能（如网络流上传、追加上传），可以直接使用OSS的SDK进行上传。

准备工作

确认已开通点播服务并完成了相关配置。
确认已准备了阿里云账号AK，并授予了上传权限。

上传步骤

图片描述

一、访问点播服务获取上传地址和上传凭证。

这一步还会创建视频媒资记录，返回视频ID，请妥善保存，后续可根据视频ID进行视频播放、管理和AI处理等。

二、对上传地址（UploadAddress）和上传凭证（UploadAuth）分别进行Base64解析，得到OSS的上传地址和授权信息。

UploadAddress字段Base64解码后，得到JSON格式字符串，包含字段如下：

图片描述

UploadAuth字段Base64解码后，得到JSON格式字符串，包含字段如下：

图片描述

三、调用OSS SDK将视频文件上传至指定的bucket中，注意使用STS Auth方式，且使用UploadAddress和UploadAuth进行初始化，不要使用自己的AK等信息。

代码实现

核心代码实现共分4步：

1.使用AK初始化VOD客户端
2.获取视频上传地址和凭证
3.使用上传凭证和地址初始化OSS客户端
4.上传本地文件

可以使用点播服务的接口SDK（Java、PHP、Python、.NET），或API（接口说明、调用示例）获取上传地址和凭证。

使用OSS SDK在服务端上传，目前支持如下版本：
OSS-Java-SDK、OSS-PHP-SDK、OSS-Python-SDK、OSS-C-SDK、OSS-Go-SDK、OSS-Ruby-SDK、OSS-.NET-SDK

客户端上传建议使用VOD的上传SDK：VOD-Android-SDK、VOD-iOS-SDK、VOD-JavaScript-SDK；客户端上传时需要在服务端获取上传地址和凭证下发给客户端，以确保数据安全。

PHP上传示例

环境准备

PHP 5.3+，可通过php -v命令查看当前的PHP版本。
cURL 扩展，可通过php -m命令查看curl扩展是否已经安装好。

安装

1.在您的PHP项目中添加空文件夹 aliyun-php-sdk。

2.从 aliyun-openapi-php-sdk 下载整个源码，解压后拷贝 aliyun-php-sdk-core 和 aliyun-php-sdk-vod 两个文件夹到 aliyun-php-sdk 目录下。

3.从 aliyun-oss-php-sdk 下载最新的OSS PHP SDK的源码，解压ZIP文件后添加文件夹到 aliyun-php-sdk 目录下。以下载 v.2.2.4 Source code (zip) 为例，解压后文件夹为 aliyun-oss-php-sdk-2.2.4。

4.打开 aliyun-php-sdk/aliyun-php-sdk-core/Config.php 文件，找到“//config sdk auto load path.”，在这行下面添加:

Autoloader::addAutoloadPath("aliyun-php-sdk-vod");

5.在代码中引用VOD和OSS的文件：

require_once './aliyun-php-sdk/aliyun-php-sdk-core/Config.php';   // 假定您的源码文件和aliyun-php-sdk处于同一目录。
require_once './aliyun-php-sdk/aliyun-oss-php-sdk-2.2.4/autoload.php';
use vod\Request\V20170321 as vod;
use OSS\OssClient;
use OSS\Core\OssException;

更多信息可参考VOD PHP SDK安装和 OSS PHP SDK安装。

参考代码

定义核心步骤的函数：

使用AK初始化VOD客户端

function init_vod_client($accessKeyId, $accessKeySecret) {$regionId = 'cn-shanghai';     // 点播服务所在的Region，国内请填cn-shanghai，不要填写别的区域$profile = DefaultProfile::getProfile($regionId, $accessKeyId, $accessKeySecret);return new DefaultAcsClient($profile);
}

获取视频上传地址和凭证

function create_upload_video($vodClient) {$request = new vod\CreateUploadVideoRequest();$request->setTitle("视频标题");        // 视频标题(必填参数)$request->setFileName("文件名称.mov"); // 视频源文件名称，必须包含扩展名(必填参数)$request->setDescription("视频描述");  // 视频源文件描述(可选)$request->setCoverURL("http://img.alicdn.com/tps/TB1qnJ1PVXXXXXCXXXXXXXXXXXX-700-700.png"); // 自定义视频封面(可选)$request->setTags("标签1,标签2"); // 视频标签，多个用逗号分隔(可选)return $vodClient->getAcsResponse($request);
}

使用上传凭证和地址初始化OSS客户端（注意需要先Base64解码并Json Decode再传入）

function init_oss_client($uploadAuth, $uploadAddress) {$ossClient = new OssClient($uploadAuth['AccessKeyId'], $uploadAuth['AccessKeySecret'], $uploadAddress['Endpoint'], false, $uploadAuth['SecurityToken']);$ossClient->setTimeout(86400*7);    // 设置请求超时时间，单位秒，默认是5184000秒, 建议不要设置太小，如果上传文件很大，消耗的时间会比较长$ossClient->setConnectTimeout(10);  // 设置连接超时时间，单位秒，默认是10秒return $ossClient;
}

上传本地文件

function upload_local_file($ossClient, $uploadAddress, $localFile) {return $ossClient->uploadFile($uploadAddress['Bucket'], $uploadAddress['FileName'], $localFile);
}

刷新上传凭证

function refresh_upload_video($vodClient, $videoId) {$request = new vod\RefreshUploadVideoRequest();$request->setVideoId($videoId);return $vodClient->getAcsResponse($request);
}
执行完整流程（注意捕获异常）：
$accessKeyId = '<AccessKeyId>';                    // 您的AccessKeyId
$accessKeySecret = '<AccessKeySecret>';            // 您的AccessKeySecret
$localFile = '/Users/yours/Video/testVideo.flv';   // 需要上传到VOD的本地视频文件的完整路径
try {// 初始化VOD客户端并获取上传地址和凭证$vodClient = init_vod_client($accessKeyId, $accessKeySecret);$createRes = create_upload_video($vodClient);// 执行成功会返回VideoId、UploadAddress和UploadAuth$videoId = $createRes->VideoId;$uploadAddress = json_decode(base64_decode($createRes->UploadAddress), true);$uploadAuth = json_decode(base64_decode($createRes->UploadAuth), true);// 使用UploadAuth和UploadAddress初始化OSS客户端$ossClient = init_oss_client($uploadAuth, $uploadAddress);// 上传文件，注意是同步上传会阻塞等待，耗时与文件大小和网络上行带宽有关//$result = upload_local_file($ossClient, $uploadAddress, $localFile);$result = multipart_upload_file($ossClient, $uploadAddress, $localFile);printf("Succeed, VideoId: %s", $videoId);
} catch (Exception $e) {// var_dump($e);printf("Failed, ErrorMessage: %s", $e->getMessage());
}