本文介绍Android播放器SDK的环境要求、集成方式及使用参考。
说明 更多SDK咨询问题，可搜索钉钉群号2720012141入群咨询专家。
环境要求
| 类别 | 说明 |
|---|---|
| 系统版本 | 支持Android 4.3及以上版本。 |
| 手机芯片 | 架构要求：
|
| 开发工具 | 推荐使用Android Studio，本文操作步骤基于Android Studio开发。下载地址：Android Studio。 |
前提条件
本地集成SDK时，需要先下载Android播放器SDK包（包含了播放器SDK及Demo源码），从V5.4.6.0版本开始Android播放器SDK提供了支持AndroidX和不支持AndroidX的Demo，请根据您的项目按需选择下载，推荐下载使用最新版本。下载地址请参见播放器SDK。
解压后的目录结构如下：
| 文件名 | 作用 |
|---|---|
| demo | 播放器的Demo源码。 |
| JavaDoc | 播放器API文档。 |
| sdk | 播放器SDK的aar库。sdk的目录结构参见sdk目录结构。 |
| X.X.XReleaseNote | 版本说明。 |
| 文件名 | 说明 |
|---|---|
| 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冲突。
使用限制
Android播放器SDK不支持模拟器，集成完成后需要真机运行。
SDK集成（本地集成）
- 拷贝需要的aar包到工程的libs目录下（如果没有libs文件夹，手动创建libs文件夹即可）。
- 修改Project下的build.gradle文件，在allprojects的repositories节点中增加flatDir的设置，示例如下：
flatDir { dirs 'libs' } - 修改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' } - 混淆配置。在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集成（本地集成）。
- 在Project的build.gradle中增加阿里云的Maven地址依赖。示例如下：
maven { url "https://maven.aliyun.com/repository/releases" }操作后的截图如下：
- 修改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后，方可使用。
- 播放器SDK现免费提供，License有效期为1年，1年后若无特殊约定我们将为您自动续期。
- License配置完成后，查看日志若无License相关报错，则表示License配置成功。
- 获取License证书文件，获取方式请参见获取License。说明 配置的License文件和LicenseKey和申请时提交的应用信息（PackageName和Signature）有严格的对应关系，请确保License文件和LicenseKey和申请时的信息保持一致，否则会出现鉴权失败的情况。
- 将获取到的证书文件拷贝到Android Studio项目中，建议放到assets目录下，也可以放到沙箱或者其他路径。
- 在AndroidManifest.xml文件中添加如下meta-data。
- 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" /> - key为