GO课堂
  • 平台类型
  • 框架 / 引擎
  • iOS
  • Android
  • macOS
  • Windows
  • Linux
  • Web
  • 小程序
客户端+服务端
示例源码
GitHub 下载
说明

本示例源码包含了GO课堂客户端和GO课堂服务端示例源码。下文介绍如何运行示例源码,推荐客户端与服务端配合使用,指引分为两部分:

  1. GO课堂客户端示例源码运行指引
  2. GO课堂服务端(Golang)示例源码运行指引
  • 该示例源码仅供开发者接入时参考,ZEGO 不负责示例源码的后续维护。
  • 若开发者计划将该示例源码用于生产环境,请确保发布前进行充分测试,避免发生潜在问题造成损失。

1 GO课堂客户端示例源码运行指引

1.1 准备环境

请确保开发环境满足以下技术要求(以下说明皆以 MacOS 开发电脑为例):

  • Android Studio 3.0 或以上版本。
  • 已经下载 Android SDK 28 和 Android SDK Platform-Tools 28。
  • Android 版本不低于 5.0 且支持音视频的 Android 设备或模拟器(推荐使用真机),如果是真机,请开启”允许调试”选项。
  • Android 设备已经连接到 Internet。

1.2 前提条件

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

1.3 运行示例源码

  1. 在开发电脑中找到 Android Studio 软件图标。

    image-20201203142600097

  2. 打开 Android Studio 软件,并单击 Open an existing project

    image-20201127105738483

  3. 选择在本文档开头位置已下载好的示例源码并打开,此处截图以 GO课堂 为例。

    WeChatefd1ad0b57ec0940e7ae8ccee1f7d58c

  4. 下载的示例源码中缺少相关 SDK 包,需通过以下链接下载,解压后将相关文件放入项目的 app/libs 目录下。

  1. 下载的示例源码中缺少 SDK 初始化所需的 APP_ID 和 APP_SIGN,需要修改 AuthConstants.java 文件。请使用本文“前提条件”已获取的 AppID 和 AppSign 正确填写(需要在 AppID 后加 L),否则示例源码无法正常运行。

    image-20201127111332837

    同时需要将本地部署的 GO课堂服务端的 host 地址配置在 BackendApiConstants.java 的对应字段中。

    WeChatdc13759cee0613e755dbc9d9490b9e23

    然后可在 ZegoSDKManager.java 中配置测试环境等开关。

    WeChat168abb615bad53103068c056e4a28fe4

  2. 选择一台已连接到 Internet 的 Android 真机设备(推荐)或模拟器,当该设备成功开启开发者模式和 USB 调试功能后,可以看到 Android Studio 由下图:

    image-20201203143252240

    变为下图:

    image-20201203143316386

    说明 Android Studio 软件已成功连接到 Android 设备,可以将示例源码运行到该设备上了。

  3. 单击 Android Studio 软件上的 build and run 按钮,编译并运行示例源码。若运行过程中出现问题,请联系即构技术支持工程师。

    image-20201203143341385

2 GO课堂服务端(Golang)示例源码运行指引

2.1 环境准备

  • 已安装 golang 1.11 或以上版本(推荐使用 1.13 或以上版本)。
  1. 执行 go env -w GO111MODULE=on 开启 golang module。
  2. 执行 go env -w GOPROXY=https://goproxy.cn 设置 golang 代理。
  • 已安装 redis 2.6 或以上版本。

2.2 前提条件

请到 即构管理控制台 注册账号并申请 AppID 与 ServerSecret,申请流程参考 项目管理

2.3 运行示例源码

  1. 下载 Go课堂源码。
git clone https://github.com/zegoim/go-class.git

示例源码中包含了GO课堂客户端源码和服务端源码。若开发者已经运行了GO课堂客户端源码,此处无需重复下载。

  1. 进入配置目录 src/go_class_server/go_class_room/conf/
cd src/go_class_server/go_class_room/conf/
  1. 修改 app.conf 文件中相关配置项。
RedisAddr = "192.168.100.62:6379" # redis host
RedisPassword = ""                            # redis password
RedisIndex = 8                            # redis数据库

[SmallClass] # 小班课appid相关配置 如果不需要小班课场景,可以不用关心相关配置
AppId = 123456789
AppSecret = "eb2280544902dc1b7ab1fde3985bd083" # 从 zego 控制台获取的 ServerSecret
...
MaxPeopleNum = 10  # 小班课教室间同时在线人数上限
MaxJoinLiveNum = 4 # 小班课教室间同时连麦人数上限

[LargeClass] # 大班课appid相关配置 如果不需要大班课场景,可以不用关心相关配置
AppId = 987654321
AppSecret = "13nce767a02dc1b7bd083ab1fde3985" # 从 zego 控制台获取的 ServerSecret
...
MaxPeopleNum = 50  # 大班课教室间同时在线人数上限
MaxJoinLiveNum = 1 # 大班课教室间同时连麦人数上限
  1. 进入 go_class_room 目录并启动服务。
cd ../go_class_room
go run main.go