SDK集成
更新时间:2022-11-21
开发与运行环境
- Android Studio
- 支持 Android 4.4 及以上系统版本; 支持 armv7a/arm64。
下载最新的SDK并解压
下载最新的播放器 Android SDK,解压后文件目录如下:
├── Baidu-Cloud-Player-Android-<Version>-<Revision>
│ ├── bdplayer-sample
│ ├── BDCloudVideoView_sourcecode
│ ├── libs
│ │ ├── VideoCache.aar
│ │ ├── PlayerLicense.aar
│ │ ├── HDRKit.aar // 高级版SDK特有
│ │ ├── RTCPlayerWrapper.aar // 高级版SDK特有
│ │ └── baiduPlayerSDk.aar
其中:
bdplayer-sample
为demo示例;BDCloudVideoView_sourcecode
为BDCloudVideoView
控件的java源代码;libs
为aar包。
申请license
申请播放器SDK license:您需要登录百度智能云控制台申请获取播放器SDK license。
申请AK
申请账号并开通权限: 您需要登录百度智能云控制台,在安全认证页面 获取 Access Key (AK)。SDK 认证时必须传入 AK 参数。
配置工程
您可以选择使用maven配置,也可以通过手动集成将aar包加入到工程中。
maven配置
在根级gradle中添加mavenCentral仓库,如下所示
buildscript {
repositories {
mavenCentral()
}
}
allprojects {
repositories {
mavenCentral()
}
}
在模块gradle中添加具体SDK的依赖,如下所示
defaultConfig {
packagingOptions {
pickFirst 'lib/armeabi-v7a/*.so'
pickFirst 'lib/arm64-v8a/*.so'
}
}
dependencies {
// 按需在以下四个版本的baiduPlayerSDK中选择一个即可
// 流媒体标准版
implementation "com.baidubce.mediasdk:baiduPlayerSDK:3.0.0"
// 全媒体标准版
// implementation "com.baidubce.mediasdk:baiduPlayerSDK-full:3.0.0"
// 流媒体高级版
// implementation "com.baidubce.mediasdk:baiduPlayerSDK-advance:3.0.0"
// 全媒体高级版
// implementation "com.baidubce.mediasdk:baiduPlayerSDK-full-advance:3.0.0"
implementation "com.baidubce.mediasdk:playerlicense:3.0.0"
implementation "com.baidubce.mediasdk:videocache:3.0.0"
implementation "com.baidubce.mediasdk:hdrkit:1.0.0"
implementation "com.baidubce.mediasdk:rtcplayer-wrapper:1.0.24"
}
手动配置aar包
将baiduPlayerSDK.aar
等aar包复制到您工程的app/libs
目录下,并在gradle文件的dependencies模块注明aar包路径,如下所示:
defaultConfig {
packagingOptions {
pickFirst 'lib/armeabi-v7a/*.so'
pickFirst 'lib/arm64-v8a/*.so'
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.aar'])
}
配置证书
通过百度智能云控制台下载证书,复制到 app/src/main/assets
目录下。
配置BDCloudVideoView控件
SDK默认提供BDCloudMediaPlayer
类,如果您想使用BDCloudVideoView
控件,需复制解压包中BDCloudVideoView_sourcecode
目录下的代码到app/src/main/java
中。
配置完成
如果选择手动集成aar方式,则配置完成后,目录如下所示:
├── bdplayer-sample
│ ├── app
│ │ ├── libs
│ │ │ └── baiduPlayerSDK.aar // aar包位置
│ │ │ └── VideoCache.aar
│ │ │ └── PlayerLicense.aar
│ │ ├── src
│ │ │ ├── main
│ │ │ │ ├── assets
│ │ │ │ │ └── playerxxxxx.license // 证书位置
│ │ │ │ ├── java
│ │ │ │ │ └── com.baidu.cloud.videoplayer.widget // BDCloudVideoView位置
声明SDK需要的权限
将以下权限加入到您的AndroidManifest.xml中,
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
防混淆设置
将以下语句加入到您的proguard混淆配置文件中,
-keep class com.baidu.cloud.media.**{ *;}