跳到主要内容

运行示例项目(Demo)

融云音视频通话 QuickDemo(GitHub · Gitee)演示了融云产品音视频通话在 Web 端的功能,以便开发者体验产品,快速集成,实现单群聊、音视频通话等场景需求。

QuickDemo 开放源代码,您可以对感兴趣的部分进行代码改造,以便进一步了解细节。

环境要求

所有支持浏览器请参见Web 兼容性。推荐使用 Google Chrome 最新版体验 QuickDemo。

融云开发者账户

  • 注册开发者账号。注册成功后,控制台会默认自动创建您的首个应用,默认生成开发环境下的 App Key,使用国内数据中心。

  • 获取开发环境的应用 App Key。如不使用默认应用,请参考 如何创建应用,并获取对应环境 App Key 和 App Secret

    注意

    每个应用具有两个不同的 App Key,分别对应开发环境与生产环境,两个环境之间数据隔离。在您的应用正式上线前,可切换到使用生产环境的 App Key,以便上线前进行测试和最终发布。

  • 如果仅为体验 QuickDemo 创建应用,建议选择国内数据中心。如果选择海外数据中心,则需要额外在 QuickDemo 中修改 SDK 连接的服务地址。配置方法可参见 数据中心

(width=800)

您需要记录上图所示的应用 App Key,在本教程中使用。

应用的 App Key / Secret 是获取连接融云服务器身份凭证的必要条件。请注意不要泄露。

App Secret 用于生成数据签名,仅在请求融云服务端 API 接口时使用。本教程中暂不涉及。

开通音视频服务

开发环境下的每个应用均可享有 10000 分钟免费体验时长。如果在开发环境下开通音视频服务,可直接按照以下步骤开通音视频服务。服务开通后即可开始免费体验和测试。免费体验时长用完即止。

如果在生产环境下开通音视频服务,则需要先预存费用,才可开通。详情请参考开通音视频服务

获取用户 Token

用户 Token 是与用户 ID 对应的身份验证令牌,是应用程序的用户在融云的唯一身份标识。应用客户端必须与融云建立 IM 连接,连接时必须传入 Token。

在实际业务运行过程中,应用客户端需要通过应用的服务端调用 IM Server API 申请取得 Token。详见 Server API 文档 注册用户

在本教程中,为了快速体验和测试 SDK,我们将使用控制台「北极星」开发者工具箱,从 API 调试页面调用 获取 Token 接口,获取到 userId 为 1 的用户的 Token。提交后,可在返回正文中取得 Token 字符串。

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200,"userId":"1","token":"gxld6GHx3t1eDxof1qtxxYrQcjkbhl1V@sgyu.cn.example.com;sgyu.cn.example.com"}

运行 QuickDemo

在运行 QuickDemo 前请确保已完成上述步骤。以下是检查清单:

  • 已注册融云开发者账户
  • 已准备好 App Key
  • 已开通音视频服务免费体验,且已等待 30 分钟
  • 已获取用于体验的 Token
  1. 克隆下载示例代码。

    git clone https://github.com/rongcloud/web-quickdemo-calllib-v5.git
  2. 使用浏览器直接打开 index.html 进行操作。

  3. 运行成功后,请按照提示输入 App Key,Token即可进入体验。