SDK集成
更新时间:2024-03-28
开发与运行环境
- Android Studio
- 支持 Android 4.4 及以上系统版本; 支持 armv7a/arm64。
下载最新的SDK并解压
下载最新的播放器 Android SDK,解压后文件目录如下:
Plain Text
1├── Baidu-Cloud-Player-Android-<Version>-<Revision>
2│ ├── bdplayer-sample
3│ ├── BDCloudVideoView_sourcecode
4│ ├── libs
5│ │ ├── HDRKit.aar // HDR渲染组件,高级版SDK特有
6│ │ ├── RTCPlayerWrapper.aar // 超低延时直播组件,高级版SDK特有
7│ │ ├── VRKit.aar // VR渲染组件,高级版SDK特有
8│ │ ├── ProjectionWrapper.aar // 投屏组件,高级版SDK特有
9│ │ ├── VirtualLiveKit.aar // 绿幕抠图组件,高级版SDK特有
10│ │ ├── SRKit.aar // 端上超分组件,高级版SDK特有
11│ │ ├── VideoProcessor.aar // 视频后处理组件,高级版SDK特有
12│ │ ├── DanmakuWrapper.aar // 弹幕组件
13│ │ ├── VideoCache.aar
14│ │ ├── PlayerLicense.aar
15│ │ └── baiduPlayerSDk.aar
其中:
bdplayer-sample
为demo示例;BDCloudVideoView_sourcecode
为BDCloudVideoView
控件的java源代码;libs
为aar包。
申请license
申请播放器SDK license:您需要登录百度智能云控制台申请获取播放器SDK license。
配置工程
您可以选择使用maven配置,也可以通过手动集成将aar包加入到工程中。
maven配置
在根级gradle中添加mavenCentral仓库,如下所示
Plain Text
1buildscript {
2 repositories {
3 mavenCentral()
4 }
5}
6allprojects {
7 repositories {
8 mavenCentral()
9 }
10}
在模块gradle中添加具体SDK的依赖,如下所示
Plain Text
1defaultConfig {
2 packagingOptions {
3 pickFirst 'lib/armeabi-v7a/*.so'
4 pickFirst 'lib/arm64-v8a/*.so'
5 }
6}
7
8dependencies {
9 // 按需在以下四个版本的baiduPlayerSDK中选择一个即可
10 // 流媒体标准版
11 implementation "com.baidubce.mediasdk:baiduPlayerSDK:3.9.0"
12 // 全媒体标准版
13 // implementation "com.baidubce.mediasdk:baiduPlayerSDK-full:3.9.0"
14 // 流媒体高级版
15 // implementation "com.baidubce.mediasdk:baiduPlayerSDK-advance:3.9.0"
16 // 全媒体高级版
17 // implementation "com.baidubce.mediasdk:baiduPlayerSDK-full-advance:3.9.0"
18
19 implementation "com.baidubce.mediasdk:playerlicense:3.9.0"
20 implementation "com.baidubce.mediasdk:videocache:3.9.0"
21 implementation "com.baidubce.mediasdk:danmaku-wrapper:1.0.0"
22 // 以下组件为高级版特有
23 implementation "com.baidubce.mediasdk:videoProcessor:1.0.5"
24 implementation "com.baidubce.mediasdk:hdrkit:1.0.5"
25 implementation "com.baidubce.mediasdk:srkit:1.0.5"
26 implementation "com.baidubce.mediasdk:virtualLiveKit:1.0.5"
27 implementation "com.baidubce.mediasdk:rtcplayer-wrapper:1.0.24"
28 implementation "com.baidubce.mediasdk:projection-wrapper:1.0.5"
29 implementation "com.baidubce.mediasdk:vrkit:1.0.0"
30}
手动配置aar包
将baiduPlayerSDK.aar
等aar包复制到您工程的app/libs
目录下,并在gradle文件的dependencies模块注明aar包路径,如下所示:
Plain Text
1defaultConfig {
2 packagingOptions {
3 pickFirst 'lib/armeabi-v7a/*.so'
4 pickFirst 'lib/arm64-v8a/*.so'
5 }
6}
7dependencies {
8 implementation fileTree(dir: 'libs', include: ['*.aar'])
9}
配置证书
通过百度智能云控制台下载证书,复制到 app/src/main/assets
目录下。
配置BDCloudVideoView控件
SDK默认提供BDCloudMediaPlayer
类,如果您想使用BDCloudVideoView
控件,需复制解压包中BDCloudVideoView_sourcecode
目录下的代码到app/src/main/java
中。
配置完成
如果选择手动集成aar方式,则配置完成后,目录如下所示:
Plain Text
1├── bdplayer-sample
2│ ├── app
3│ │ ├── libs
4│ │ │ └── baiduPlayerSDK.aar // aar包位置
5│ │ │ └── VideoCache.aar
6│ │ │ └── PlayerLicense.aar
7│ │ ├── src
8│ │ │ ├── main
9│ │ │ │ ├── assets
10│ │ │ │ │ └── playerxxxxx.license // 证书位置
11│ │ │ │ ├── java
12│ │ │ │ │ └── com.baidu.cloud.videoplayer.widget // BDCloudVideoView位置
声明SDK需要的权限
将以下权限加入到您的AndroidManifest.xml中,
Plain Text
1<uses-permission android:name="android.permission.INTERNET" />
2<uses-permission android:name="android.permission.WAKE_LOCK" />
3<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
4<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
5<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
防混淆设置
将以下语句加入到您的proguard混淆配置文件中,
Plain Text
1-keep class com.baidu.cloud.**{ *;}