feat: 初始化 iOS 远程控制端项目

webrtc_controller_ios/README.md

@@ -0,0 +1,57 @@
+# web_rtc_controller_ios
+
+iOS 版 WebRTC 远程控制端，功能对齐 Android 端 `WebRTCController`，配合 `WebRTCSignalServer` 信令服务器与被控端 `WebRTCControlled` 使用。
+
+## 环境要求
+
+- Xcode 15 及以上
+- iOS 15.0 及以上（iPhone / iPad）
+- 依赖通过 Swift Package Manager 自动拉取：[stasel/WebRTC](https://github.com/stasel/WebRTC)（Google WebRTC 官方二进制封装）
+
+## 架构：UIKit 与 SwiftUI 混用
+
+| 层 | 技术 | 说明 |
+| --- | --- | --- |
+| 应用生命周期 | UIKit (`AppDelegate` / `SceneDelegate`) | `UIHostingController` 承载 SwiftUI 根视图 |
+| 界面 | SwiftUI (`ContentView` / `AuthSheetView`) | 连接设置页、鉴权弹窗、控制面板、统计信息 |
+| 视频渲染（WebRTC 模式） | UIKit (`RTCMTLVideoView`) | 经 `UIViewRepresentable` 嵌入 SwiftUI |
+| 视频渲染（自编码模式） | UIKit (`AVSampleBufferDisplayLayer`) | H.264 裸流 VideoToolbox 硬解直显 |
+| 触控捕获 | UIKit (`RemoteTouchView`) | 原始触摸事件实时转发，保证"跟手" |
+| 状态管理 | Combine (`ControllerViewModel`) | `ObservableObject` 驱动 SwiftUI |
+
+## 目录结构
+
+```
+web_rtc_controller_ios/
+├── App/                    # UIKit 生命周期入口
+├── Signaling/              # 信令：SignalMessage(JSON) + WebSocket 客户端
+├── Control/                # ControlMessage：与 control_message.proto 二进制兼容的手写 protobuf 编解码
+├── WebRTC/                 # WebRTCClient（PeerConnection/DataChannel）+ SelfCodecDecoder（自编码 H.264 解码）
+├── Views/                  # SwiftUI 页面 + UIKit 渲染/触控视图（UIViewRepresentable 桥接）
+├── ViewModel/              # ControllerViewModel
+└── Utils/                  # 设备 ID 等工具
+```
+
+## 与 Android 端保持一致的协议
+
+- **信令**（WebSocket + JSON）：`REGISTER` / `OFFER`(携带 `authType`/`authValue`) / `ANSWER` / `ICE_CANDIDATE` / `TARGET_OFFLINE` / `CONNECTION_REJECTED` / `REQUEST_ERROR` / `REQUEST_TIMEOUT`
+- **控制通道** `control_channel`（可靠有序）：protobuf `ControlMessage`（MOTION_EVENT / SWIPE / KEY / SET_RESOLUTION / SET_STREAM_MODE 及被控端上报）
+- **自编码视频通道** `video_channel`（不可靠低延迟）：`0xAB` 魔数分片协议（大端序），单元内为 H.264 Annex-B 裸流（CONFIG=SPS/PPS，FRAME=视频帧）
+- **ICE**：`stun:stun.l.google.com:19302`、`stun:www.ttstd.com:3478`、`turn:www.ttstd.com:3478`
+
+## 功能
+
+- 连接信令服务器并注册（设备 ID 格式 `CTRL-XXXXXXXX`，本地持久化）
+- 三种鉴权方式：免密连接 / 动态验证码 / 固定密码
+- 远程屏幕实时观看 + 触控（跟手的原始 MotionEvent 转发 + 滑动补发 SWIPE）
+- 导航键：返回 / 主页 / 多任务（Android keyCode 4 / 3 / 187）
+- 分辨率切换：原始画质 / 1080P / 720P / 480P
+- 串流模式切换：WebRTC（SRTP 视频轨）/ 自编码（DataChannel H.264 裸流 + VideoToolbox 硬解）
+- 实时统计：分辨率、帧率、码率、RTT、链路类型（P2P/TURN）、编解码器等
+
+## 运行
+
+1. 用 Xcode 打开 `web_rtc_controller_ios.xcodeproj`，首次打开等待 SPM 解析 WebRTC 依赖。
+2. 在 Signing & Capabilities 中选择自己的开发团队。
+3. 真机运行（模拟器无法验证硬解与摄像头相关能力，控制功能可用）。
+4. 输入信令服务器地址（默认 `wss://www.ttstd.com/signal`）与被控端设备 ID，选择鉴权方式后连接。