Android快速集成

环境要求

SDK说明

从1.2.0版本开始，根据相关的业务场景，我们提供了不同SDK组合形式，选择合适的组合包，不仅便于操作，而且包体更小。具体的组合形式如下：

在线集成（推荐）

1. 在Project的build.gradle中增加阿里云的Maven地址依赖。

   maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }

   buildscript {
       repositories {
           maven { url 'https://maven.aliyun.com/repository/central' }
           maven { url 'https://maven.aliyun.com/repository/xxx' }
           maven { url 'https://maven.aliyun.com/repository/xxx' }
           maven { url 'https://maven.aliyun.com/repository/xxx' }
           maven { url 'xxx' }
       }
       dependencies {
           xxx
       }
       xxx
   }
   allprojects {
       repositories {
           maven { url 'https://maven.aliyun.com/repository/central' }
           maven { url 'https://maven.aliyun.com/repository/xxx' }
           maven { url 'https://maven.aliyun.com/repository/xxx' }
           maven { url 'https://maven.aliyun.com/repository/xxx' }
           maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
           xxx
           maven { url 'https://jitpack.io' }
           xxx
       }
   }

2. 修改App的build.gradle文件，dependencies节点中增加依赖。

   //下面8种组合，请根据自己的业务需要，选择一种接入即可
    //1.直播推流（含超低延时直播、RTC连麦） + 短视频 + 播放器
    implementation 'com.aliyun.aio:AliVCSDK_Standard:1.6.0'
    //2.直播推流（含超低延时直播、RTC连麦） + 短视频 + 美颜特效 + 播放器
    implementation 'com.aliyun.aio:AliVCSDK_Premium:1.6.0'
    //3.直播推流 + 播放器
    implementation 'com.aliyun.aio:AliVCSDK_BasicLive:1.6.0'
    //4.直播推流 + 播放器 + 美颜特效
    implementation 'com.aliyun.aio:AliVCSDK_StandardLive:1.6.0'
    //5.短视频 + 播放器
    implementation 'com.aliyun.aio:AliVCSDK_UGC:1.6.0'
    //6.短视频 + 美颜特效 + 播放器
    implementation 'com.aliyun.aio:AliVCSDK_UGCPro:1.6.0'
    //7.直播推流（含超低延时直播、RTC连麦） + 播放器
    implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:1.6.0'
    //8.直播推流（含超低延时直播、RTC连麦） + 美颜特效 + 播放器
    implementation 'com.aliyun.aio:AliVCSDK_PremiumLive:1.6.0'

离线集成

离线集成需要手动下载集成相应版本。

1. 拷贝需要的aar包到工程的libs目录下。
   说明 如果没有libs文件夹，手动创建libs文件夹即可。以1.2.0版本为例，实际版本根据您的业务情况选择。

   将下载的 AAR 文件放入项目的 libs 目录，目录结构示例：

   libs
       AliVCSDK_Premium_v1.2.0_release.aar
   src

2. 修改Project下的build.gradle文件，在allprojects的repositories节点中增加flatDir的设置。

   flatDir {
      dirs 'libs'
   }

3. 修改App的build.gradle文件，dependencies节点中增加对aar的引用。

   dependencies {
         implementation fileTree(dir: 'libs', include: ['*.aar'])
   }

配置App权限

######################短视频权限配置#########################
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.RECORD_VIDEO" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
######################直播权限配置#########################
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.REORDER_TASKS" />
<uses-permission android:name="android.permission.VIBRATE" />
//添加录音权限
<uses-permission android:name="android.permission.RECORD_AUDIO" />
//添加相机权限
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
        

配置License授权

首次接入SDK，需要获取License，并获取到对应的License Key和License配置文件。详细操作，请参见License使用说明。

设置混淆规则

######################播放器混淆配置#########################
-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**
######################短视频混淆配置#########################
-keep class com.aliyun.**{*;}
-keep class com.duanqu.**{*;}
-keep class com.qu.**{*;}
-keep class com.alibaba.**{*;}
-keep class component.alivc.**{*;}
-keep class com.alivc.**{*;}
-keep class org.webrtc.**{*;}
-keep class org.ugsv.**{*;}
######################直播混淆配置#########################
-keep class com.alivc.** { *;}
-keep class com.aliyun.rts.network.* { *;}
-keep class org.webrtc.ali.** {*;}
-keep class org.webrtc.utils.** {*;}

API文档

音视频终端SDK的主要接口及相关说明请参见接口概览。

常见集成问题

集成常见问题，请参见常见问题。