9.3 KiB
9.3 KiB
DisplayFlow 项目结构说明
目录结构
DisplayFlow/
├── CMakeLists.txt # 根 CMake 配置文件
├── .gitignore # Git 忽略文件配置
├── README.md # 项目概述和技术方案
├── DEVELOPMENT_PLAN.md # 详细开发计划
├── README_BUILD.md # 构建指南
├── PROJECT_STRUCTURE.md # 本文件：项目结构说明
│
├── core/ # 跨平台核心库
│ ├── CMakeLists.txt
│ ├── include/
│ │ └── displayflow/
│ │ └── core/
│ │ ├── common/ # 通用类型和常量
│ │ │ ├── types.h
│ │ │ └── constants.h
│ │ ├── network/ # 网络抽象层
│ │ │ ├── network_manager.h
│ │ │ ├── network_interface.h
│ │ │ ├── nat_traversal/ # NAT 穿透模块
│ │ │ │ ├── stun_client.h
│ │ │ │ ├── turn_client.h
│ │ │ │ ├── ice_agent.h
│ │ │ │ ├── candidate.h
│ │ │ │ └── nat_type.h
│ │ ├── protocol/ # 协议层
│ │ │ ├── protocol_handler.h
│ │ │ └── message_serializer.h
│ │ ├── session/ # 会话管理
│ │ │ ├── session_manager.h
│ │ │ └── session.h
│ │ ├── codec/ # 编解码抽象
│ │ │ ├── codec_manager.h
│ │ │ └── codec_interface.h
│ │ ├── role/ # 角色管理
│ │ │ ├── role_manager.h
│ │ │ ├── role_interface.h
│ │ │ ├── host_role.h
│ │ │ ├── client_role.h
│ │ │ └── peer_role.h
│ │ ├── file_transfer/ # 文件传输模块
│ │ │ ├── file_transfer_manager.h
│ │ │ ├── file_transfer_session.h
│ │ │ ├── file_chunk.h
│ │ │ └── transfer_progress.h
│ │ └── utils/ # 工具类
│ │ ├── logger.h
│ │ └── timer.h
│ └── src/ # 对应的源文件实现
│ ├── network/
│ │ └── nat_traversal/
│ ├── protocol/
│ ├── session/
│ ├── codec/
│ ├── role/
│ ├── file_transfer/
│ └── utils/
│
├── platforms/ # 平台适配层
│ ├── android/ # Android 平台实现
│ │ ├── CMakeLists.txt
│ │ ├── include/
│ │ │ └── displayflow/
│ │ │ └── platform/
│ │ │ └── android/
│ │ │ ├── platform_adapter.h
│ │ │ ├── capture/ # 捕获模块
│ │ │ │ ├── screen_capture.h
│ │ │ │ ├── media_projection_wrapper.h
│ │ │ │ └── camera_capture.h # 摄像头捕获
│ │ │ ├── render/ # 渲染引擎
│ │ │ │ └── render_engine.h
│ │ │ ├── input/ # 输入处理
│ │ │ │ └── touch_handler.h
│ │ │ └── network/ # 网络管理
│ │ │ └── android_network_manager.h
│ │ └── src/ # 对应的源文件实现
│ │ ├── capture/
│ │ │ ├── screen_capture.cpp
│ │ │ ├── media_projection_wrapper.cpp
│ │ │ └── camera_capture.cpp
│ │ ├── render/
│ │ ├── input/
│ │ ├── network/
│ │ └── platform_adapter.cpp
│ │
│ └── windows/ # Windows 平台实现
│ ├── CMakeLists.txt
│ ├── include/
│ │ └── displayflow/
│ │ └── platform/
│ │ └── windows/
│ │ ├── platform_adapter.h
│ │ ├── virtual_display/ # 虚拟显示器
│ │ │ ├── virtual_display.h
│ │ │ └── iddcx_wrapper.h
│ │ ├── capture/ # 捕获模块
│ │ │ └── camera_capture.h # 摄像头捕获
│ │ ├── render/ # 渲染引擎
│ │ │ ├── directx_renderer.h
│ │ │ └── d3d11_renderer.h
│ │ ├── input/ # 输入处理
│ │ │ ├── keyboard_handler.h
│ │ │ └── mouse_handler.h
│ │ └── network/ # 网络管理
│ │ └── windows_network_manager.h
│ └── src/ # 对应的源文件实现
│ ├── virtual_display/
│ ├── capture/
│ │ └── camera_capture.cpp
│ ├── render/
│ ├── input/
│ ├── network/
│ └── platform_adapter.cpp
│
├── docs/ # 文档目录
│ ├── ARCHITECTURE.md # 架构设计文档
│ └── API.md # API 文档
│
├── prototypes/ # 原型和测试代码
│ └── README.md
│
└── tools/ # 开发工具脚本
└── README.md
模块说明
核心库 (core/)
100% 跨平台的业务逻辑实现，不依赖任何平台特定 API。
- common/: 基础类型定义和常量
- network/: 网络抽象层，统一管理 RNDIS、Wi-Fi、以太网
- nat_traversal/: NAT 穿透模块（STUN/TURN/ICE）
- protocol/: 基于 FlatBuffers 的协议定义和序列化
- session/: 会话生命周期管理
- codec/: 编解码器抽象接口和管理
- role/: 角色（Host/Client/Peer）实现
- file_transfer/: 文件传输模块（断点续传、多文件传输）
- utils/: 通用工具类（日志、定时器等）
平台适配层 (platforms/)
各平台特定功能的薄封装层。
Android
- capture/:
- 屏幕捕获（MediaProjection API 封装）
- 摄像头捕获（Camera2 API / NDK Camera API）
- render/: 渲染引擎（用于 Client 角色）
- input/: 触摸输入处理
- network/: Android 网络管理（USB RNDIS、Wi-Fi）
Windows
- virtual_display/: IddCx 驱动框架封装，创建虚拟显示器
- capture/:
- 摄像头捕获（DirectShow / Media Foundation）
- render/: DirectX 渲染引擎
- input/: 键盘和鼠标输入处理
- network/: Windows 网络管理（USB RNDIS、Wi-Fi、以太网）
命名空间
displayflow::core- 核心库displayflow::platform::android- Android 平台适配displayflow::platform::windows- Windows 平台适配
构建系统
使用 CMake 作为统一构建系统：
- 根目录
CMakeLists.txt负责平台检测和子目录管理 - 各模块有独立的
CMakeLists.txt - 支持条件编译，根据平台自动选择对应的适配层
当前状态
所有基础框架文件已创建，包含：
- ✅ 完整的目录结构
- ✅ 所有头文件和源文件占位符
- ✅ CMake 构建配置
- ✅ 基础类型和接口定义
下一步：开始实现核心功能模块。
新增功能模块
文件传输模块 (core/file_transfer/)
支持在设备间传输文件，特性包括：
- 断点续传
- 多文件并发传输
- 传输进度监控
- 文件校验（MD5/SHA256）
- 传输队列管理
远程摄像头模块
支持使用对方的摄像头作为视频源，特性包括：
- 摄像头设备枚举和选择
- 视频流捕获和编码
- 与屏幕共享复用相同的传输通道
- 支持多摄像头切换
- 摄像头参数控制（分辨率、帧率等）
NAT 穿透模块 (core/network/nat_traversal/)
支持通过互联网连接设备，突破局域网限制，特性包括：
- STUN 客户端：NAT 类型检测和公网 IP 发现
- TURN 客户端：中继服务器支持（当直连失败时）
- ICE 协议：自动选择最佳连接路径
- 候选地址收集：收集本地、STUN、TURN 候选地址
- 连接建立：自动尝试多种连接方式，选择最优路径
连接方式优先级：
- 局域网直连（最快）
- 公网直连（通过 STUN 发现）
- TURN 中继（最慢但最可靠）
架构优势：
- 文件传输复用现有的网络抽象层和协议层
- 摄像头捕获复用现有的编码和传输机制
- NAT 穿透完全透明，上层无需关心连接方式
- 完全集成到现有角色模型中
- 保持跨平台兼容性