集成文档

注意：此文档针对4.5.0及以上版本。3.X.X及以前版本不适用此文档。如果是从3.X.X版本升级，参考升级指南

支持系统

系统要求版本为Android 4.0（即apiLevel >= 14）及以上。手机芯片要求armv7或arm64架构。

开发环境

推荐开发者使用 Android Studio 作为自己的开发工具，本开发文档也是基于 Android Studio开发环境下进行编写的。

集成方式

本地文件集成

下载SDK包

从[这里]下载最新版本的播放器SDK，解压得到aar包。

SDK包整体结构

包里面包含了两个aar，AliyunPlayer-4.5.0-full.aar: 是完整的aar包，包含了ffmpeg动态库的包。AliyunPlayer-4.5.0-part.aar:是不包含ffmpeg动态库的包。

SDK说明

SDK两个包在不同的情况下使用：

1. 如果不集成短视频SDK，那么直接依赖AliyunPlayer-4.5.0-full包即可。
2. 如果集成播放器的同时，也集成短视频SDK，那么播放器的sdk依赖AliyunPlayer-4.5.0-part包，同时使用共通的ffmpeg版本，即需要额外依赖com.aliyun.video.android:AlivcFFmpeg:1.0.0这个包。

如果集成时使用了错误的SDK包，会导致ffmpeg冲突。

集成步骤

1. 拷贝需要的aar包到工程的libs目录下（如果没有，则手动创建libs文件夹即可）：

1. 修改project的build.gradle文件，在allprojects的repositories节点中增加flatDir的设置,以及阿里maven地址:

maven {
    url 'https://maven.aliyun.com/repository/releases'
}
flatDir {
    dirs 'libs'
}

操作后的截图如下：

1. 修改app的build.gradle文件，dependencies节点中增加对aar的引用：播放器SDK，Conan的引用：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    //其他的依赖
    //阿里云播放器的两个依赖
    implementation (name:'AliyunPlayer-4.5.0-full',ext:'aar')
    implementation 'com.alivc.conan:AlivcConan:0.9.5'
}

操作后的截图如下：

1. build即可。集成阿里播放器之后，apk体积大约会增加7.5M的大小。

Gradle集成方式

1.在project的build.gradle中增加阿里云的maven地址依赖（两处均要添加）：

maven(){
    url 'https://maven.aliyun.com/repository/releases'
}

操作后的截图如下：

2.修改app的build.gradle文件，dependencies节点中增加对aar的引用：

implementation 'com.aliyun.sdk.android:AliyunPlayer:4.5.0-full'
implementation 'com.alivc.conan:AlivcConan:0.9.5'

操作后的截图如下：

3.build工程即可。

集成包大小

集成阿里播放器之后，apk体积大约会增加7.5M的大小。

混淆配置

-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**