本文介绍在Android端通过标准集成（无UI）方式实现主播端推流和观众端观看直播的功能。

背景信息

主播端推流和观众端观看是互动直播的基础场景。从集成的角度看，两个场景是独立于彼此的。用户可根据业务需要选择集成两个场景或其中一个场景。例如，只需要集成主播端推流的用户可以只集成主播端，避免接入不需要的模块而增加包大小。

前提条件

  • 客户端集成前，请确保已经通过控制台创建应用并获取客户端集成需要的信息（应用ID，APP Key）。创建指引请参见创建应用。
  • 客户端集成前，请确保已经完成服务端集成。集成指引请参见集成服务端SDK。

环境要求

  • 系统版本：仅支持Android 5.0及以上版本。
  • API版本：仅支持21及以上版本。
  • CPU架构：仅支持实体设备架构armeabi-v7a、arm64-v8a。
重要 不支持视频采集旋转，不支持USB外接摄像头。

主播端推流

  1. 基于Maven添加SDK远程依赖。
    1. 添加阿里云依赖仓库。
      将下列依赖库添加到项目工程根目录已有的build.gradle文件中。
      // 仓库地址
allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/releases' }
    }
}
    2. 添加SDK远程依赖。
      将下列依赖库添加到项目工程的app/build.gradle文件中。 
      dependencies {
    def LATEST_VERSION = ''
    api "com.aliyun.roompaas.biz:biz:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:chat:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:live:${LATEST_VERSION}"
}
      基础版美颜（非必选配置）
      dependencies {
    def LATEST_VERSION = ''
    api "com.aliyun.roompaas.biz:biz:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:chat:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:live:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:beauty_lite:${LATEST_VERSION}"
}
      专业版美颜（非必选配置）
      dependencies {
    def LATEST_VERSION = ''
    api "com.aliyun.roompaas.biz:biz:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:chat:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:live:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:beauty_pro:${LATEST_VERSION}"
}
      说明 美颜库Queen的'1.9.1-official-pro'版本是免授权的高级美颜版本，详情请参见美颜特效SDK。
  2. 配置应用权限。
    主播推流直播，需要获取设备本向的摄像头使用权限，麦克风的使用仅限，WIFI网络的使用权限。在工程目录的app/src/main/AndroidManifest.xml文件中配置以下权限：
    <uses-permission android:name="android.permission.INTERNET" />
<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.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.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  3. 接入代码。完整的代码实现逻辑请参见Android主播端标准集成互动直播源码。

观众观看直播

  1. 基于Maven添加SDK远程依赖。
    1. 添加阿里云依赖仓库。
      将下列依赖库添加到项目工程根目录已有的build.gradle文件中。
      // 仓库地址
allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/releases' }
    }
}
    2. 添加SDK远程依赖。
      将下列依赖库添加到项目工程的app/build.gradle文件中。 
      dependencies {
    def LATEST_VERSION = ''
    api "com.aliyun.roompaas.biz:biz:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:chat:${LATEST_VERSION}"
    api "com.aliyun.roompaas.biz:live:${LATEST_VERSION}"
}
  2. 接入代码。完整的代码实现逻辑请参见Android观众端标准集成互动直播源码。