跑通示例项目

更新时间: 2023/06/29 11:35:28

网易云信音视频通话 2.0 产品为您提供开源的的示例项目,您可以参考本文档快速跑通示例项目,快速在本地运行示例 Demo,体验 NERTC 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 文档

  1. 请为您的小程序添加企业认证,并确保其符合类目要求。
  2. 微信公众平台>开发>接口设置中自助开通该组件权限。

运行示例源码

  1. 打开微信开发者工具,通过导入的方式创建新的小程序项目。

  2. 目录选择 Demo 源码所在目录,AppID 一栏填写您微信小程序的 AppID,单击导入

  3. 找到 /config/index.js 中的 Appkey 字段,填入您云信应用的 Appkey。

  4. 在微信开发者工具中,在页面右上角单击 详情 > 本地设置,勾选 不校验合法域名、web-view(业务域名)、TLS版本以及 HTTPS 证书。

  5. 在页面顶部单击真机调试,通过手机微信扫描二维码即可进入小程序。

此文档是否对你有帮助?
有帮助
去反馈
  • 前提条件
  • 开发环境
  • 注意事项
  • 示例项目结构
  • 开通小程序类目与推拉流标签权限
  • 运行示例源码