# videochat

**Repository Path**: jiyilee/videochat

## Basic Information

- **Project Name**: videochat
- **Description**: 简易翻版，腾讯云即时通信 IM，实时音视频（Tencent RTC）。支持web，小程序，独立配置管理监控后台。。。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 多端在线聊天系统

这是一个支持 Web 与微信小程序互通的在线聊天系统：

- 后端：Java 17、Spring Boot、PostgreSQL、Redis
- Web：Vue 3、Vite、腾讯云 `trtc-sdk-v5`
- 小程序：Taro、Vue 3、腾讯云 `trtc-wx-sdk`
- 实时能力：WebSocket 负责消息和呼叫信令，TRTC 负责音视频媒体

系统包含登录注册、好友与群组验证、单聊、群聊、消息盒子、表情/图片/文件/音频/视频消息、聊天记录、离线消息、在线状态、上下线提醒、资料与密码修改，以及一对一和多人实时音视频通话。

## 使用文档

- [实时音视频 SDK 使用文档](docs/sdk-usage.md)
- [生产部署与并发容量指南](docs/deployment.md)
- [系统架构](docs/architecture.md)
- [REST API 摘要](docs/api.md)

## TRTC 配置

腾讯云密钥只保存在 Java 后端，Web 和小程序通过登录态请求临时 `UserSig`，不会在客户端保存 `SecretKey`。

1. 在腾讯云实时音视频控制台创建 TRTC 应用。
2. 复制 `.env.example` 为 `.env`。
3. 填写 `TRTC_SDK_APP_ID` 和 `TRTC_SECRET_KEY`。

```powershell
Copy-Item .env.example .env
docker compose --env-file .env -f deploy/docker-compose.yml up -d --build
```

启动后：

- Web：`http://localhost:8088`
- 后端：`http://localhost:18080`

系统没有预置默认账号，请在登录页点击“注册新账号”创建用户。测试互通至少需要注册两个账号。

## 本地开发

```powershell
cd server
mvn spring-boot:run

cd web
pnpm install
pnpm dev

cd miniapp
pnpm install
pnpm dev:weapp
```

## 音视频说明

- 单聊房间号固定为 `single-{较小用户ID}-{较大用户ID}`。
- 群聊房间号固定为 `group-{群ID}`。
- Web 与小程序使用相同的房间号和后端签名接口，可互相通话。
- Web 摄像头和麦克风在生产环境必须使用 HTTPS。
- 微信小程序必须在真机测试，并开通小程序实时音视频相关类目和 `live-pusher`、`live-player` 权限。
- 小程序后台需要配置合法的 HTTPS 请求域名和 WSS Socket 域名。
- 微信开发者工具不能完整模拟原生实时音视频能力。

## 构建验证

```powershell
cd server; mvn test
cd web; pnpm build
cd miniapp; pnpm build:weapp
```