SDK集成

环境要求

步骤一：集成SDK

Maven集成（推荐）

1. 修改项目的build.gradle文件，添加Maven仓库地址。

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

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

   本文中引入的SDK版本号仅供参考，获取最新的版本请参见SDK下载与发布记录。

   //以下SDK请根据自己的业务需要，选择一种接入即可
   
   //1.基础版推流SDK（不支持连麦）
   implementation 'com.alivc.pusher:AlivcLivePusher:6.17.0'
   //2.互动版推流SDK（支持连麦）
   implementation 'com.alivc.pusher:AlivcLivePusher_Interactive:6.17.0'

3. 修改App的build.gradle文件，添加App对应的CPU架构。

   defaultConfig {
    ndk {
    abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
    }
   }

手动集成

1. 下载并解压推流SDK。

2. 复制SDK文件*.aar到App模块下的libs文件夹。

3. 修改项目的build.gradle文件，在allprojects的repositories节点中增加flatDir配置。

   flatDir {
    dirs 'libs'
   }

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

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

步骤二：配置License授权

推流SDK升级到4.4.2及以后版本，接入一体化License服务，您需要推流SDK License集成指南。

步骤三：配置App权限

修改App的src/main/AndroidManifest.xml文件，配置App权限。

<!--  Used for network features  -->
<uses-permission android:name="android.permission.INTERNET" />
<!--  To check the network connection state of the device, you'll need to add the ACCESS_NETWORK_STATE permission.  -->
<!--  This permission does not require user consent at runtime, but needs to be declared in the app's AndroidManifest.xml.  -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!--  If the app needs to record audio, you need to declare the RECORD_AUDIO permission and request this permission at runtime  -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<!--  The application needs to access the device's camera  -->
<uses-permission android:name="android.permission.CAMERA" />

<!-- Request legacy Bluetooth permissions on older devices. -->
<uses-permission
  android:name="android.permission.BLUETOOTH"
  android:maxSdkVersion="30" />
<uses-permission
  android:name="android.permission.BLUETOOTH_ADMIN"
  android:maxSdkVersion="30" />
<!-- Needed only if your app communicates with already-paired Bluetooth devices. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- Only used by Demo for accessing storage files  -->
<!--  Storage permissions  -->
<uses-permission
  android:name="android.permission.READ_EXTERNAL_STORAGE"
  android:maxSdkVersion="32" />
<!-- Access image files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_IMAGES"
  android:minSdkVersion="33" />
<!-- Write audio files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_AUDIO"
  android:minSdkVersion="33" />
<!-- Write video files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_VIDEO"
  android:minSdkVersion="33" />

<!-- Only used by Demo for screen recording and streaming  -->
<!-- Used for creating background tasks, not required by SDK -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Requesting permission to create system overlay windows -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

<!-- Only used by Demo for muting  -->
<!-- If this permission is not declared, the feature of automatically muting the stream during a phone call will not work -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

步骤四：配置混淆规则

修改App的proguard-rules.pro文件，添加混淆规则。

-keep class org.webrtc.** { *; }
-keep class com.alivc.** { *; }
-keep class com.aliyun.** { *; }
-keep class com.cicada.** { *; }

相关文档

• Android基础版推流SDK接口说明

• Android互动版推流SDK接口说明

• API使用示例