通过阅读本文,您可以了解Android端推流SDK的集成方法。

前提条件

环境中已安装Android Studio,下载地址请参见Android Studio

环境要求

类别 要求
系统版本 支持Android 5.0及以上版本。
API版本 支持21及以上版本。
CPU架构 ARM64、ARMv7。

操作步骤

  1. 集成Android端推流SDK。
    • 方法一:Maven集成(推荐)

      在工程build.gradle配置脚本中的dependencies中添加如下代码:

      implementation 'com.alivc.pusher:AlivcLivePusher:4.4.3'
      说明 此处Maven依赖的版本仅供参考,获取最新的Maven依赖,请参见SDK下载与历史记录
    • 方法二:手动集成
      1. 下载并解压Android端推流SDK,下载地址,请参见SDK下载与历史记录
      2. 复制SDK目录下文件至工程对应libs目录。
      3. 修改项目的app/build.gradle文件中的dependencies,同步工程。
        implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
        arr的集成方式-新
        说明 使用背景音乐功能时,必须集成播放器SDK(AliyunPlayer.aar)。
  2. src/main/AndroidManifest.xml文件中添加如下代码,添加请求权限。
    <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" />
  3. proguard-rules.pro文件中添加混淆规则。
    -keep class com.alivc.** { *;}
    -keep class com.aliyun.rts.network.* { *;}
    -keep class org.webrtc.ali.** {*;}
    -keep class org.webrtc.utils.** {*;}
    注意 如遇到nativeLog问题,您可以在工程初始化增加System.loadLibrary("all_in_one")

配置License

请提前获取License,获取方式参见获取推流SDK License。LicenseKey和LicenseFile会通过授权邮件发送。获取推流SDK License文件后,您需要按照以下操作配置License文件。

说明 当您同时集成视频直播推流SDK License和美颜特效SDK License时,两者的LicenseKey和LicenseFile(证书文件)是相同的,只需配置一次即可(注意证书文件需使用最新的一份)。
  1. 将获取到的LicenseFile文件预置到assets目录下。
  2. AndroidManifest.xml中配置LicenseKey和LicenseFile,示例如下,将配置文件中的Your licenseKeyYour licenseFile替换成您实际获取的值。
    <!-- android:name: 元数据项名字,固定取值 -->
    <!-- android:value: 元数据项指定值,请填入您邮件获取到的LicenseKey -->
    <meta-data
        android:name="com.aliyun.alivc_license.licensekey"
        android:value="Your licenseKey" />
    
    <!-- android:name: 元数据项名字,固定取值 -->
    <!-- android:value: 元数据项指定值,请填入您邮件获取到的LicenseFile所在的assets路径 -->
    <meta-data
        android:name="com.aliyun.alivc_license.licensefile"
        android:value="assets/Your licenseFile.crt" />

更新License文件

如果您购买的SDK版本发生变更或需要续期(SDK到期),需要更新证书文件。更新操作如下:
  1. 重新获取Licence,具体请参见获取推流SDK License
  2. 获取最新证书文件后,执行本文中配置License操作更新证书。

SDK使用说明