本文将指导您如何快速地将桌面端 TUILiveKit 组件集成到您的项目中,从而为您的应用程序提供直播推流功能。
环境准备
Windows 电脑:操作系统 Windows 10 或者 11 版本。
Node.js: 版本:Node.js ≥ 16.19.1(推荐使用官方 LTS 版本,npm 版本请与 node 版本匹配)。
步骤一:开通服务
步骤二:下载 TUILiveKit 源码
从 Github 下载 项目源码,或者执行以下命令下载: git clone https://github.com/Tencent-RTC/ultra-live-electron.git
步骤三:集成 TUILiveKit
当 TUILiveKit 在桌面端运行时,需要创建两个 Electron 窗口,分别用于承载 TUILiveKit 的主界面和设置界面。我们将这两个窗口分别称为 TUILiveKit 主窗口和子窗口。集成后的最终效果是:在您现有的 Electron 应用中,通过点击一个按钮,即可创建并打开 TUILiveKit 主窗口,开始使用 TUILiveKit 的全部功能。
前置依赖
您的代码工程需要包含以下技术栈:
Vue3
Webpack
TypeScript
Electron
注意:
如果您没有符合接入条件的工程,可以参阅文档下面 常见问题,获得指引。 复制 TUILiveKit 代码到您的工程
1. 复制 TUILiveKit 组件
复制ultra-live-electron/src/TUILiveKit
目录到您工程的src
目录下。
2. 复制 TUILiveKit 窗口创建代码
复制ultra-live-electron/TUILiveKit.main.js
和ultra-live-electron/TUILiveKit.preload.js
文件到您工程的根目录下。
3. 复制 TUILiveKit 主窗口和子窗口页面及其页面路由定义
复制ultra-live-electron/src/views/TUILiveKitChild.vue
和ultra-live-electron/src/views/TUILiveKitMain.vue
文件到您工程的src/views
目录下。
在您工程的页面路由文件 src/router/index.ts
中,新增如下两条路由配置:
import { createRouter, createWebHashHistory, RouteRecordRaw } from 'vue-router';
import HomeView from '../views/HomeView.vue';
const routes: Array<RouteRecordRaw> = [
{
path: '/',
name: 'home',
component: HomeView
},
{
path: '/tui-live-kit-main',
name: 'tui-live-kit-main',
component: () => import( '../views/TUILiveKitMain.vue')
},
{
path: '/tui-live-kit-child',
name: 'tui-live-kit-child',
component: () => import( '../views/TUILiveKitChild.vue'),
},
];
window.ipcRenderer.on('window-type', (event: any, type: string) => {
console.log(`[router] window type:${type}`);
console.log(`[router] current href:${window.location.href}`);
router.replace({ name: `tui-live-kit-${type}`});
});
const router = createRouter({
history: createWebHashHistory(),
routes
});
export default router;
4. 复制美颜相关代码、资源和配置。
复制ultra-live-electron/public/assets
目录和文件public/avatar.png
到您工程的public
目录下。
复制ultra-live-electron/scripts/prestart.js
文件到您工程的scripts
目录下,并在您工程的package.json
文件中的scripts
部分新增如下命令。
{
"scripts": {
"prestart": "node ./scripts/prestart.js"
}
}
这里我们先不开启美颜功能,以上配置、代码、资源复制,可以保证工程运行不出错。美颜功能的开启参见 如何开启美颜功能。 5. 修改 vue.config.js 配置
在您工程的vue.config.js
文件中,新增如下配置:
const { defineConfig } = require('@vue/cli-service')
const os = require("os");
const isProduction = process.env.NODE_ENV === "production";
const platform = os.platform();
module.exports = defineConfig({
transpileDependencies: true,
publicPath: "./",
configureWebpack: {
devtool: isProduction ? "source-map" : "inline-source-map",
target: "electron-renderer",
module: {
rules: [
{
test: /\\.node$/,
loader: "native-ext-loader",
options: {
rewritePath: isProduction
? platform === "win32"
? "./resources"
: "../Resources"
: "./node_modules/trtc-electron-sdk/build/Release",
},
},
],
},
}
});
6. 复制src/debug
目录,配置SDKAppID
和SDKSecretKey
。
复制ultra-live-electron/src/debug
文件夹到您工程的src
目录下,打开复制过来的basic-info-config.js
文件,填入 步骤一:开通服务 时获取的SDKAppID
和SDKSecretKey
。
export const SDKAppID = 0;
export const SDKSecretKey = '';
7. 启用 pinia 状态管理并引入主题样式
打开您工程的src/main.ts
文件,增加 pinia 状态管理支持:
import { createApp } from 'vue';
import { createPinia } from 'pinia';
import "./TUILiveKit/assets/theme.css";
import App from './App.vue'
import router from './router'
createApp(App)
.use(createPinia())
.use(router)
.mount('#app');
8. 修改 global.d.ts
在您工程的src/global.d.ts
文件中,针对 Window 类型增加以下属性声明:
export {}
declare global {
interface Window {
ipcRenderer: any;
nativeWindowHandle: Uint8Array;
mainWindowPort: MessagePort | null;
}
}
增加入口,打开 TUILiveKit 主窗口
在您项目的某个页面中,新增一个按钮,点击后,通知 Electron 主进程打开 TUILiveKit 主窗口。如下所示,是我们实现的示例代码。
<template>
<div class="home">
<button @click="openTUILiveKit">开始直播</button>
</div>
</template>
<script setup lang="ts">
import { ref } from 'vue';
import type { Ref } from 'vue';
import { getBasicInfo } from '../debug/basic-info-config';
const isOpen:Ref<boolean> = ref(false);
const openTUILiveKit = async () => {
if (!isOpen.value) {
const currentUserInfo = await getBasicInfo();
if (currentUserInfo) {
window.ipcRenderer.send('openTUILiveKit', {
userInfo: currentUserInfo
});
isOpen.value = true;
} else {
console.error('Error: cannot get current user info');
}
}
};
</script>
在您 Electron 工程的 preload 脚本中,将 Electron 的ipcRenderer
对象放到全局对象window
上,方便在 vue 组件和 JavaScript/TypeScript 脚本中,与 Electron 主进程通信。
const { ipcRenderer } = require("electron");
window.ipcRenderer = ipcRenderer;
在您 Electron 工程的主进程脚本中,接收来自 vue 组件发送的openTUILiveKit
请求,打开 TUILiveKit 主窗口。
const { app, BrowserWindow, ipcMain } = require('electron');
const path = require('path');
const { TUILiveKitMain } = require("./TUILiveKit.main");
let mainWindow = null;
const createWindow = () => {
mainWindow = new BrowserWindow({
width: 800,
height: 600,
webPreferences: {
preload: path.join(__dirname, 'preload.js'),
nodeIntegration: true,
contextIsolation: false,
}
});
bindIPCMainEvent();
if (app.isPackaged) {
mainWindow.loadFile("dist/index.html");
} else {
mainWindow.loadURL('http://localhost:8080');
}
}
function bindIPCMainEvent() {
ipcMain.on("openTUILiveKit", (event, args) => {
console.log(`[main] open live kit`, args);
TUILiveKitMain.open(args);
});
}
app.whenReady().then(() => {
createWindow();
app.on('activate', () => {
if (BrowserWindow.getAllWindows().length === 0) createWindow()
});
})
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit()
});
在您工程的 package.json 文件中,新增如下配置,支持以开发模式启动 Electron 应用程序。
{
"main": "main.js",
"scripts": {
"start": "electron ."
},
"overrides": {
"@tencentcloud/tuiroom-engine-electron": {
"trtc-electron-sdk": "^12.2.701"
}
}
}
安装依赖
npm install --save pinia
npm install --save trtc-electron-sdk movable-resizable-js
npm install --save @tencentcloud/tuiroom-engine-electron
npm install --save trtc-electron-plugin-xmagic
npm install --save-dev native-ext-loader electron-devtools-installer electron-builder
步骤四:开发模式启动
1. 进入您的项目目录,打开命令行终端cmd.exe
,执行以下命令,以开发模式启动 Web 项目。
如果您在启动时遇到了 error Component name "Index" should always be multi-word vue/multi-word-component-names 报错,表示您的项目工程 eslint 配置与 TUILiveKit 有差异,打开您项目的 .eslintrc.js 文件或者在 package.json 文件的 eslintConfig 部分,增加如下所示代码中的 vue/multi-word-component-names 校验规则,再重新执行 “npm run serve” 命令。
module.exports = {
root: true,
env: {
node: true
},
'extends': [
'plugin:vue/vue3-essential',
'eslint:recommended',
'@vue/typescript/recommended'
],
parserOptions: {
ecmaVersion: 2020
},
rules: {
'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
"vue/multi-word-component-names": process.env.NODE_ENV === 'production' ? 'warn' : 'off',
}
}
2. 进入您的项目目录,再打开一个新的命令行终端cmd.exe
,执行以下命令,以开发模式启动 Electron 应用程序。
启动成功后,点击您在应用界面添加的 “开始直播” 按钮,就可以打开 TUILiveKit 主窗口,打开后效果如下图:
步骤五:开启一场直播
1. 添加摄像头
在开播前,需要先添加画面源,目前支持:摄像头、屏幕分享、窗口分享和图片,如下图是添加一个摄像头后的效果。
2. 添加 Logo 图片
如果您在直播时,需要添加自己的品牌 Logo,可以添加 Logo 图片。如下图,是添加一个背景透明的 Logo 图片后的效果,新添加的图片周围会有黄色边框,表示当前处于选中状态。处于选中状态的多媒体源,可以使用鼠标移动位置、调整大小,使用右键菜单对多媒体源进行旋转、修改显示层级等。
3. 开始直播
单击开始直播,将开启直播推流,成功开播后,开始直播按钮会变成结束直播,单击可结束直播推流。
4. 观看直播
桌面端 TUILiveKit 只支持直播推流,如果您想观看,请接入我们 TUILiveKit 手机端,通过手机端观看:安卓、iOS。 步骤六:构建安装包
1. 复制 `ultra-live-electron/electron-builder.json5` 文件到您项目的根目录下,文件中的 `productName` 和 `appId` 请改成您应用的相应信息。
2. 在您工程的 package.json 文件中新增以下命令,支持构建应用程序安装包。
{
"scripts": {
"build:win64": "electron-builder --win --x64",
"pack:win64": "npm run build && npm run build:win64"
}
}
3. 构建应用程序安装包。
进入您的项目目录,打开命令行终端 `cmd.exe`,执行以下命令即可启动构建,构建好的安装包在您工程的release
目录下。
4. 安装构建的应用程序安装包,并运行。
常见问题
没有符合接入条件的项目工程,如何解决?
根据您的具体情况,建议采用不同的途径:
如果您还没有项目工程,建议您直接使用我们开源的 Github 项目为基础,克隆一份作为您的项目工程。 如果您的项目是 JavaScript 工程,不支持 TypeScript ,可以参照常见问题 “3. 如何在 JavaScript 工程中集成?”。
是否支持 Vite 构建、接入?
暂不支持,如果您有诉求,可以通过下方 交流与反馈 章节提供的渠道,寻求帮助。 如何在 JavaScript 工程中集成?
JavaScript 工程无法直接集成 TUILiveKit,需要改造您的工程,使其支持 TypeScript。步骤如下:
1. 安装依赖
npm install --save-dev typescript@4.5.5 @typescript-eslint/eslint-plugin@5.4.0 @typescript-eslint/parser@5.4.0 @vue/cli-plugin-typescript@5.0.0 @vue/eslint-config-typescript@9.1.0
2. 复制ultra-live-electron/tsconfig.json
文件到您工程的根目录下。
3. 复制ultra-live-electron/src/global.d.ts
文件到您工程的根目录下。
如何开启美颜功能?
TUILiveKit 使用的美颜功能基于 腾讯特效 SDK 实现,如需使用,需要 购买相应服务,获取licenseURL
和 licenseKey
, 填入src/TUILiveKit/utils/beauty.ts
文件即可。 注意:
生产项目需要通过调用后台服务获取licenseURL
和licenseKey
,此处写入 JavaScript 文件可以快速启用,但是licenseURL
和licenseKey
泄露风险极高,仅适合快速接入、体验。
export const XmagicLicense = {
licenseURL: "",
licenseKey: "",
};
交流与反馈
如果有任何需要或者反馈,您可以联系:info_rtc@tencent.com。
本页内容是否解决了您的问题?