Skip to content

README.zh.md

Latest commit

 

History

History
84 lines (60 loc) · 3.48 KB

README.zh.md

File metadata and controls

84 lines (60 loc) · 3.48 KB

Open Video Call for Android

English | 中文

这个开源示例项目演示了如何快速集成 Agora 视频 SDK，实现多人视频通话。

在这个示例项目中包含了以下功能：

  • 加入通话和离开通话；
  • 静音和解除静音；
  • 关闭摄像头和打开摄像头；
  • 切换前置摄像头和后置摄像头；
  • 发送频道内消息；
  • 选择分辨率、码率和帧率；
  • 设置加密模式；
  • 开启和关闭黑白滤镜；

你也可以在这里查看入门版的示例项目：Agora-Android-Tutorial-1to1

环境准备

  • Android Studio 3.3 +
  • 真实 Android 设备 (Nexus 5X 或者其它设备)
  • 部分模拟器会存在功能缺失或者性能问题，所以推荐使用真机

运行示例程序

这个段落主要讲解了如何编译和运行实例程序。

创建Agora账号并获取AppId

在编译和启动实例程序前，您需要首先获取一个可用的App ID:

  1. 在agora.io创建一个开发者账号

  2. 前往后台页面，点击左部导航栏的 项目 > 项目列表 菜单

  3. 复制后台的 App ID 并备注，稍后启动应用时会用到它

  4. 在项目页面生成临时 Access Token (24小时内有效)并备注，注意生成的Token只能适用于对应的频道名。

  5. 将 AppID 填写进 "app/src/main/res/values/strings_config.xml"

<string name="private_app_id"><#YOUR APP ID#></string>
<!-- 如果你没有打开证书，请将Token字段留空 -->
<!-- 你可以在 https://dashboard.agora.io/projects 生成一个临时的Token -->
<string name="agora_access_token"><#YOUR TOKEN#></string>

集成 Agora 视频 SDK

集成方式有以下两种：

  • 首选集成方式：
    • 在项目对应的模块的 app/build.gradle 文件的依赖属性中加入通过 JCenter 自动集成 Agora 视频 SDK 的地址： 
      implementation 'io.agora.rtc:full-sdk:2.4.1'
      (如果要在自己的应用中集成 Agora 视频 SDK，添加链接地址是最重要的一步。）
    • 在 Agora.io SDK 下载 视频通话 + 直播 SDK，解压后将其中的 libs/include 文件夹下的 *.h 复制到本项目的 app/src/main/cpp/agora 下。
  • 次选集成方式：

    • 在 Agora.io SDK 下载 视频通话 + 直播 SDK并解压，按以下对应关系将 libs 目录的内容复制到项目内。

      SDK目录 项目目录
      .jar file /apps/libs folder
      arm64-v8a folder /app/src/main/jniLibs folder
      x86 folder /app/src/main/jniLibs folder
      armeabi-v7a folder /app/src/main/jniLibs folder

启动应用程序

用 Android Studio 打开该项目，连上设备，编译并运行。

也可以使用 Gradle 直接编译运行。

联系我们

  • 完整的 API 文档见 文档中心
  • 如果在集成中遇到问题, 你可以到 开发者社区 提问
  • 如果有售前咨询问题, 可以拨打 400 632 6626，或加入官方Q群 12742516 提问
  • 如果需要售后技术支持, 你可以在 Agora Dashboard 提交工单
  • 如果发现了示例代码的 bug, 欢迎提交 issue

代码许可

The MIT License (MIT)