文档中心
互动直播
Agora.io 社区
中文
search-icon
跑通示例项目
更新时间 2021/02/18 02:42:22

概览

Agora 在 GitHub 上提供一个开源的视频互动直播示例项目 OpenLive-Android。本文介绍如何快速跑通该示例项目，体验 Agora 视频互动直播效果。

如果你是第一次使用声网的服务，我们推荐观看下面的视频，了解关于声网服务的基本信息以及如何快速跑通示例项目。

视频中展示的 UI 可能有部分调整更新，请以当前最新版为准。

前提条件

  • 开发环境要求：
  • 如果你的网络环境部署了防火墙，请根据应用企业防火墙限制打开相关端口。
  • 一台真实的 Android 设备。部分模拟机可能存在功能缺失或者性能问题，所以推荐使用真机。
  • 有效的 Agora 开发者账号。

操作步骤

1. 创建 Agora 项目

按照以下步骤，在控制台创建一个 Agora 项目。

  1. 登录 Agora 控制台，点击左侧导航栏 img 项目管理按钮进入项目管理页面。

  2. 在项目管理页面，点击创建按钮。

    创建项目

  3. 在弹出的对话框内输入项目名称，选择鉴权机制为 APP ID + Token。

  4. 点击提交，新建的项目就会显示在项目管理页中。

2. 获取 App ID

Agora 会给每个项目自动分配一个 App ID 作为项目唯一标识。

在 Agora 控制台的项目管理页面，找到你的项目，点击 App ID 右侧的眼睛图标就可以直接复制项目的 App ID。

获取appid

3. 生成临时 Token

为提高项目的安全性，Agora 使用 Token（动态密钥）对即将加入频道的用户进行鉴权。

为了方便测试，Agora 控制台提供生成临时 Token 的功能，具体步骤如下：

  1. 在控制台的项目管理页面，点击已创建项目的 图标，打开 Token 页面。

  2. 输入一个频道名，例如 test，然后点击生成临时Token。临时 Token 的有效期为 24 小时。加入频道时，请确保填入的频道名与生成临时 Token 时填入的频道名一致。

临时 Token 仅作为演示和测试用途。在生产环境中，你需要自行部署服务器签发 Token，详见生成 Token。
对于本示例项目，请将频道名设为 test。

4. 配置示例项目

参考以下步骤配置示例项目：

  1. 克隆 Basic-Video-Broadcasting 仓库至本地。
  2. 找到 Basic-Video-Broadcasting/OpenLive-Android 示例项目文件夹，在 /app/src/main/res/values/strings_config.xml 文件中填写你从声网控制台获取到的 App ID 和临时 Token。
    // 把 <#YOUR APP ID#> 替换成你的 App ID，字符串格式
<string name="private_app_id" translatable="false"><#YOUR APP ID#></string>
// 把 <#YOUR ACCESS TOKEN#> 替换成你的临时 Token，字符串格式
<string name="agora_access_token" translatable="false"><#YOUR ACCESS TOKEN#></string>

5. 编译并运行示例项目

连接上 Android 设备后，用 Android Studio 打开 OpenLive-Android 示例项目，然后编译并运行示例项目。

运行成功后，你会在 Android 设备上看到如下画面。

加入 test 频道。你需要选择在频道中的角色是观众还是主播，主播既能发流也能收流，观众只能收流不能发流。如果想体验视频互动直播效果，你可以通过声网的 Web 端示例应用，输入相同的 App ID、频道名和临时 Token，加入同一频道与 Android 端互通。

score