运行示例项目(Demo)
融云音视频通话 QuickDemo(GitHub · Gitee)演示了融云产品音视频通话在 Web 端的功能,以便您体验产品,快速集成,实现单群聊、音视频通话等场景需求。
QuickDemo 开放源代码,您可以对感兴趣的部分进行代码改造,以便进一步了解细节。
环境要求
所有支持浏览器请参见Web 兼容性。推荐使用 Google Chrome 最新版体验 QuickDemo。
融云开发者账户
每个应用具有两个不同的 App Key,分别对应开发环境与生产环境,两个环境之间数据隔离。在您的应用正式上线前,可切换到使用生产环境的 App Key,以便上线前进行测试和最终发布。
-
注册开发者账号。注册成功后,控制台会默认自动创建您的首个应用,默认生成开发环境下的 App Key,使用国内数据中心。
-
获取开发环境的应用 App Key。如不使用默认应用,请参考 如何创建应用,并获取对应环境 App Key 和 App Secret。
-
如果仅为体验 QuickDemo 创建应用,建议选择国内数据中心。如果选择海外数据中心,则需要额外在 QuickDemo 中修改 SDK 连接的服务地址。配置方法可参见 数据中心。
您需要记录应用的 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
- 已开通音视频服务免费体验,且已等待 15 分钟
- 已获取用于体验的 Token
-
克隆下载示例代码。
shellgit clone https://github.com/rongcloud/web-quickdemo-calllib-v5.git -
使用浏览器直接打开
index.html进行操作。 -
运行成功后,请按照提示输入 App Key,Token 即可进入体验。