You need to enable JavaScript to run this app.
导航

Android

最近更新时间2024.05.17 17:41:20

首次发布时间2023.06.07 10:39:39

企业直播在 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:minSdkVersion 及以上、34(Android 14)及以下。

    说明

    如需跑通 StreamerAndViewer,则为 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 即可进入直播间。
    图片