跑通示例源码

示例代码运行指引

本示例源码仅针对支付宝原生组件。

准备环境

请确保开发环境满足以下技术要求：

• 已安装 支付宝小程序开发者工具。

• 使用支付宝小程序基础库 1.23.0 及以上版本，低版本需要做 兼容处理。

• 请确保您已自行联系支付宝商务人员，开通了相关权限，并获取到了接入 MRTC 的相应参数，以及完成了挂包（Android 设备需要下载挂包）后，才可以正常使用 RTC room 组件。如果您

• 确保您的支付宝小程序符合以下类目，并开通实时音视频权限（获取到对应的小程序 AppID），详情请参考 申请开通。

  

前提条件

请到 ZEGO 控制台 注册账号并申请初始化 SDK 时需要的 AppID 与 Server，申请流程请参考 项目管理。

示例源码目录结构

下面目录结构为 zego-express-alimini-sample 子目录的文件结构，下文所涉及的文件路径均为相对于此目录的路径。

.
├── libs    # 依赖库文件夹，存放如 SDK 的 js 文件等
│   └──ZegoExpressMiniProgram.js    # 小程序 SDK
├── pages   # 小程序页面 
│   ├── base    # 视频直播《基础推拉流》
│   ├── index    # 首页
│   ├── message     # 视频直播《实时消息》
│   ├── setting     # 自定义设置 设置 AppID
│   └── tokenRole   # Token 鉴权 v3
├── resource    # 资源文件夹，存放如图片等静态资源
├── utils       # 存放共享的工具类、方法等的 js 文件夹
├── app.js      # 支付宝小程序的入口文件
├── app.json    # 支付宝小程序公共设置
├── app.acss    # 支付宝小程序全局样式
├── package.json    # npm 包描述文件
└── mini.project.json # 支付宝小程序项目配置描述文件

运行示例代码

1. 使用编辑器（如 VS Code、WebStorm）打开已下载的项目。

2. 将 app.js 文件中的 zegoAppID 及 server 分别修改为 前提条件 中获取到的 AppID 和 Server，同时在 userID 和 token 中，传入正确的值，否则示例代码无法正常运行。

   为方便开发者调试，ZEGO 控制台 提供生成临时 Token 的功能，开发者可直接获取临时 Token 进行使用，但在开发者自己的线上环境中，请通过自己的服务端生成 Token。

3. 输入从支付宝 BD 获取到的 MRTC 参数，以及身份验证签名 signature。

   • MRTC 参数，包含 bizName、subBiz、以及 serverUrl。

   • RTC room 组件 的参数 signature，是由 bizName、subBiz、秘钥 key 等加密生成，具体生成规则请参考 流媒体签名使用说明。

     

4. 使用支付宝小程序开发者工具打开示例源码，在“详情”中，勾选如下图左下角的两个选项。

   

5. 编译运行示例代码，请使用手机扫码预览。

   若运行过程中出现问题，请联系 ZEGO 技术支持。

体验实时音视频功能

在真机中运行项目，运行成功后，可以看到本端视频画面。

为方便体验，ZEGO 提供了一个 Web 端调试示例 ，在该页面下，输入相同的 AppID、RoomID，输入不同的 UserID、以及对应的 Token，即可加入同一房间与真机设备互通。当成功开始音视频通话时，可以听到远端的音频，看到远端的视频画面。