云点播 Java SDK

对于在服务端上传视频的场景，云点播提供 Java SDK 来实现。上传流程请参见 服务端上传指引。

一、Maven 依赖引入

在项目的 pom.xml 文件添加点播 SDK 依赖即可：

<dependency> <groupId>com.qcloud</groupId> <artifactId>vod_api</artifactId> <version>2.1.5</version></dependency>

二、jar 包导入

如果项目没有采用 Maven 的方式进行依赖管理，可采用如下方式，下载各个所需的 jar 包，导入项目即可：

单击 Java SDK 关联 jar 包，将下载的 jar 包导入项目中，即可使用。

三、初始化一个上传客户端对象

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

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");

四、构造上传请求对象

设置媒体本地上传路径。

VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");

五、调用上传

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

try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

注意：说明：

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

六、携带封面

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");request.setCoverFilePath("/data/videos/Wildlife.jpg");try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

七、指定任务流

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

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");request.setProcedure("Your Procedure Name");try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

八、应用上传

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

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");request.setSubAppId(101);try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

九、指定存储地域

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

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");request.setStorageRegion("ap-chongqing");try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

十、指定分片并发数

分片并发数是针对大文件，拆分成多个分片同时进行上传。分片并发上传的优势在于可以快速完成单个文件的上传，SDK 会根据用户文件的长度，自动选择普通上传以及分片上传，用户不用关心分片上传的每个步骤，即可实现分片上传。而文件的分片并发数通过ConcurrentUploadNumber参数进行指定。

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");request.setConcurrentUploadNumber(5);try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

十一、使用临时证书上传

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

VodUploadClient client = new VodUploadClient("Credentials TmpSecretId", "Credentials TmpSecretKey", "Credentials Token");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

十二、设置代理上传

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

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/Wildlife.wmv");HttpProfile httpProfile = new HttpProfile();httpProfile.setProxyHost("your proxy ip");httpProfile.setProxyPort(8080); //your proxy portclient.setHttpProfile(httpProfile);try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

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

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

VodUploadClient client = new VodUploadClient("your secretId", "your secretKey");VodUploadRequest request = new VodUploadRequest();request.setMediaFilePath("/data/videos/prog_index.m3u8");try { VodUploadResponse response = client.upload("ap-guangzhou", request); logger.info("Upload FileId = {}", response.getFileId());} catch (Exception e) { // 业务方进行异常处理 logger.error("Upload Err", e);}

十四、接口描述

上传客户端类VodUploadClient

上传请求类VodUploadRequest

上传响应类VodUploadResponse

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

十五、错误码表