XW-AIOT/wvp-platform
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
wvp-platform/启动指南-Java17.md

5.9 KiB
Raw Permalink Blame History

WVP-PRO 启动指南（使用 Java 17）

当前环境

  • ✅ Java 17 已安装
  • ✅ Node.js 已安装
  • ✅ Docker 已安装
  • ✅ 基础服务已启动（Redis、MySQL、ZLMediaKit）
  • ✅ pom.xml 已修改为 Java 17

方案一：使用 PowerShell 编译（推荐）

1. 打开 PowerShell（管理员权限）

cd C:\workspace\wvp-platform

2. 使用 Docker 编译项目

docker run --rm -v "${PWD}:/app" -w /app eclipse-temurin:17-jdk cmd /c "apt-get update && apt-get install -y maven && mvn clean package -Dmaven.test.skip=true"

3. 检查编译结果

ls target\wvp-pro*.jar

4. 配置连接参数

编辑 src\main\resources\application-dev.yml，确保以下配置正确：

spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8&rewriteBatchedStatements=true&serverTimezone=PRC&useSSL=false&allowMultiQueries=true&allowPublicKeyRetrieval=true
    username: wvp_user
    password: wvp_password

media:
  ip: 127.0.0.1
  http-port: 8080

5. 启动应用

java -jar target\wvp-pro-2.7.4-*.jar --spring.profiles.active=dev

方案二：安装 Maven 后编译

1. 下载 Maven

访问：https://maven.apache.org/download.cgi 下载：apache-maven-3.9.6-bin.zip

2. 解压并配置环境变量

# 解压到 C:\Program Files\apache-maven-3.9.6

# 添加到系统PATH
setx /M PATH "%PATH%;C:\Program Files\apache-maven-3.9.6\bin"

# 重启终端验证
mvn -version

3. 编译项目

cd C:\workspace\wvp-platform

# 编译前端
cd web
npm install --registry=https://registry.npmmirror.com
npm run build:prod
cd ..

# 编译后端
mvn clean package -Dmaven.test.skip=true

4. 启动应用

java -jar target\wvp-pro-2.7.4-*.jar --spring.profiles.active=dev

方案三：使用已编译的版本（最快）

如果您之前编译过项目，可以直接运行：

# 找到已编译的 jar 文件
ls target\*.jar

# 直接运行
java -jar target\wvp-pro-2.7.4-<timestamp>.jar --spring.profiles.active=dev

验证服务

1. 检查基础服务状态

docker ps --filter "name=polaris-"

应该看到：

  • docker-polaris-redis-1 (健康运行)
  • docker-polaris-mysql-1 (健康运行)
  • docker-polaris-media-1 (运行中)

2. 测试数据库连接

docker exec -it docker-polaris-mysql-1 mysql -u wvp_user -pwvp_password -e "show databases;"

应该看到 wvp 数据库。

3. 访问应用

启动后访问：

常见问题

1. 端口冲突

如果 18080 端口被占用：

# 修改 src/main/resources/application-dev.yml
server:
  port: 28080  # 改为其他端口

2. 数据库连接失败

检查 MySQL 是否健康：

docker logs docker-polaris-mysql-1

3. Redis 连接失败

检查 Redis 状态：

docker exec -it docker-polaris-redis-1 redis-cli ping

应该返回 PONG

4. ZLMediaKit 连接失败

检查 ZLMediaKit 日志：

docker logs docker-polaris-media-1

功能模块位置

主码流/子码流切换

  • 控制器: src/main/java/com/genersoft/iot/vmp/gb28181/controller/DeviceQuery.java
  • 服务: src/main/java/com/genersoft/iot/vmp/gb28181/service/impl/PlayServiceImpl.java
  • API: /api/play/{deviceId}/{channelId}/start (带 streamType 参数)

云台控制（转向、拉近、拉远）

  • 控制器: src/main/java/com/genersoft/iot/vmp/gb28181/controller/PtzController.java
  • 服务: src/main/java/com/genersoft/iot/vmp/gb28181/service/impl/PTZServiceImpl.java
  • 命令: src/main/java/com/genersoft/iot/vmp/gb28181/transmit/cmd/impl/SIPCommander.java
  • API:
    • /api/front-end/{deviceId}/{channelId}/ptz - PTZ控制
    • /api/front-end/{deviceId}/{channelId}/left - 左转
    • /api/front-end/{deviceId}/{channelId}/right - 右转
    • /api/front-end/{deviceId}/{channelId}/up - 上转
    • /api/front-end/{deviceId}/{channelId}/down - 下转
    • /api/front-end/{deviceId}/{channelId}/zoom_in - 拉近
    • /api/front-end/{deviceId}/{channelId}/zoom_out - 拉远

设备接入管理

  • 设备服务: src/main/java/com/genersoft/iot/vmp/gb28181/service/impl/DeviceServiceImpl.java
  • 注册处理: src/main/java/com/genersoft/iot/vmp/gb28181/transmit/event/request/impl/RegisterRequestProcessor.java
  • 心跳处理: src/main/java/com/genersoft/iot/vmp/gb28181/transmit/event/request/impl/MessageRequestProcessor.java
  • SIP层: src/main/java/com/genersoft/iot/vmp/gb28181/SipLayer.java

停止服务

停止 WVP 应用

在运行窗口按 Ctrl + C

停止 Docker 服务

cd docker
docker compose down

只停止 WVP，保留基础服务

cd docker
docker compose stop polaris-wvp polaris-nginx

日志查看

WVP 应用日志

应用启动后，日志会输出到控制台和 logs/ 目录

Docker 服务日志

# 查看所有服务日志
cd docker
docker compose logs -f

# 查看特定服务日志
docker compose logs -f polaris-mysql
docker compose logs -f polaris-redis
docker compose logs -f polaris-media

下一步

1. 测试设备接入

配置国标设备连接到 WVP：

  • SIP 服务器: 你的IP地址
  • SIP 端口: 8160
  • SIP 域: 3502000000
  • 设备ID: 20位国标编码
  • 密码: wvp_sip_password

2. 查看设备列表

访问 http://localhost:18080 后，在"国标设备"菜单查看已接入设备

3. 测试云台控制

在设备通道列表中，点击"云台控制"按钮测试

4. 测试视频播放

在通道列表中点击"播放"按钮，查看视频流

最后更新: 2026-02-02