# 具身智能机器狗-前端

**Repository Path**: xhharry/Embodied-Intelligence-Robotic-Dog-Frontend

## Basic Information

- **Project Name**: 具身智能机器狗-前端
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-10
- **Last Updated**: 2025-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 具身智能开放平台

一个集成化的具身智能开放平台，通过多视角实时监控、BIM模型融合、智能语音交互等技术，为AI研究人员和测绘工程师提供高效、直观的机器狗控制和数据采集解决方案。

## 功能特性

### 🤖 机器狗智能控制
- **多种控制方式**: 支持语音、文字、操纵杆控制
- **实时状态监控**: 位置、姿态、电量、移动状态
- **智能路径规划**: 自动导航到指定位置
- **紧急安全控制**: 一键紧急停止功能

### 📹 多视角实时监控
- **机器狗第一人称视角**: 1080P/30FPS高清实时画面
- **360°全景监控**: 4K分辨率，支持PTZ控制
- **画面录制截图**: 实时录制和截图功能
- **视角预设管理**: 快速切换预设视角

### 🏗️ BIM模型集成
- **三维模型显示**: 6楼BIM模型实时渲染
- **机器狗位置标注**: 实时显示位置和运动轨迹
- **数据采集可视化**: 采集结果在模型中展示
- **多楼层切换**: 支持3F-7F楼层切换

### 🧠 智能语音交互
- **语音识别**: 支持中文语音指令
- **自然语言处理**: 智能理解复杂指令
- **任务执行反馈**: 实时显示执行状态
- **对话历史记录**: 完整的交互历史

### 📊 数据采集分析
- **图像数据采集**: 多角度环境图像采集
- **AI图像分析**: 自动识别和分析图像内容
- **数据融合展示**: 采集数据与BIM模型融合
- **历史数据管理**: 完整的数据采集记录

## 技术架构

### 前端技术栈
- **框架**: Vue.js 3.x + Composition API
- **UI组件**: Element Plus
- **状态管理**: Pinia
- **构建工具**: Vite
- **样式**: CSS3 + 响应式设计

### 后端接口设计
- **机器狗控制**: RESTful API + WebSocket实时通信
- **摄像头管理**: 视频流处理和PTZ控制
- **AI服务**: 语音识别、图像分析、自然语言处理
- **BIM集成**: 三维模型数据和空间定位
- **数据存储**: 采集数据和历史记录管理

## 快速开始

### 环境要求
- Node.js >= 16.0.0
- npm >= 8.0.0

### 安装依赖
```bash
npm install
```

### 开发模式
```bash
npm run dev
```

### 构建生产版本
```bash
npm run build
```

### 预览生产版本
```bash
npm run preview
```

## 项目结构

```
src/
├── components/          # Vue组件
│   ├── HeaderBar.vue   # 顶部导航栏
│   ├── BIMModelViewer.vue  # BIM模型显示
│   ├── DogCameraView.vue   # 机器狗视角
│   ├── PanoramicView.vue   # 全景视图
│   ├── ControlCenter.vue   # 控制中心
│   ├── FloorSelector.vue   # 楼层选择器
│   └── ToolBar.vue     # 工具栏
├── views/              # 页面视图
│   └── MainDashboard.vue   # 主仪表板
├── stores/             # 状态管理
│   └── robotStore.js   # 机器狗状态管理
├── api/                # API接口
│   └── robotApi.js     # 机器狗API
├── utils/              # 工具函数
│   └── websocket.js    # WebSocket管理
├── router/             # 路由配置
│   └── index.js
├── style.css           # 全局样式
└── main.js            # 应用入口
```

## 核心功能模块

### 1. 机器狗控制中心
- 虚拟操纵杆控制移动方向和速度
- 基础动作控制（站立、坐下、趴下）
- 速度调节和紧急停止
- 实时状态显示

### 2. 智能指令系统
- 文本指令输入和处理
- 语音指令识别和执行
- 快捷指令按钮
- 指令历史和执行状态

### 3. 视频监控系统
- 双摄像头实时画面显示
- PTZ控制和预设位管理
- 录制、截图功能
- 画质调节和全屏显示

### 4. BIM模型集成
- 三维模型加载和渲染
- 机器狗实时位置标注
- 运动轨迹可视化
- 数据采集点标记

## API接口说明

### 机器狗控制API
```javascript
// 移动控制
POST /api/robot/move
{
  "direction": "forward|backward|left|right",
  "speed": 50
}

// 设置姿态
POST /api/robot/posture
{
  "posture": "stand|sit|lie"
}

// 移动到指定位置
POST /api/robot/move-to
{
  "x": 100,
  "y": 200,
  "z": 0
}
```

### 摄像头控制API
```javascript
// PTZ控制
POST /api/cameras/{cameraId}/ptz
{
  "action": "pan|tilt|zoom",
  "value": 10
}

// 截图
POST /api/cameras/{cameraId}/screenshot
```

### AI指令API
```javascript
// 文本指令
POST /api/ai/command/text
{
  "command": "前往会议室A并拍照"
}

// 语音指令
POST /api/ai/command/voice
FormData: audio file
```

## WebSocket事件

### 接收事件
- `robot_status`: 机器狗状态更新
- `robot_position`: 位置信息更新
- `task_update`: 任务执行状态
- `camera_frame`: 摄像头帧数据
- `system_alert`: 系统警告

### 发送事件
- `robot_command`: 机器狗控制指令
- `camera_command`: 摄像头控制指令
- `ai_command`: AI指令
- `heartbeat`: 心跳包

## 部署说明

### 开发环境
1. 克隆项目到本地
2. 安装依赖: `npm install`
3. 启动开发服务器: `npm run dev`
4. 访问 http://localhost:3000

### 生产环境
1. 构建项目: `npm run build`
2. 部署dist目录到Web服务器
3. 配置后端API地址
4. 配置WebSocket连接地址

## 浏览器支持

- Chrome >= 88
- Firefox >= 85
- Safari >= 14
- Edge >= 88

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

## 许可证

MIT License

## 联系方式

如有问题或建议，请联系开发团队。