跑通示例项目
更新时间: 2024/08/02 11:26:48
网易云信音视频通话 2.0 产品为您提供开源的的示例项目,您可以参考本文档快速跑通示例项目,快速在本地运行示例 Demo,体验 NERTC SDK 的实时音视频通话的效果。
前提条件
在开始运行示例项目之前,请确保您已完成以下操作:
- 已创建应用并获取 App Key。
- 已开通音视频通话 2.0 服务。
- 集成 SDK。
- 联系技术支持进行初始化配置,例如开通调试模式等。
开发环境
在开始运行示例项目之前,请确保开发环境满足以下要求:
- 微信 App iOS 最低版本要求:8.0.0
- 微信 App Android 最低版本要求:8.0.0
- 小程序基础库最低版本要求:2.10.0
- 由于微信开发者工具不支持原生组件(即 < live-pusher > 和 < live-player > 标签),需要在真机上进行运行体验。
注意事项
- 跑通示例项目时,建议维持 Demo 的 baseURL 设置,如果需要基于 Demo 开发自己的应用,需要将其改为您的 App Server 业务服务端地址。
- 示例项目默认使用安全模式。但是在跑通示例项目时,您需要使用调试模式, 在
/pages/group-call/join/join.js
中的token: avRoomCheckSum
中把 Token 设为空。此时无需传入 Token 即可加入房间。但是出于安全考虑,应用正式上线前,请在控制台中将指定应用的鉴权方式改回安全模式。
示例项目结构
项目结构中的文件说明如下:
文件夹 | 说明 |
---|---|
config | 配置文件 |
components/nertc-room | 封装了云信小程序音视频通话2.0 SDK的组件 |
pages/group-call/join | 加入房间前的页面 |
pages/group-call-room | 进入房间后的页面 |
开通小程序类目与推拉流标签权限
微信小程序使用实时音视频功能之前,需要添加推拉流标签权限(即 < live-pusher > 和 < live-player > 标签),但是出于政策和合规等原因,仅企业类小程序和指定类目的小程序可以开通推拉流标签权限。
类目列表请查看 live-pusher 文档
- 请为您的小程序添加企业认证,并确保其符合类目要求。
- 在微信公众平台>开发>接口设置中自助开通该组件权限。
运行示例源码
-
打开微信开发者工具,通过导入的方式创建新的小程序项目。
-
目录选择 Demo 源码所在目录,AppID 一栏填写您微信小程序的 AppID,单击导入。
-
找到
/config/index.js
中的 Appkey 字段,填入您云信应用的 Appkey。 -
在微信开发者工具中,在页面右上角单击 详情 > 本地设置,勾选 不校验合法域名、web-view(业务域名)、TLS版本以及 HTTPS 证书。
-
在页面顶部单击真机调试,通过手机微信扫描二维码即可进入小程序。
此文档是否对你有帮助?