# meeting-app

**Repository Path**: ghostroot/meeting-app

## Basic Information

- **Project Name**: meeting-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-01
- **Last Updated**: 2026-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 会议应用 - Meeting App

基于 Tauri + React + TypeScript 构建的实时视频会议桌面应用。

## 功能特点

- ✅ 实时视频通话（WebRTC P2P）
- ✅ 屏幕共享
- ✅ 多人会议支持
- ✅ 多设备选择（摄像头、麦克风、扬声器）
- ✅ 信令服务器配置
- ✅ 聊天功能

---

## 环境配置

### Ubuntu 26.04

#### 1. 安装系统依赖

```bash
# 更新并安装基础工具
sudo apt update
sudo apt install -y curl file build-essential libssl-dev pkg-config

# 安装 GTK 和 WebKit 依赖
sudo apt install -y \
    libwebkit2gtk-4.1-dev \
    libgtk-3-dev \
    libayatana-appindicator3-dev \
    librsvg2-dev \
    libxdo-dev
```

#### 2. 安装 Rust

```bash
# 使用 rustup 安装（推荐）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

# 配置 WebKit 环境变量（解决渲染问题）
echo "export WEBKIT_DISABLE_COMPOSITING_MODE=1" >> ~/.bashrc
source ~/.bashrc
```

#### 3. 验证

```bash
rustc --version   # 应输出 rustc 1.94+ 或更高
cargo --version
```

### Windows

1. 安装 [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/)
2. 安装 [Rust](https://rustup.rs/)

---

## 快速开始

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run tauri dev
```

### 构建生产版本

```bash
npm run tauri build
```

构建产物位于 `src-tauri/target/release/`

---

## 项目结构

```
meeting-app/
├── src/                       # React 前端代码
│   ├── components/             # React 组件
│   ├── hooks/                 # 自定义 Hooks
│   ├── store/                 # Zustand 状态管理
│   ├── config.ts              # 配置文件
│   └── App.tsx                # 应用入口
├── src-tauri/                 # Tauri 后端目录（Rust）
│   ├── Cargo.toml             # Rust 依赖
│   ├── tauri.conf.json       # Tauri 配置
│   ├── src/                  # Rust 源代码
│   └── icons/                 # 应用图标
├── tests/                      # 测试脚本
└── package.json                # 前端依赖
```

**注意**：`Cargo.toml` 位于 `src-tauri/` 目录内，这是 Tauri 2.0 的标准结构。

---

## 创建项目方式

| 命令 | 项目类型 | 说明 |
|------|---------|------|
| `cargo new my-app` | 纯 Rust | 仅创建 Rust 后端，Cargo.toml 在根目录 |
| `npm create tauri-app` | 桌面应用 | 创建完整项目，前端 + Rust 后端 |

### 创建纯 Rust 项目（不推荐）

```bash
cargo new my-tauri-app
cd my-tauri-app
# Cargo.toml 在根目录
```

### 创建 Tauri 桌面应用（推荐）

```bash
npm create tauri-app@latest my-app
cd my-app
npm install
npm run tauri dev
```

---

## 技术栈

| 类别 | 技术 |
|------|------|
| 前端框架 | React 19 |
| 构建工具 | Vite 7 |
| 桌面应用 | Tauri 2 |
| 状态管理 | Zustand |
| 样式 | Tailwind CSS 4 |
| 实时通信 | WebRTC |

---

## 配置

### 信令服务器

默认配置：`ws://152.136.27.117:8000/ws`

在应用中点击设置图标修改，或编辑 `src/config.ts`：

```typescript
export const Config = {
  signaling: {
    url: "ws://你的服务器地址:端口/ws",
  },
  webrtc: {
    iceServers: [
      { urls: "stun:stun.l.google.com:19302" },
    ],
  },
};
```

---

## 常见问题

| 问题 | 解决方案 |
|-----|---------|
| `libwebkit2gtk-4.0-dev not found` | Ubuntu 26.04 使用 `libwebkit2gtk-4.1-dev` |
| 应用白屏/渲染异常 | 设置 `WEBKIT_DISABLE_COMPOSITING_MODE=1` |
| 分发到旧版 Linux | 建议在旧版 Ubuntu（如 20.04）的 Docker 中构建 |

---

## 许可证

MIT