示例源码运行指引

---

本文介绍如何快速跑通示例源码，体验基础的音视频通话服务。

准备环境

在开始集成 ZEGO Express SDK 前，请按照以下兼容性要求，安装浏览器：

前提条件

已在 ZEGO 控制台 创建项目，申请有效的 AppID，以及获取到接入服务器的 “Server 地址”，详情请参考 控制台 - 项目管理 中的“项目信息”。

示例源码目录结构

以下目录结构为 express-demo-web 子目录的文件结构，下文所涉及的文件路径均为相对于此目录的路径。

.
├── README.md
...
└── src  # 源码文件夹
    ├── Examples  # 示例代码
    │   ├── AdvancedAudioProcessing   # 音频进阶功能
    │   ├── AdvancedStreaming         # 推拉流进阶
    │   ├── AdvancedVideoProcessing   # 视频进阶功能
    │   ├── CommonFeatures            # 常用功能
    │   ├── DebugAndConfig            # 调试与配置
    │   ├── Framework                 # 最佳实践/框架相关
    │   ├── Others                    # 其他功能
    │   ├── QuickStart                # 快速开始
    │   └── Scenes                    # 最佳实践/场景相关
    ├── assets    # 资源文件夹，存放项目共用的资源文件，包括sdk、各类依赖库、翻译相关的配置文件等
    └── KeyCenter.js  # 配置相关文件，可以填写申请的appID、server地址等

运行示例源码

1. 在下载的示例源码中，使用支持的浏览器，打开 “./src/Examples/DebugAndConfig/InitSettings/index.html” 文件，输入 前提条件 中获取的 AppID 和 Server 地址（不是 ServerSecret）后，单击“设置”。

   

2. 设置完成后，可以开始体验 Demo 功能，即可使用支持的浏览器，打开 “./src/Examples” 文件夹下各场景功能的 HTML 文件。例如打开 “QuickStart/CommonUsage” 文件夹下的 “index.html”。

   • 如果页面存放的本地路径中带有中文字符，打开页面时，部分浏览器加载 CSS 等样式文件可能会失败，页面将显示异常。建议开发者将源码文件的路径名称全部设置为“英文字符”。

   • 为方便开发者调试，ZEGO 控制台 提供生成临时 Token 的功能，开发者可直接获取临时 Token 来使用，详情请参考 控制台 - 开发辅助。但是在开发者自己的线上环境中，一定要通过自己的服务端生成 Token。

   

体验实时音视频功能

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

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