|
|
|
# 1. 概述
|
|
|
|
获得场景视频Android SDK是基于Android API实现的类库，支持Android2.3及以上版本，开发者可通过此SDK对接获得场景视频云服务平台，进行播放、上传和下载操作。
|
|
|
|
# 1. 概述
|
|
|
|
CC视频Android SDK是基于Android API实现的类库，支持Android2.3及以上版本，开发者可通过此SDK对接CC视频云服务平台，进行播放、上传和下载操作。
|
|
|
|
## 1.1 功能特性
|
|
|
|
| 功能 | 描述 |
|
|
|
|
| :--------------------------------------- | :------- |
|
| ... | ... | @@ -14,14 +14,14 @@ |
|
|
|
| 音频播放 | 支持音频在线播放和本地播放 |
|
|
|
|
| 音频下载 | 支持音频下载 |
|
|
|
|
| 授权验证 | 支持为视频配置授权码 |
|
|
|
|
| 访客信息收集 | 支持在播放视频的时候弹出访客信息收集框 |
|
|
|
|
| 访客信息收集| 支持在播放视频的时候弹出访客信息收集框 |
|
|
|
|
|
|
|
|
## 1.2 阅读对象
|
|
|
|
|
|
|
|
本文档为技术文档，需要阅读者：
|
|
|
|
* 具备基本的Android开发能力
|
|
|
|
* 准备接入获得场景视频的点播SDK功能
|
|
|
|
* 对获得场景视频点播产品使用方法有基础的了解，[使用帮助地址](http://doc.bokecc.com/vod/nav/)。
|
|
|
|
* 准备接入CC视频的点播SDK功能
|
|
|
|
* 对CC点播产品使用方法有基础的了解，[使用帮助地址](http://doc.bokecc.com/vod/nav/)。
|
|
|
|
|
|
|
|
# 2. 开发准备
|
|
|
|
|
| ... | ... | @@ -30,55 +30,20 @@ |
|
|
|
* Android SDK : Android 官方SDK
|
|
|
|
|
|
|
|
## 2.2 混淆配置
|
|
|
|
SDK已经过混淆处理，如果需要对应用进行混淆编译，请在混淆的配置文件中加入以下代码，以避免SDK被二次混淆编译：
|
|
|
|
CCSDK.jar已经过混淆处理，如果需要对应用进行混淆编译，请在混淆的配置文件中加入以下代码，以避免SDK被二次混淆编译：
|
|
|
|
```
|
|
|
|
-dontwarn com.bokecc.sdk.mobile.**
|
|
|
|
-keep public class com.bokecc.sdk.mobile.**{*;}
|
|
|
|
-keep public interface com.bokecc.sdk.mobile.**{*;}
|
|
|
|
|
|
|
|
-dontwarn org.apache.http.**
|
|
|
|
-keep class org.apache.http.**{ *;}
|
|
|
|
|
|
|
|
#如果使用了倍速播放功能，还需要以下配置
|
|
|
|
-keep class tv.danmaku.ijk.media.player.** {*;}
|
|
|
|
-keep class tv.danmaku.ijk.media.player.IjkMediaPlayer{*;}
|
|
|
|
-keep class tv.danmaku.ijk.media.player.ffmpeg.FFmpegApi{*;}
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
# 3. 快速集成
|
|
|
|
|
|
|
|
## 3.1 导入SDK
|
|
|
|
有两种引入SDK的方式，第一种是使用Gradle方式，第二种是引用Jar包，需要下载最新版本的SDK，下载地址为：[CCVideo/VOD_Android_SDK](https://github.com/CCVideo/VOD_Android_SDK)
|
|
|
|
### 3.1.1 使用Gradle方式
|
|
|
|
1.在Project的build.gradle的文件配置 maven {url 'https://dl.bintray.com/bokecc/maven'}
|
|
|
|
```
|
|
|
|
allprojects {
|
|
|
|
repositories {
|
|
|
|
google()
|
|
|
|
jcenter()
|
|
|
|
maven {url 'https://dl.bintray.com/bokecc/maven'}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
```
|
|
|
|
2.在App的build.gradle的文件中添加依赖
|
|
|
|
```
|
|
|
|
dependencies {
|
|
|
|
//获得场景视频SDK，必须引入
|
|
|
|
implementation 'com.bokecc:vod:2.19.5'
|
|
|
|
//播放加密视频必须引用http
|
|
|
|
implementation 'com.bokecc:http:1.1.0'
|
|
|
|
//使用DWIjkMediaPlayer 倍速播放器引入
|
|
|
|
implementation 'com.bokecc:speedplay:2.19.0'
|
|
|
|
//下载和播放本地v6加密的视频必须引用
|
|
|
|
implementation 'com.bokecc:drmv6:2.19.0'
|
|
|
|
//上传视频时使用压缩功能时需要引用
|
|
|
|
implementation 'com.bokecc:compressvideo:1.0.0'
|
|
|
|
}
|
|
|
|
```
|
|
|
|
首先，需要下载最新版本的SDK，下载地址为：[CCVideo/VOD_Android_SDK](https://github.com/CCVideo/VOD_Android_SDK)
|
|
|
|
|
|
|
|
## 3.1 导入jar
|
|
|
|
|
|
|
|
### 3.1.2 以引用Jar包的方式导入SDK
|
|
|
|
将Huodesdk.jar添加到Android项目中，并配置当前项目可正确的引用此类库
|
|
|
|
将CCSDK.jar添加到Android项目中，并配置当前项目可正确的引用此类库
|
|
|
|
|
|
|
|
## 3.2 配置项目的网络权限和文件读写权限：
|
|
|
|
|
| ... | ... | @@ -516,32 +481,7 @@ player.setOnSubtitleMsgListener(new OnSubtitleMsgListener() { |
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
## 4.6 访客信息收集功能
|
|
|
|
|
|
|
|
支持从服务器获取访客信息收集设置并显示，可以通过调用player的setOnVisitMsgListener(OnVisitMsgListener onVisitMsgListener)方法，当有访客信息收集设置时，在该接口中回调访客信息收集设置并展示。
|
|
|
|
|
|
|
|
```
|
|
|
|
player.setOnVisitMsgListener(new OnVisitMsgListener() {
|
|
|
|
@Override
|
|
|
|
public void onVisitMsg(int appearTime, String imageURL, int isJump, String jumpURL, String title, String
|
|
|
|
visitorId, JSONArray visitorMessage) {
|
|
|
|
|
|
|
|
/**访客信息收集
|
|
|
|
* @param appearTime 收集器出现的时间(S)
|
|
|
|
* @param imageURL 图片地址
|
|
|
|
* @param isJump 是否需要跳过 1跳过,0不跳过
|
|
|
|
* @param jumpURL 图片跳转的地址
|
|
|
|
* @param title 收集器名称
|
|
|
|
* @param visitorId 收集器ID
|
|
|
|
* @param visitorMessage //要收集的信息
|
|
|
|
*/
|
|
|
|
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
## 4.7 错误处理
|
|
|
|
## 4.6 错误处理
|
|
|
|
|
|
|
|
DWMediaPlayer重载了MediaPlayer的setOnErrorListener()方法，如果需要在应用中提示错误信息，可调用此方法设置OnErrorListener。具体实现方式如下:
|
|
|
|
|
| ... | ... | @@ -751,7 +691,27 @@ player.setOnAuthMsgListener(new OnAuthMsgListener() { |
|
|
|
|
|
|
|
}
|
|
|
|
});
|
|
|
|
```
|
|
|
|
```
|
|
|
|
## 4.12 访客信息收集功能
|
|
|
|
支持从服务器获取访客信息收集设置并显示，可以通过调用player的setOnVisitMsgListener(OnVisitMsgListener onVisitMsgListener)方法，得到访客信息收集设置。
|
|
|
|
```
|
|
|
|
//获得访客信息设置
|
|
|
|
player.setOnVisitMsgListener(new OnVisitMsgListener() {
|
|
|
|
/**
|
|
|
|
* @param appearTime 收集器出现的时间(S)
|
|
|
|
* @param imageURL 图片地址
|
|
|
|
* @param isJump 是否需要跳过 1跳过,0不跳过
|
|
|
|
* @param jumpURL 图片跳转的地址
|
|
|
|
* @param title 收集器名称
|
|
|
|
* @param visitorId 收集器ID
|
|
|
|
* @param visitorMessage //要收集的信息
|
|
|
|
*/
|
|
|
|
@Override
|
|
|
|
public void onVisitMsg(int appearTime, String imageURL, int isJump, String jumpURL, String title, String visitorId, JSONArray visitorMessage) {
|
|
|
|
|
|
|
|
}
|
|
|
|
});
|
|
|
|
```
|
|
|
|
# 5. API查询
|
|
|
|
|
|
|
|
https://github.com/CCVideo/VOD_Android_SDK/tree/master/doc/api
|
| ... | ... | |
