SDK集成

更新时间：2024-03-28

开发与运行环境

Android Studio
支持 Android 4.4 及以上系统版本; 支持 armv7a/arm64。

下载最新的SDK并解压

下载最新的播放器 Android SDK，解压后文件目录如下：

├── Baidu-Cloud-Player-Android-<Version>-<Revision>
│   ├── bdplayer-sample
│   ├── BDCloudVideoView_sourcecode
│   ├── libs
│   │   ├── HDRKit.aar            // HDR渲染组件，高级版SDK特有
│   │   ├── RTCPlayerWrapper.aar  // 超低延时直播组件，高级版SDK特有
│   │   ├── VRKit.aar             // VR渲染组件，高级版SDK特有
│   │   ├── ProjectionWrapper.aar // 投屏组件，高级版SDK特有
│   │   ├── VirtualLiveKit.aar    // 绿幕抠图组件，高级版SDK特有
│   │   ├── SRKit.aar             // 端上超分组件，高级版SDK特有
│   │   ├── VideoProcessor.aar    // 视频后处理组件，高级版SDK特有
│   │   ├── DanmakuWrapper.aar    // 弹幕组件
│   │   ├── VideoCache.aar
│   │   ├── PlayerLicense.aar
│   │   └── baiduPlayerSDk.aar

其中：

bdplayer-sample为demo示例；
BDCloudVideoView_sourcecode为BDCloudVideoView控件的java源代码；
libs为aar包。

申请license

申请播放器SDK license：您需要登录百度智能云控制台申请获取播放器SDK license。

配置工程

您可以选择使用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.9.0"
    // 全媒体标准版
    // implementation "com.baidubce.mediasdk:baiduPlayerSDK-full:3.9.0"
    // 流媒体高级版
    // implementation "com.baidubce.mediasdk:baiduPlayerSDK-advance:3.9.0"
    // 全媒体高级版
    // implementation "com.baidubce.mediasdk:baiduPlayerSDK-full-advance:3.9.0"
    
    implementation "com.baidubce.mediasdk:playerlicense:3.9.0"
    implementation "com.baidubce.mediasdk:videocache:3.9.0"
    implementation "com.baidubce.mediasdk:danmaku-wrapper:1.0.0"
    // 以下组件为高级版特有
    implementation "com.baidubce.mediasdk:videoProcessor:1.0.5"
    implementation "com.baidubce.mediasdk:hdrkit:1.0.5"
    implementation "com.baidubce.mediasdk:srkit:1.0.5"
    implementation "com.baidubce.mediasdk:virtualLiveKit:1.0.5"
    implementation "com.baidubce.mediasdk:rtcplayer-wrapper:1.0.24"
    implementation "com.baidubce.mediasdk:projection-wrapper:1.0.5"
    implementation "com.baidubce.mediasdk:vrkit:1.0.0"
}

手动配置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.**{ *;}

简介

快速开始

百度智能云

智能视频SDK