Android

企业直播在 GitHub 上提供开源示例项目 BDLiveDemo_Android 用于演示如何集成和使用企业直播 aPaaS SDK。该项目包含以下 Demo：

• SimpleViewer：演示了如何通过少量代码接入完整直播间。
• SinglePlayerViewViewer：演示了如何接入独立播放器组件，并在此基础上实现视频的控制界面。
• SimpleStreamer：演示了如何通过少量代码接入开播 SDK。
• StreamerAndViewer：演示了如何通过少量代码同时接入观播 SDK 和开播 SDK。

本文以 SimpleViewer 为例，介绍如何快速编译并运行 Demo。

前提条件

• 安装 Android Studio，建议使用 4.0 及以上版本。
• Android 5.0（API 级别 21）及以上版本的真机。
• CPU 架构：armeabi-v7a 或 arm64-v8a。
• 仅支持 AndroidX 库。
• minSdkVersion：21（Android 5.0）
• targetSdkVersion：32（Android 12）
• JDK version：1.8.0 及以上
• 获取直播 License 文件和点播 License 文件、创建 SDK 应用时填写的 App 英文名称和 Android 项目包名，以及应用创建后生成的 App ID。详见获取 License。

操作步骤

1. 在终端中运行以下命令，将 BDLiveDemo_Android 仓库克隆至本地：

   git clone https://github.com/volcengine/BDLiveDemo_Android.git
   

2. 在 Android Studio 中打开 BDLiveDemo_Android 项目的 SimpleViewer 文件夹。

3. 在 app/src/main 目录下，创建 assets/lic 目录并把获取到的直播 License 文件 liveLicense.lic 和点播 License 文件 vodLicense.lic 放到 assets/lic 目录下。文件结构如下：

   app
   |-- src
       |-- main
           |-- java
           |-- assets
               |-- lic
                   |--  liveLicense.lic
                   |--  vodLicense.lic
   

4. 在 app 目录下的 build.gradle 文件中，将 applicationId 的值修改为创建 SDK 应用时填写的 Android 项目包名。

5. 打开 app/src/main/java/com/bytedance/videoarch/ttLiveStream 目录下的 MyApplication.java 文件，填写鉴权相关信息。

   public class MyApplication extends Application {
   
       private final static String mAppId = "APP_ID"; // 将 APP_ID 替换为在 SDK 应用创建后生成的 App ID
       private final static String mAppName = "APP_NAME"; // 将 APP_NAME 替换为创建 SDK 应用时填写的 App 英文名称
       private final static String mRegion = "REGION"; // 将 REGION 替换为创建 SDK 应用时使用的地域，即 china
       private final static String mVersion = "APP_VERSION"; // 将 APP_VERSION 替换为 App 的版本号。合法版本号应包含 2 个或以上的分隔符，例如 1.3.2
       private final static String mChannel = "CHANNEL_NAME"; // 将 CHANNEL_NAME 替换为 App 的渠道名称，例如小米应用商店(xiaomi)、华为应用市场(huawei)等
       private final static String mLiveLicenseUri = "assets:///lic/example.lic"; // 将 assets:///lic/example.lic 替换为直播 License 的 URI
       private final static String mVodLicenseUri = "assets:///lic/example.lic"; // 将 assets:///lic/example.lic 替换为点播 License 的 URI
       
   ... 
   }
   

   注意

   请确保以下事项，以免鉴权失败：

   • mAppId 的参数值必须与在 SDK 应用创建后生成的 App ID 一致。
   • 步骤 4 中配置的 applicationId 的值必须与创建 SDK 应用时填写的 Android 项目包名一致。

6. 连接上 Android 设备后，在 Android Studio 中单击 Run 图标运行项目。

7. 项目运行成功后，根据提示在您的 Android 设备上安装名为 ByteLiveDemo 的 App。

8. 打开 App，可以看到以下界面。此处预填了企业直播官方 Demo 直播间的活动 ID 和进入直播间所需的授权 Token。点击 JOIN 即可进入直播间。