From 78a7c755e3043c0c2da3b0fd2c340a4420010a76 Mon Sep 17 00:00:00 2001
From: cryptocommuniums-afk <cryptocommuniums@gmail.com>
Date: Mon, 16 Mar 2026 22:24:50 +0800
Subject: [PATCH] docs add camera startup fallback changelog

---
 client/src/lib/changelog.ts | 16 ++++++++++++++++
 docs/CHANGELOG.md           | 22 ++++++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/client/src/lib/changelog.ts b/client/src/lib/changelog.ts
index 84df75d..1b6a878 100644
--- a/client/src/lib/changelog.ts
+++ b/client/src/lib/changelog.ts
@@ -8,6 +8,22 @@ export type ChangeLogEntry = {
 };
 
 export const CHANGE_LOG_ENTRIES: ChangeLogEntry[] = [
+  {
+    version: "2026.03.16-camera-startup-fallbacks",
+    releaseDate: "2026-03-16",
+    repoVersion: "a211562",
+    summary: "修复部分设备上摄像头因后置镜头约束、分辨率约束或麦克风不可用而直接启动失败的问题。",
+    features: [
+      "live-camera 与 recorder 改为共用分级降级的摄像头请求流程，会在当前画质失败时自动降分辨率、降约束并回退到兼容镜头",
+      "当设备不支持默认后置摄像头或当前镜头不可用时，页面会自动切换到实际可用的镜头方向，避免直接报错后卡死在未启动状态",
+      "recorder 预览启动不再被麦克风权限或麦克风设备异常整体拖死；麦克风不可用时会自动回退到仅视频模式",
+      "兼容模式命中时前端会给出明确提示，方便区分“已自动降级成功”与“仍然无法访问摄像头”的场景",
+    ],
+    tests: [
+      "pnpm build",
+      "部署后线上 smoke: 待补记公开站点前端资源 revision 与 `/live-camera`、`/recorder` 摄像头启动结果",
+    ],
+  },
   {
     version: "2026.03.16-live-analysis-viewer-full-sync",
     releaseDate: "2026-03-16",
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index d999e9a..e88d198 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -1,5 +1,27 @@
 # Tennis Training Hub - 变更日志
 
+## 2026.03.16-camera-startup-fallbacks (2026-03-16)
+
+### 功能更新
+
+- 修复部分设备在 `/live-camera` 和 `/recorder` 中因默认后置镜头、分辨率或帧率约束不兼容而直接启动摄像头失败的问题
+- 摄像头请求现在会自动按当前画质、去掉高约束、低分辨率、备用镜头、任意可用镜头依次降级重试
+- `/recorder` 在麦克风不可用或麦克风权限未给出时，会自动回退到仅视频模式，不再让整次预览启动失败
+- 如果实际启用的是兼容镜头或降级模式，页面会显示提示，帮助区分“自动修复成功”与“仍然无法访问摄像头”
+
+### 测试
+
+- `pnpm build`
+- 部署后线上 smoke：待补记公开站点前端资源 revision 与 `/live-camera`、`/recorder` 摄像头启动结果
+
+### 线上 smoke
+
+- 待本次部署完成后补记
+
+### 仓库版本
+
+- `a211562`
+
 ## 2026.03.16-live-analysis-viewer-full-sync (2026-03-16)
 
 ### 功能更新