一、SDK说明

1、Jar包说明：

1)由于需要JSONObject类，需要Bulid Path中引入sdk中的jar包；

2)由于需要BASE64Encoder类，需要在Eclipse中配置Build Path的Access rules选项。方法：选中项目，点击右键-> Properties->选中Java Build Path->选中Libraries选项卡->打开“JRE System Library”下拉列表-> 双击Access rules-> 点击add->Resolution选择Accessible，Rule Pattern填“sun/misc/*”(不包括引号)。

2、文件说明：

1)VideoMgr.java，SDK主文件，实现了视频上传、修改、删除、查询功能；

2)HMACSHA1.java，加密类；

3)VideoMgrTest.java，java测试单元(可参考此文件，进行视频的上传和删除等操作)。

4)Error.java，用于处理返回状态及报错信息。

5)LinkList.java，用于分段上传时的片段记录。

6)Tools.java，其他工具类，如字符转换。

二、申请账户

使用云视频平台提供的服务，需要在暴风云视频网站创建一个账户，登录后在用户中心可以得到2对秘钥(accesskey/secretkey)，这2对秘钥是用户的操作凭证。。

三、视频管理接口

1.上传发布视频

通过上传接口，用户可以方便地将本地文件上传到云视频平台。

示例代码如下：

private int servicetype = 1;//业务id，0：视频云托管服务，1： 点播服务

private String filekey = "";//自定义的文件名前缀，可为空

private String callback_url= "";//回调url，视频上传成功后会返回结果给回调url，可为空

private String filename = "C:\\test.mp4";//文件绝对路径

private int filetype = 0;//0:表示私有文件，1:表示公有文件

private int uptype = 0;//0:表示表单上传，1:表示断点续传

public void testUpload() {

VideoMgr vm = new VideoMgr(SecretKey, AccessKey);//your key

vm.init(servicetype, filekey, callback_url);

//vm.init(servicetype, filekey);

//vm.init(servicetype);另外两种重载，默认后面的参数为空

int status = vm.upload(filename, filetype, uptype);

Error error = new Error(status);

System.out.println(error.getMessage());//状态码对应的报错信息

System.out.println(vm.getResponse());//上传返回的信息

}

返回信息形如：

{"url":"servicetype=1&uid=4995606&fid=2365827E70F28846C4484B4895AE260D", "hash":"6F3B8DCF817435A4EC85B3EDC77126B4"}

返回的url可用于视频播放，参见API 视频播放。

返回状态码若为0，表示操作成功，其他为错误，可以调用getMessage()获取错误说明，错误码参见 API错误码列表

2.删除视频

从暴风云平台中删除视频，视频一旦删除无法恢复。

示例代码如下：

private String filename = "test.mp4";//需要删除的文件名

public void testDelete() {

VideoMgr vm = new VideoMgr(SecretKey, AccessKey);

vm.init(1, "");//参数1：点播 参数2：filekey为空

int status = vm.delete(filename);

Error error = new Error(status);

System.out.println(error.getMessage());

}

返回状态(status)码参见 API错误码列表

3.查询视频

视频发布过程中，可通过查询接口查询视频发布状态，视频的详细信息。

示例代码如下：

private String filename = "test.mp4";//需要查询的文件名

public void testQuery() {

VideoMgr vm = new VideoMgr(SecretKey, AccessKey);

vm.init(1);//点播，filekey和回调url都为空

int status = vm.query(filename);

Error error = new Error(status);

System.out.println(error.getMessage());

System.out.println(vm.getResponse());

}

返回结果形如：

{"status":0,"fileid":"2365827E70F28846C4484B4895AE260D","servicetype":1, "filename":"test.flv", "showname":"test.flv", "filekey":"tom", "filesize":2852897, "duration":59437, "uploadtime":"2015-04-22 18:58:47", "publishtime":"2015-04-22 18:59:46", "ifpublic":0, "url":"servicetype=1&uid=4995606&fid=2365827E70F28846C4484B4895AE260D"} //点播服务返回结果

返回状态码若为0，表示操作成功，其他为错误，可以调用getMessage()获取错误说明，错误码参见 API错误码列表

返回的url可用于视频播放，参见API 视频播放。

4.更改视频属性

对于视频的公有、私有属性修改，可采用如下接口：

示例代码如下：

private String filename = "test.mp4";//需要更改属性的文件名

private int ifpublic = 1;//0改为私有 1改为公有

public void testChange() {

VideoMgr vm = new VideoMgr(SecretKey, AccessKey);

vm.init(1);

int status = vm.change(filename, ifpublic);

Error error = new Error(status);

System.out.println(error.getMessage());

System.out.println(vm.getResponse());

}

返回状态(status)码参见 API错误码列表

5.获取视频播放地址(Flash)

只有点播服务才会提供Flash的视频播放地址，这里包括两个接口，参数不一样，输出都一样。

a.根据文件名，生成视频播放地址：

示例代码如下：

private String filename = "test.mp4";//需要获取播放链接的文件名

private int userid = 4995606;//在暴风云平台用户中心可获取

private int auto = 1;//1:自动播放 0:不自动播放

public void testPlay() {

VideoMgr vm = new VideoMgr(SecretKey, AccessKey);

vm.init(1);

int status;

//status = vm.getVideoPlayUrl(filename, userid);重载，默认自动播放

status = vm.getVideoPlayUrl(filename, userid, auto);

Error error = new Error(status);

System.out.println(error.getMessage());

System.out.println(vm.getResponse());

}

返回playurl结果为视频的视频地址，形如：

http://vod.baofengcloud.com/4995606/cloud.swf?servicetype=1&uid=4995606&fid=2365827E70F28846C4484B4895AE260D&auto=1

返回状态码若为0，表示操作成功，其他为错误，可以调用getMessage()获取错误说明，错误码参见 API错误码列表

b.根据上传返回的url，加上文件属性，生成视频播放地址：

示例代码如下：

private String url = "servicetype=1&uid=4995606&fid=2365827E70F28846C4484B4895AE260D";//上传所返回的url

private int ifpublic = 1;//0为私有，1为公有

private int userid = 4995606;//在暴风云平台用户中心可获取

private int auto = 1;//1:自动播放 0:不自动播放

public void testPlay() {

VideoMgr vm = new VideoMgr(SecretKey, AccessKey);

vm.init(1, "");

int status;

//status = vm.getVideoPlayUrlByUrl(url, ifpublic, userid);重载，默认自动播放

status = vm.getVideoPlayUrlByUrl(url, ifpublic, userid, auto);

Error error = new Error(status);

System.out.println(error.getMessage());

System.out.println(vm.getResponse());

}

返回playurl结果为视频的视频地址，形如：

http://vod.baofengcloud.com/4995606/cloud.swf?servicetype=1&uid=4995606&fid=2365827E70F28846C4484B4895AE260D&auto=1

返回状态码若为0，表示操作成功，其他为错误，可以调用getMessage()获取错误说明，错误码参见 API错误码列表

6.计算私有视频播放Token

示例代码如下：

private String fileid = "ED5499D31CB0076B9FBC9CDFB05BEB2C";

public void testPlayToken() {

VideoMgr vm = new VideoMgr(SecretKey, AccessKey);

System.out.println(vm.createPlayToken(fileid));

};

播放Token的使用可以作为参数tk传递给Flash播放器，详见： 视频播放