本文介绍Android播放器SDK的环境要求、集成方式及使用参考。

环境要求

类别 说明
系统版本 支持Android 4.3及以上版本。
手机芯片 架构要求:
  • armv7。
  • arm64。
开发工具 推荐使用Android Studio,本文操作步骤基于Android Studio开发。下载地址:Android Studio

前提条件

本地集成SDK时,需要先下载Android播放器SDK包(包含了播放器SDK及Demo源码),从V5.4.6.0版本开始Android播放器SDK提供了支持AndroidX和不支持AndroidX的Demo,请根据您的项目按需选择下载,推荐下载使用最新版本。下载地址请参见SDK简介与下载

解压后的目录结构如下:
表 1. SDK包目录结构
文件名 作用
demo 播放器的Demo源码。
JavaDoc 播放器API文档。
sdk 播放器SDK的aar库。sdk的目录结构参见表 2
X.X.XReleaseNote 版本说明。
表 2. sdk目录结构
文件名 说明
AliyunPlayer-x.x.x-full.aar 完整的aar包,包含了FFmpeg动态库的包。
AliyunPlayer-x.x.x-part.aar aar包,不包含FFmpeg的动态库的包。
AlivcArtp-x.x.x.aar 支持artp协议,非必须。
AlivcArtc-x.x.x.aar 支持artc协议,非必须。
说明
  • 如果不集成短视频SDK,直接依赖AliyunPlayer-x.xx.x-full.aar包即可。
  • 如果集成播放器的同时,也集成短视频SDK,那么播放器的SDK依赖AliyunPlayer-x.x.x-part包,同时使用共通的FFmpeg版本,即需要额外依赖com.aliyun.video.android:AlivcFFmpeg:x.x.x这个包。
  • 如果集成时使用了错误的SDK包,会导致FFmpeg冲突。

SDK集成(本地集成)

  1. 拷贝需要的aar包到工程的libs目录下(如果没有libs文件夹,手动创建libs文件夹即可)。
    图片
  2. 修改Project下的build.gradle文件,在allprojects的repositories节点中增加flatDir的设置,示例如下:
    flatDir {
       dirs 'libs'
    }
  3. 修改App的build.gradle文件,dependencies节点中增加对aar的引用和Conan的引用,示例如下:
    dependencies {
          implementation fileTree(dir: 'libs', include: ['*.aar'])
          //阿里云播放器5.3.0 版本以前需要引入AlivcConan库,5.3.0及其以后的版本不需要引入。
          implementation 'com.alivc.conan:AlivcConan:x.x.x'
    }
  4. 混淆配置。
    在App的Proguard-rules.pro文件中添加以下混淆配置,示例如下:
    -keep class com.alivc.**{*;}
    -keep class com.aliyun.**{*;}
    -keep class com.cicada.**{*;}
    -dontwarn com.alivc.**
    -dontwarn com.aliyun.**
    -dontwarn com.cicada.**

SDK集成(Gradle集成)

说明 请确保网络正常,并且可以正常访问阿里云Maven仓库。如果由于网络故障,无法从Maven仓库下载到播放器SDK包,则建议通过本地集成方式来集成SDK,详细请参见SDK集成(本地集成)
  1. 在Project的build.gradle中增加阿里云的Maven地址依赖。示例如下:
    maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
    操作后的截图如下:gradle集成
  2. 修改App的build.gradle文件,dependencies节点中增加依赖。示例如下:
    说明 请确保引入的播放器SDK版本号填写正确,否则将报错并引入失败。
    implementation 'com.aliyun.sdk.android:AliyunPlayer:x.x.x-full'
    //阿里云播放器5.3.0 版本以前需要引入AlivcConan库,5.3.0及其以后的版本不需要引入
    implementation 'com.alivc.conan:AlivcConan:x.x.x'
    操作后的截图如下:结果

常见集成问题

播放器问题

功能使用文档

基础功能

进阶功能