Android

最近更新时间：2023.09.01 10:22:41

首次发布时间：2022.08.16 20:40:47

为了更好的上手移动端视频直播 App 的搭建工作，我们推出了 VeLiveQuickStartDemo ，VeLiveQuickStartDemo 基于视频直播 SDK 开发，目前接入了基础、高级、互动三大功能模块。

基础功能模块：基础推拉流能力。
高级功能模块：码率自适应、自采集推流、H265 硬编码推流、RTM 推流、画中画。
互动功能模块：主播和观众连麦、主播和主播 PK。

您可以根据下列操作指引快速跑通 Demo。

环境要求

Android 5.0（SDK API Level 21）及以上版本。
Android Studio 4.0 以及以上版本。
Android 5.0 或以上版本的真机，暂不支持模拟器调试。
Demo App 支持的设备 CPU 架构为 armeabi-v7a 或 arm64-v8a。

前提条件

已完成火山引擎账号注册，并实名认证。
已开通视频直播服务，并添加推拉流域名至视频直播控制台。
如需体验互动功能模块，需开通实时音视频服务。

准备工作

本章节介绍跑通 Demo 前的准备工作。

获取视频直播 SDK License

登录视频直播控制台。
左侧导航栏选择功能管理 > SDK 管理，单击创建 SDK 应用，在弹出的对话框中填写应用信息。
单击下一步，配置 License，单击确认返回应用列表。
在应用列表，记录 App ID ，将新建应用的 SDK License 下载到本地。

获取实时音视频 AppID 和 Token 信息

说明

如果您没有互动直播的体验需求，请跳过此操作。

登录实时音视频控制台。
左侧导航栏选择应用管理，单击创建应用，在弹出的对话框中填写应用名称选择默认项目，单击确定，返回应用列表。
在应用列表记录实时音视频应用的 AppID。
在应用列表，单击应用操作列的临时 Token ，在弹出的对话框中生成 Token 信息。
- A 主播连麦场景：使用 A 主播的 RoomId、UserId，生成 Token。
- A 主播 PK B 主播：使用 B 主播的 RoomId，A 主播的UserId，生成 Token。

跑通 Demo

本章节介绍从下载 Demo 到编译 Demo 的详细操作步骤。

下载 Demo 源码

从GitHub地址下载 Demo 源码。

Demo文件目录结构说明。

Android/VeLiveQuickStartDemo/app/src/main/java/com/ttsdk/quickstart
├── app /// App Demo 入口页面
├── features /// 功能入口
│   ├── basic /// 基础功能入口
│   │   ├── PullStreamActivity.java /// 基础拉流能力
│   │   └── PushCameraActivity.java /// 摄像头采集基础推流能力
│   ├── advanced /// 高级功能入口
│   │   ├── PushAutoBitrateActivity.java /// 码率自适应
│   │   ├── PushBeautyActivity.java /// 美颜 
│   │   ├── PushCustomActivity.java /// 自采集推流
│   │   ├── PushH265CodecActivity.java  /// 265 硬编码推流
│   │   ├── PictureInPictureActivity.java  /// 画中画
│   │   └── PushRTMActivity.java /// RTM 推流
│   └── interact  /// 互动直播
│       ├── link /// 主播和观众连麦
│       ├── manager /// 互动直播交互管理
│       └── pk /// 主播和主播PK
└── helper /// 一些工具类，包含 SDK 初始化和自采集

配置 SDK License

修改使用下载到本地的 SDK License 文件名称为 ttsdk.lic。
使用修改好名称的 SDK License 文件替换 Android/VeLiveQuickStartDemo/app/src/main/assets/ 目录下的 ttsdk.lic文件。

更新 Gradle 配置

使用 Android Studio 打开 Demo，进入 Android/VeLiveQuickStartDemo 目录。
在顶部菜单栏中，单击 Sync Project with Gradle Files 按钮，更新 Gradle 配置。

配置推流/拉流能力

打开 VeLiveQuickStartDemo/app/src/main/java/com.ttsdk.quickstart/helper/VeLiveSDKHelper.java 文件。

设置视频直播的 APP ID、推流地址、拉流地址。

说明

推流地址和拉流地址使用视频直播控台的地址生成器生成。

// AppID
public static String TTSDK_APP_ID = "536110";
/*
rtmp, RTM, Quic 推流地址    生成方式：通过控制台生成 https://console.volcengine.com/live/main/locationGenerate    
*/
public static String LIVE_PUSH_URL = "";
public static String LIVE_RTM_PUSH_URL = "";

/*
RTM, rtmp、flv、m3u8 拉流地址    生成方式：通过控制台生成 https://console.volcengine.com/live/main/locationGenerate    
*/
public static String LIVE_PULL_URL = "";
public static String LIVE_RTM_PULL_URL = "";

配置连麦/PK能力

打开 VeLiveQuickStartDemo/app/src/main/java/com.ttsdk.quickstart/helper/VeLiveSDKHelper.java 文件。

设置的互动直播场景时实时音视频的 AppID 和 Token 信息。

/*
     互动直播AppID
     */
    public static String RTC_APPID = "";

    /*
     互动直播主播房间ID
     */
    public static String RTC_ROOM_ID = "";

    /*
     互动直播主播用户ID
     */
    public static String RTC_USER_ID = "";

    /*
     互动直播主播用户 Token
     生成方式：使用主播房间ID和主播用户ID在RTC控制台生成
     https://console.volcengine.com/rtc/listRTC
     */
    public static String RTC_USER_TOKEN = "";

    /*
     主播与主播PK时，对方主播的房间ID
     */
    public static String RTC_OTHER_ROOM_ID = "";

    /*
     主播与主播PK时，当前主播加入对方主播房间内的Token
     生成方式：使用当前主播的用户ID和对方主播的房间ID在控制台生成
     */
    public static String RTC_OTHER_ROOM_TOKEN = "";

配置应用包名（PackageName）

打开 VeLiveQuickStartDemo/app/build.gradle 文件。
修改 application 为创建视频直播应用时填写的 packagename。

编译 Demo App

使用 Android 真机连接计算机。
在 Android Studio 中选择连接的 Android 真机，单击 Run。
待编译完成后，将会在连接计算机的 Android 真机上安装并运行视频直播 Demo App。