127 lines
2.9 KiB
Markdown
127 lines
2.9 KiB
Markdown
|
# 直播系统 Java 后端
|
|||
|
|
|
|||
|
|
基于 Spring Boot 3.2 + JPA + H2/MySQL 的直播系统后端服务。
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
- Java 17
|
|||
|
|
- Spring Boot 3.2
|
|||
|
|
- Spring Data JPA
|
|||
|
|
- H2 Database (开发) / MySQL (生产)
|
|||
|
|
- Lombok
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 1. 使用 IDEA 打开项目
|
|||
|
|
|
|||
|
|
1. 打开 IntelliJ IDEA
|
|||
|
|
2. 选择 `File` -> `Open`
|
|||
|
|
3. 选择 `java-backend` 文件夹
|
|||
|
|
4. 等待 Maven 依赖下载完成
|
|||
|
|
|
|||
|
|
### 2. 运行项目
|
|||
|
|
|
|||
|
|
方式一：直接运行
|
|||
|
|
- 找到 `LivestreamingApplication.java`
|
|||
|
|
- 右键点击 -> `Run 'LivestreamingApplication'`
|
|||
|
|
|
|||
|
|
方式二：Maven 命令
|
|||
|
|
```bash
|
|||
|
|
cd java-backend
|
|||
|
|
mvn spring-boot:run
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 访问服务
|
|||
|
|
|
|||
|
|
- API 地址: http://localhost:3001/api
|
|||
|
|
- H2 控制台: http://localhost:3001/h2-console
|
|||
|
|
- JDBC URL: `jdbc:h2:file:./data/livestream`
|
|||
|
|
- 用户名: `sa`
|
|||
|
|
- 密码: (空)
|
|||
|
|
|
|||
|
|
## API 接口
|
|||
|
|
|
|||
|
|
### 直播间接口
|
|||
|
|
|
|||
|
|
| 方法 | 路径 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| GET | /api/rooms | 获取所有直播间 |
|
|||
|
|
| GET | /api/rooms/{id} | 获取单个直播间 |
|
|||
|
|
| POST | /api/rooms | 创建直播间 |
|
|||
|
|
| DELETE | /api/rooms/{id} | 删除直播间 |
|
|||
|
|
|
|||
|
|
### 创建直播间请求示例
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
POST /api/rooms
|
|||
|
|
{
|
|||
|
|
"title": "我的直播间",
|
|||
|
|
"streamerName": "主播名称"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 响应示例
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"data": {
|
|||
|
|
"id": "uuid",
|
|||
|
|
"title": "我的直播间",
|
|||
|
|
"streamerName": "主播名称",
|
|||
|
|
"streamKey": "uuid",
|
|||
|
|
"isLive": false,
|
|||
|
|
"viewerCount": 0,
|
|||
|
|
"streamUrls": {
|
|||
|
|
"rtmp": "rtmp://localhost:1935/live/uuid",
|
|||
|
|
"flv": "http://localhost:8080/live/uuid.flv",
|
|||
|
|
"hls": "http://localhost:8080/live/uuid/index.m3u8"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 切换到 MySQL
|
|||
|
|
|
|||
|
|
1. 安装 MySQL 并创建数据库：
|
|||
|
|
```sql
|
|||
|
|
CREATE DATABASE livestream CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. 修改 `application.yml`：
|
|||
|
|
```yaml
|
|||
|
|
spring:
|
|||
|
|
datasource:
|
|||
|
|
url: jdbc:mysql://localhost:3306/livestream?useSSL=false&serverTimezone=Asia/Shanghai
|
|||
|
|
driver-class-name: com.mysql.cj.jdbc.Driver
|
|||
|
|
username: root
|
|||
|
|
password: your_password
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
java-backend/
|
|||
|
|
├── src/main/java/com/example/livestreaming/
|
|||
|
|
│ ├── LivestreamingApplication.java # 启动类
|
|||
|
|
│ ├── config/ # 配置类
|
|||
|
|
│ ├── controller/ # 控制器
|
|||
|
|
│ ├── dto/ # 数据传输对象
|
|||
|
|
│ ├── entity/ # 实体类
|
|||
|
|
│ ├── exception/ # 异常处理
|
|||
|
|
│ ├── repository/ # 数据访问层
|
|||
|
|
│ └── service/ # 业务逻辑层
|
|||
|
|
├── src/main/resources/
|
|||
|
|
│ └── application.yml # 配置文件
|
|||
|
|
└── pom.xml # Maven 配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Android App 配置
|
|||
|
|
|
|||
|
|
确保 Android App 的 API 地址指向此服务：
|
|||
|
|
|
|||
|
|
```kotlin
|
|||
|
|
// build.gradle.kts
|
|||
|
|
buildConfigField("String", "API_BASE_URL_DEVICE", "\"http://你的电脑IP:3001/api/\"")
|
|||
|
|
```
|