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

说明 更多SDK咨询问题,可搜索钉钉群号2720012141入群咨询专家。

环境要求

类别 说明
系统版本 支持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的目录结构参见sdk目录结构
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 "https://maven.aliyun.com/repository/releases" }
    操作后的截图如下:gradle集成
  2. 修改App的build.gradle文件,dependencies节点中增加依赖。示例如下:
    说明 请确保引入的播放器SDK版本号填写正确,否则将报错并引入失败。播放器SDK的版本可以从Android播放器SDK发布历史查看,例如V5.4.8.0则对应版本号为5.4.8.0。
    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'
    操作后的截图如下:结果

配置License

说明
  • V5.4.7.1及之后版本的Android播放器SDK必须按以下操作配置License后,方可使用。
  • License配置完成后,查看日志若无License相关报错,则表示License配置成功。
  1. 获取License证书文件,获取方式请参见获取License
    说明 配置的License文件和LicenseKey和申请时提交的应用信息(PackageName和Signature)有严格的对应关系,请确保License文件和LicenseKey和申请时的信息保持一致,否则会出现鉴权失败的情况。
  2. 将获取到的证书文件拷贝到Android Studio项目中,建议放到assets目录下,也可以放到沙箱或者其他路径。
  3. 在AndroidManifest.xml文件中添加如下meta-data。
    license1
    • key为com.aliyun.alivc_license.licensekey(全小写),value为LicenseKey的值。
    • key为com.aliyun.alivc_license.licensefile(全小写),value为步骤二中证书文件的放置路径,请根据实际情况填写。
    <meta-data
        android:name="com.aliyun.alivc_license.licensekey"
        android:value="xxxxxxxxx" />
    <meta-data
        android:name="com.aliyun.alivc_license.licensefile"
        android:value="assets/license.crt" />

常见集成问题

播放器问题

功能使用文档

基础功能

进阶功能