快速集成

环境要求

浏览器	版本
Chrome 谷歌浏览器	103+
Safari 浏览器	15.3.1+
Firefox 浏览器	101.2.0+
微信内置浏览器	8.0.23+
qq 浏览器	12.0.5+

集成、测试使用需要在上述主流浏览器及相应版本上进行，推荐使用 Chrome 浏览器的最新版本。

Tips：

1）UC 默认禁止所有跨域请求，若有 web sdk 集成需求，遇到跨域禁止问题，建议优先考虑部署代理服务器或将业务系统和 UC 部署在同一个域内解决此类问题。

若确实需要从 UC 侧配置放通跨域，由于 UC 目前仅支持全放通或全禁止，因此放通后存在安全性问题，如您知悉且接收此安全风险，请按照下述配置方法执行放通 UC 跨域限制：

1.打开配置文件 vi /opt/apollo/data/globals.conf

2.新增或修改以下 2 行配置语句，注意区分 UC 版本，

V46 版本（46.x.0.x）使用如下语句： cloud_nginx_security_enabled=true cloud_nginx_cors_enabled=false

V45 版本（45.x.0.x）使用如下语句：

cloud_nginx_security_enabled=false

语句插入位置参考下图：

3.进入指定目录 cd /home/apollo_deploy 4.重启 cloud-nginx 服务 ./scripts/install.sh deploy -m cloud-nginx

2）集成 UC web sdk 落地商用前提：请务必给 UC 服务器配置 SSL 证书（https 证书），用于解决浏览器跳转 uc 页面时报的证书无效问题。

若是处于调试阶段，可先手动访问 uc 的 https 地址信任下即可，正式商用请配置好 ssl 证书，避免用户使用时出现证书无效报错。

运行 DEMO

Demo 已内置在 SDK 包中，请按照 Readme 上的步骤进行测试。

SDK 集成

@ylink-sdk/mobile-web 可以从 npm 下载安装，引入集成到你的项目中。在开始之前，请求确认您已完成准备工作，并跑通 DEMO。

注意： @ylink-sdk/mobile-web 依赖 vue3.0，使用时需安装 vue3.0

安装库

# 通过 Pnpm 安装
$ pnpm add @ylink-sdk/mobile-web --save

# 通过 Yarn 安装
$ yarn add @ylink-sdk/mobile-web --save

# 通过 Npm 安装
$ npm install @ylink-sdk/mobile-web --save

前端工程项目，推荐使用 pnpm 作为包管理器

引入库

import { YlinkMeeting } from '@ylink-sdk/mobile-web';

集成流程

1. @ylink-sdk/mobile-web 依赖 vue3.0，使用前请确认是否已引入 vue3.0
2. 检查浏览器是否支持

YlinkMeeting.checkSupport();

1. 初始化 YlinkMeeting，具体参数说明可查看 SDK 接口说明 1.1 初始化 init

await YlinkMeeting.init({
	clientId: CLIENT_ID,
	accessToken: accessToken,
	meetingNum: '',
	pwd: '',
	displayName: '',
	baseURL: 'https://meetings.ylyun.com',
	mediaType: 'webrtc',
	isPrivateCloud: true,
});

1. 加入会议

await YlinkMeeting.join();

1. 离开会议

await YlinkMeeting.leave();