37 lines
2.1 KiB
Markdown
37 lines
2.1 KiB
Markdown
# 手术室耗材语音确认（浏览器端）
|
||
|
||
与 FastAPI **分宿部署**的纯静态页面（HTML + JavaScript + [Tailwind CSS](https://tailwindcss.com) CDN）：配置 **服务端 Base URL** 与 **本机语音终端 ID** 即可使用，协议与 [`docs/客户端手术通信接口说明.md`](../../docs/客户端手术通信接口说明.md) 一致（WebSocket 收 `voice_assignment` / `voice_pending` / `voice_pending_empty`，HTTP `POST .../resolve` 上传 WAV）。
|
||
|
||
## 本地预览
|
||
|
||
勿使用 `file://` 打开（麦克风与跨域行为异常）。在仓库根目录先执行 `uv sync --group dev`（**livereload** 在 dev 组中）。然后：
|
||
|
||
```bash
|
||
chmod +x start_voice_confirmation_web.sh # 仅首次
|
||
./start_voice_confirmation_web.sh # 默认 8080；编辑 HTML/JS 后浏览器自动刷新
|
||
# 若不需要热重载（仅 stdlib 静态服务）:
|
||
./start_voice_confirmation_web.sh --plain 8080
|
||
```
|
||
|
||
Windows：`start_voice_confirmation_web.bat`；无热重载时首参 `--plain` 再跟端口。亦可：
|
||
|
||
```bash
|
||
uv run --group dev python scripts/dev_static_livereload.py --root web/voice-confirmation -p 8080
|
||
```
|
||
|
||
浏览器访问 `http://127.0.0.1:8080`（或所选端口），将 **Base URL** 指向监控 API（如 `http://127.0.0.1:38080`）。
|
||
|
||
## 生产部署
|
||
|
||
- 将本目录原样部署到任意静态托管（Nginx、对象存储、CDN 等）。
|
||
- **HTTPS**：非 localhost 下浏览器通常要求安全上下文才允许麦克风；API 须使用 **https** 与 **wss**，避免混合内容被拦截。
|
||
- **CORS**：后端需对浏览器 `fetch` 放行；默认可开启环境变量 **`DEMO_CORS_ENABLED=true`**，并将 **`DEMO_CORS_ORIGINS`** 设为静态页来源（或联调期 `*`，见 [`main.py`](../../main.py)）。
|
||
|
||
## 与 `scripts/demo_client` 的关系
|
||
|
||
本目录与 [`scripts/demo_client/`](../../scripts/demo_client/) **相互独立**：Demo 含 HTTP 轮询待确认等联调能力；本页与官方语音确认语义一致，**不轮询** `GET .../pending-confirmation`。
|
||
|
||
## 推荐浏览器
|
||
|
||
录音与 `AudioContext` 行为以 **Chrome / Edge 新版** 为优先验证目标。
|