投屏平台 · 产品化部署
一套系统，统一手机发起、TV 接收与后台发布
TouPing 把投屏码、WebRTC 信令、主题配置、启动广告、页面发布和可观测指标整合为同一条交付链路。 适用于酒店电视、会议室大屏和家庭终端。
核心能力矩阵
会话与投屏码
支持移动端签发与 TV 端解析，统一 roomId/castCode 生命周期。
POST /api/mobile/cast-session
POST /api/tv/cast-session/resolve
主题与编辑页
按 target/hotel/device 维度发布主题，页面支持保存草稿与运行态发布。
POST /api/theme/publish
POST /api/editor/page/publish
启动广告与运营
后台一键保存、发布、运行端拉取，兼容静态广告 JSON 目录。
POST /api/startup-ad/publish
GET /api/startup-ad/runtime
可观测与告警
原生 healthz/metrics/prometheus 指标，覆盖消息失败率与上下游状态。
GET /healthz
GET /metrics/prometheus
部署拓扑
Sender / TV / iOS
→
go-castcode-bff
↔
go-signaling
→
MySQL / Redis / CDN
入口推荐 Nginx 统一代理：`/ws` 走 signaling，`/api/*` 走 bff，`/site/` 与 `/console/` 提供前端静态资源。
客户端发布清单
官网会优先读取 `/api/release/latest` 展示最新安装包信息，旧版会回退读取 `/apk/manifest.json`。
未获取
-
正在加载热更新发布数据...
APK 热更新导航
后台可按 target/channel 发布热更新版本，客户端启动时自动检查并按策略提示或强制更新。
发布版本
POST /api/release/publish 参数：target/channel/versionName/versionCode/fileUrl
查询版本
GET /api/release/latest 参数：target/channel/currentVersionCode
快速接入
申请投屏会话
curl -X POST /api/mobile/cast-session \
-H "Authorization: Bearer <MOBILE_API_TOKEN>" \
-d '{"deviceId":"android-01"}'
连接信令
ws://host/ws?clientId=android_01&role=sender joinRoom + castCode → offer/answer/ice