文档中心
ExpressVideoSDK 实时音视频
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 实时音视频
  • 快速开始
  • 跑通示例源码

示例源码运行指引

更新时间:2025-06-05 10:39

示例源码
GitHub下载
  • GitHub下载
  • Gitee下载
说明
功能体验
GitHub地址
  • GitHub地址

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

准备环境

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

浏览器 Windows Mac Android iOS Harmony OS
Chrome 58 或以上 ✔️ ✔️ ✔️
  • iOS 14.3 或以上版本支持推拉流
  • iOS 14.3 以下版本仅支持拉流
✖
FireFox 56 或以上 ✔️ ✔️ ✔️ ✖ ✖
Safari 11 或以上 - ✔️ - ✔️ ✖
Opera 45 或以上 ✔️ ✔️ 部分支持 ✖ ✖
QQ 浏览器最新版 ✔️ ✔️ 部分支持 ✖ ✖
360 安全浏览器极速模式 ✔️ ✔️ ✖ ✖ ✖
微信浏览器 - - ✔️
  • iOS 14.3 或以上版本,并且当微信版本为 6.5 或以上时,支持推拉流
  • iOS 14.3 以下版本仅支持拉流
✖
WebView - - ✔️
  • iOS 14.3 或以上版本支持推拉流
  • iOS 14.3 以下版本仅支持拉流
✖
华为浏览器 ✖ ✖ ✖ ✖ Mate 60 Pro 机型、HarmonyOS NEXT beta 2 版本的操作系统的华为浏览器

仅支持 SSL 的 Web 服务器(HTTPS)。本地调试工具的 Web 服务域名可使用 localhost 或 127.0.0.1。

前提条件

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

Server 地址并非 ServerSecret,您可以参考下图在 ZEGO 控制台获取 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。

    /Pics/Web/ExpressSDK/SampleRunningGuide/UI_interface.png

体验实时音视频功能

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

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

本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈