全部产品
云市场

集成文档

更新时间:2019-09-18 14:26:45

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

支持系统

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

开发环境

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

集成方式

本地文件集成

下载SDK包

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

SDK包整体结构

sdkStructure

包里面包含了两个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文件夹即可):

libs

  1. 修改project的build.gradle文件,在allprojects的repositories节点中增加flatDir的设置,以及阿里maven地址:
  1. maven {
  2. url 'https://maven.aliyun.com/repository/releases'
  3. }
  4. flatDir {
  5. dirs 'libs'
  6. }

操作后的截图如下:maven

  1. 修改app的build.gradle文件,dependencies节点中增加对aar的引用:播放器SDK,Conan的引用:
  1. dependencies {
  2. implementation fileTree(dir: 'libs', include: ['*.jar'])
  3. //其他的依赖
  4. //阿里云播放器的两个依赖
  5. implementation (name:'AliyunPlayer-4.5.0-full',ext:'aar')
  6. implementation 'com.alivc.conan:AlivcConan:0.9.5'
  7. }

操作后的截图如下:image1

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

Gradle集成方式

1.在project的build.gradle中增加阿里云的maven地址依赖(两处均要添加):

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

操作后的截图如下:

image2

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

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

操作后的截图如下:

image33.build工程即可。

集成包大小

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

混淆配置

  1. -keep class com.alivc.**{*;}
  2. -keep class com.aliyun.**{*;}
  3. -dontwarn com.alivc.**
  4. -dontwarn com.aliyun.**