本文为您介绍了Android端播放器SDK的支持系统、开发环境以及集成方式,通过本文您将了解如何进行SDK集成。

支持系统

系统要求版本为Android 4.0及以上。手机芯片架构要求:
  • armv7
  • arm64
说明 此文档针对播放器4.5.0版本SDK及以上版本。如果版本过低,请升级到播放器4.5.0版本SDK及以上版本。请参见升级指南

环境准备

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

集成方式

  • 本地集成
    • 下载SDK包

      下载最新版本Android播放器SDK

    • SDK包整体结构
      结构包里面包含了两个aar文件:
      • AliyunPlayer-4.5.0-full.aar:是完整的aar包,包含了ffmpeg动态库的包。
      • AliyunPlayer-4.5.0-part.aar:是不包含ffmpeg的动态库的包。
      SDK两个包在不同的情况下使用:
      • 如果不集成短视频SDK,那么直接依赖AliyunPlayer-4.5.0-full包即可。
      • 如果集成播放器的同时,也集成短视频SDK,那么播放器的sdk依赖AliyunPlayer-4.5.0-part包,同时使用共通的ffmpeg版本,即需要额外依赖com.aliyun.video.android:AlivcFFmpeg:1.0.0这个包。
        说明 如果集成时使用了错误的SDK包,会导致ffmpeg冲突。
    • 集成步骤
      1. 拷贝需要的aar包到工程的libs目录下(如果没有,则手动创建libs文件夹即可)图片
      2. 修改project的build.gradle文件,在allprojects的repositories节点中增加flatDir的设置,以及阿里云的maven地址,示例如下:
        maven {
            url 'https://maven.aliyun.com/repository/releases'
        }
        flatDir {
            dirs 'libs'
        }
        操作后的截图如下:结果
      3. 修改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'
        }
        操作后的截图如下:结果单击build.gradle完成集成。集成阿里播放器之后,apk体积大约会增加7.5M的大小。
    • 混淆配置
      混淆配置,示例如下:
      -keep class com.alivc.**{*;}
      -keep class com.aliyun.**{*;}
      -keep class com.cicada.**{*;}
      -dontwarn com.alivc.**
      -dontwarn com.aliyun.**
      -dontwarn com.cicada.**
  • 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.gradle完成集成。集成阿里播放器之后,apk体积大约会增加7.5 MB。