ZegoExpressUniAppSDK

即构科技 (ZEGO) 极速音视频 uni-app SDK 是一个基于 ZegoExpressEngine 原生 Android / iOS SDK 的 uni-app Wrapper，提供视频直播以及实时音视频服务。仅需几行代码，30分钟即可轻松接入。

了解更多解决方案：https://www.zego.im

使用方法

注意事项

1、本插件是 uniapp 原生插件，使用前需学习 uniapp 原生插件使用方法，官方教程 uni原生插件使用教程

2、使用视频功能时，页面必须使用.nvue文件构建，因为uniapp的.vue页面在原生端（iOS、android）是用 webview 构建的，不能支持component类型的插件。详情可参考：https://nativesupport.dcloud.net.cn/NativePlugin/course/ios

申请 ZEGO AppID

创建uniapp项目

使用uniapp官方IDE HBuilder，创建uni-app类型的项目

获取「ZegoExpressEngine」uniapp SDK，并引入工程

在uniapp市场获取本插件，并将插件引入工程

下载「js封装层」代码，并引入工程

下载地址 zego-express-video-uniapp

将以上「js封装层」引入到uniapp项目中

基础使用

初始化引擎

import ZegoExpressEngine from 'zego-express-video-uniapp/lib/ZegoExpressEngine';

import {
    ZegoScenario
} from 'zego-express-video-uniapp/lib/impl/ZegoExpressDefines'

ZegoExpressEngine.createEngine(AppID, AppSign, false, ZegoScenario.General);

登入房间

ZegoExpressEngine.instance().loginRoom(t"room1", { userID: "user_id", userName: "user_name" });

开启音视频通话

在成功登入房间后，可调用 startPreview 开启音视频：

<template>
  <zego-local-view></zego-local-view>
</template>
 
······

// 需要在登入房间之后才能开启音视频通话
ZegoExpressEngine.instance().startPreview();

将本地视频画面推向云服务

// 推入的streamID由用户设置
let publishStreamID = '123456'
ZegoExpressEngine.instance().startPublishingStream(publishStreamID);

拉取其他用户音视频

登入房间后主动监听 roomStreamUpdate，在收到其他用户推出的音视频流，即可拉取：

<template>
  <zego-remote-view :streamID="playStreamID" ></zego-remote-view>
</template>

······
// 监听 roomStreamUpdate
ZegoExpressEngine.instance().on('roomStreamUpdate', (roomID, updateType, streamList) => {
    this.playStreamID = streamList[0].streamID;
});

······
// 拉取StreamID的音视频
ZegoExpressEngine.instance().startPlayingStream(this.playStreamID);

退出房间

// 退出房间
ZegoExpressEngine.instance().logoutRoom('room1');

销毁引擎

// 退出房间
ZegoExpressEngine.destroyEngine();

运行

本插件是 uniapp 原生插件，需要使用 uniapp 云打包制作自定义调试基座，才能保证正常跑通。具体可参考 uniapp 官方教程 uni原生插件使用教程

示例源码使用

示例源码下载地址

ZegoExpressExample-UniApp

将Demo导入HBuilderX，修改manifest.json下的AppID(uniapp的AppID)
修改Demo下./zego-express-video-uniapp/KeyCenter.js 内的AppID、AppSign (从ZEGO官网获取的)
导入「ZegoExpressEngine」uniapp SDK
使用uniapp本地打包/云打包，制定自定义基座
运行

zongningliu/zego-express-uni-app-sdk