云点播 PHP SDK

一、使用 composer 引入

{ "require": { "qcloud/vod-sdk-v5": "v2.4.4" }}

二、通过源码包安装

·如果项目中没有使用 composer 工具进行依赖管理，从 Github 访问 可以直接下载源码，导入项目中使用。

·解压 vod-sdk.zip 文件到项目中，引入 autoload.php 文件即可使用。

三、初始化上传对象

使用云 API 密钥初始化 VodUploadClient 实例。

使用 composer 导入

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;$client = new VodUploadClient("your secretId", "your secretKey");

使用源码导入

<?phprequire 'vod-sdk-v5/autoload.php';use Vod\\VodUploadClient;$client = new VodUploadClient("your secretId", "your secretKey");

四、构造上传请求对象

use Vod\\Model\\VodUploadRequest;$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/Wildlife.wmv";

五、调用上传

调用上传方法，传入接入点地域及上传请求。

try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

注意：说明：

注意：上传方法根据用户文件的长度，自动选择普通上传以及分片上传，用户不用关心分片上传的每个步骤，即可实现分片上传。

六、携带封面

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;use Vod\\Model\\VodUploadRequest;$client = new VodUploadClient("your secretId", "your secretKey");$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/Wildlife.wmv";$req->CoverFilePath = "/data/videos/Wildlife-Cover.png";try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n"; echo "CoverUrl -> ". $rsp->CoverUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

七、指定任务流

首先 创建任务流模板 并为模板命名，发起任务流时，可以用任务流模板名设置Procedure参数，上传成功后会自动执行任务流。

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;use Vod\\Model\\VodUploadRequest;$client = new VodUploadClient("your secretId", "your secretKey");$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/Wildlife.wmv";$req->Procedure = "Your Procedure Name";try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

八、应用上传

传入 应用 ID，上传成功后资源只属于具体的应用。

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;use Vod\\Model\\VodUploadRequest;$client = new VodUploadClient("your secretId", "your secretKey");$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/Wildlife.wmv";$req->SubAppId = 101;try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

九、指定存储地域

在 控制台 确认已经开通目标存储地域，若没有开通可以参考 上传存储设置，最后通过StorageRegion属性设置存储地域的 英文简称。

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;use Vod\\Model\\VodUploadRequest;$client = new VodUploadClient("your secretId", "your secretKey");$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/Wildlife.wmv";$req->StorageRegion = "ap-chongqing";try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

十、使用临时证书上传

传入 临时证书 的相关密钥信息，使用临时证书验证身份并进行上传。

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;use Vod\\Model\\VodUploadRequest;$client = new VodUploadClient("Credentials TmpSecretId", "Credentials TmpSecretKey", "Credentials Token");$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/Wildlife.wmv";try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

十一、设置代理上传

设置上传代理，涉及协议及数据都会经过代理进行处理，开发者可以借助代理在自己公司内网上传文件到腾讯云。

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;use Vod\\Model\\VodUploadRequest;use Vod\\Model\\VodUploadHttpProfile;$client = new VodUploadClient("your secretId", "your secretKey");$uploadHttpProfile = new VodUploadHttpProfile("your proxy addr");$client->setHttpProfile($uploadHttpProfile);$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/Wildlife.wmv";try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

十二、自适应码流文件上传

本 SDK 支持上传的自适应码流格式包括 HLS 和 DASH，同时要求 manifest（M3U8 或 MPD）所引用的媒体文件必须为相对路径（即不可以是 URL 和绝对路径），且位于 manifest 的同级目录或者下级目录（即不可以使用../）。在调用 SDK 上传接口时，MediaFilePath参数填写 manifest 路径，SDK 会解析出相关的媒体文件列表一并上传。

<?phprequire 'vendor/autoload.php';use Vod\\VodUploadClient;use Vod\\Model\\VodUploadRequest;$client = new VodUploadClient("your secretId", "your secretKey");$req = new VodUploadRequest();$req->MediaFilePath = "/data/videos/prog_index.m3u8";try { $rsp = $client->upload("ap-guangzhou", $req); echo "FileId -> ". $rsp->FileId . "\\n"; echo "MediaUrl -> ". $rsp->MediaUrl . "\\n";} catch (Exception $e) { // 处理上传异常 echo $e;}

十三、接口描述

上传客户端类VodUploadClient

上传请求类VodUploadRequest

上传响应类VodUploadResponse

上传方法VodUploadClient.upload(String region, VodUploadRequest request)

十四、错误码表