本文基于企业直播开源demo示例,介绍Web观众端开发的前提条件、环境要求、Demo源码下载和初始化配置等。

前提条件

  • 已经通过控制台创建应用并获取客户端集成需要的信息(appIdappKey、低代码集成服务地址和低代码集成服务密钥)。关于如何创建应用,请参见创建应用
  • 如果您需要进行自定义UI开发,请先了解集成服务端SDKWeb端标准集成

接入说明

企业直播方案通过Web端接入,可有两种接入方式:低代码集成和标准集成。
  • 低代码集成:极少开发量,适用于期望快速上线,默认UI和功能满足诉求的场景。集成方式,请参见Web观众端集成
  • 标准集成:有一定开发量,对自定义UI和功能有强诉求的场景。标准集成不需要在集成配置中做Web端低代码集成相关配置,并且在选择低代码集成方式后也可以进行标准集成,两者共用同一个appId。我们提供了标准集成的UI源码,以供您快速接入,接入方式请参见下方文档。

环境要求

支持node 12.0以上版本的Mac和Windows系统。

步骤一:下载Demo源码

下载Web端企业直播开源代码

步骤二:初始化配置

  1. 修改src/constants/config.js,将您低代码音视频工厂控制台中的appIdappKey填入相应位置。
  2. 文件中的origin字段填写的是您自己的服务端地址,用于在src/biz/doLogin.ts中获取WebSDK建立长连接Token。
    说明 该操作属于直接向此域名进行请求,在浏览器中会跨域,需要服务端对接口配置跨源资源共享(CORS)。如果服务端不方便配置,您可以参考第三步进行操作。
  3. 如果需要本地开发服务代理跨域,您可以修改根目录.umirc.ts文件中的proxy配置项,填入您自己的服务端域名。具体操作,请参见Umi配置proxy
    说明 该方法仅适用于开发环境,线上部署时请使用其他方法解决跨域问题。

步骤三:开发操作

  1. 在命令行工具中进入项目根目录。
  2. 在命令行工具中执行yarn && yarn start命令。
  3. 在浏览器中打开http://localhost:8000即可查看页面。
  4. 将您创建的直播ID、用户ID和用户昵称按照Query的方式传入到页面中,例如:http://localhost:8000?liveId=****&userId=****&nick=****

项目介绍

Web端企业直播Demo分为移动端UI和PC端UI,通过对UI判断实现在手机浏览器和Web浏览器中使用相应端的UI。开发时,也可以通过Chrome浏览器开发者工具的Device Toolbar查看移动端UI。

两端UI的业务逻辑在页面src/pages/room/index.tsx中复用。

移动端UI

移动端UI引入了AntDesign Mobile,源码在src/components/mobile/index.tsx中。1

PC端UI

PC端UI引入了AntDesign,源码在src/components/pc/index.tsx中。1