🎯 Seetong 问题雷达 第261期

🔴 问题 1：Android 8.4.1.6 卡回放期间系统按设定时间自动息屏，常亮修复仍只在 8.4.2 分支 ｜ 负责人：陈宝旺、欧阳荣

1. 现象与覆盖范围

• 现象：用户在 Android 手机上看回放录像，播放过程中手机按系统「自动锁屏」时长自行熄屏，回放随之中断；同一用户明确表示「没有更新之前不会」。
• 涉及反馈：本期 2 条独立用户，均为 Android 8.4.1.6。
• 260353（2026-10-29 20:40:38，HUAWEI DVC-AN20，浙江嘉兴，用户 15955867993，原文「更新最新版本看回放 手机会根据系统设置自动锁屏 没有更新之前不会」，附 Logan 18 299 行，覆盖 02:12:41–20:40:39）
• 260354（2026-10-29 20:54:00，vivo V2551A，广东广州，用户 ling901172，原文「手机看回放怎么会息屏了」，附 Logan 11 643 行，覆盖 08:30:41–20:54:42）
• 存量延续：ling901172 自 2026-09-26 起已连续多期反馈同一问题（第 253 期 259420、第 260 期之前的 259401），累计形成长期重复用户。
• 严重度评分：74 / 100（反馈量 20 ／ 共性 24 ／ 关键度 30，取回放类上限 30 并向设备可用性上游加权）。反馈量按「本期 2 名独立用户 + 近 5 期累计 5 条独立反馈」计；共性按「2 个品牌 × 2 个机型 × 2 个地区 + 单一版本」4 维计。

2. 神策证据

• 回放业务量（CloudPlayback 自然日）：10 月 23 日至 29 日 PV 依次 298 117 / 310 490 / 314 867 / 302 327 / 292 332 / 292 817 / 291 705，UV 依次 127 062 / 130 630 / 133 033 / 128 013 / 124 770 / 125 512 / 124 248，7 天规模稳定、无整体塌陷；10 月 30 日截至查询为 PV 188 999 / UV 88 103（当日未跑完，不作对比）。
• 回放成功口径不可用：CloudPlayback 的 is_success、error_code 两个字段在逐日 GROUP BY 中出现整列取值被折叠成单一值（同一次查询里 is_success=1 与 is_success=0 交替出现、且失败行 error_code 恒为 200），属字段映射异常。因此本期不引用回放成功率，避免用坏数据下结论。
• 维度字段失效：$os、$app_version、$network_type 分组返回字面量（如 "$os"），无法按平台/版本切分回放表现。该项与第 260 期「神策平台维度失效」是同一问题，仍未修复。
• 结论边界：神策只能证明「回放是大规模在用的一级功能」，不能量化息屏发生率——现有事件没有屏幕常亮状态、系统息屏时刻或页面前后台切换字段。

3. Logan 关键日志（核心证据）

反馈 260353（HUAWEI DVC-AN20）——本次取得直接证据链：

• 20:14:57.706 KMP_SCAN_TRACE-onCreate page=PlayBackPage，devId 20033072，确认进入 KMP 回放页。
• 20:15:20.898 KMPPlayBackVideoView-playVideoByTime devId=20033072, time=20261029181055 → 20:15:23.872 RecordPlayerView-onRecvFirstFrame → 20:15:23.890 mark card playback first frame，回放已经开始出图。
• 20:15:04.322 / 20:16:33.671 / 20:17:06.314 三次 KRPerformanceManager---onPause--。
• 20:16:33.745 LibImpl-stopNvrReplay:1:devId=[20033072] → 20:16:33.770 Front & Back switch receive: front to back → 20:16:34.848 onAppBackToFront-Front & Back switch receive action:android.intent.action.SCREEN_OFF → 20:16:34.849 Powersave: globalscreen off。
• 20:35:03.514 起同一进程重新 onAppStart，说明用户是被息屏打断后重新点亮并重启应用。
• 全文件检索 KEEP_SCREEN_ON、keepScreenOn、Screen awake、setKeepScreenOn、FLAG_KEEP_SCREEN_ON、WakeLock：0 命中。
• 关键引文：
• 2026-10-29 20:16:33.770 [main] Front & Back switch receive: front to back
• 2026-10-29 20:16:34.848 [main] onAppBackToFront-Front & Back switch receive action:android.intent.action.SCREEN_OFF

反馈 260354（vivo V2551A）：

• 日志覆盖 08:30:41–20:54:42 全时段 11 643 行，期间有多段实时预览与 P2P 连接记录，但全文件 PlayBackPage 命中 0 次，也没有任何常亮请求痕迹。
• 该份日志无法证明用户是在 KMP 回放页操作时息屏（可能使用旧原生回放页或日志已被滚动截断），因此只作现象旁证，不作为代码推断依据。

4. 代码定位

• 涉及模块：seetong-kmp（KMP 共享层）+ Seetong-App-Android（Android 宿主桥接）。
• KMP 侧现状（feature_v8.4.2 分支）：
• moduleBase/src/commonMain/kotlin/com/seetong/base/page/BasePager.kt:81 protected open fun keepScreenOnWhenVisible(): Boolean = false
• 同文件 :85 syncKeepScreenOn(enabled)，在 pageDidAppear() 请求常亮、pageDidDisappear() 释放。
• modulePlayback/src/commonMain/kotlin/com/seetong/moduleplayback/page/playback/PlayBackPage.kt:204 override fun keepScreenOnWhenVisible(): Boolean = true
• Android 宿主现状（feature_v8.4.2_lan 分支）：
• Seetong5.0ForSeetong/Seetong5.0/kmp/src/main/java/com/seetong/kuikly/KuiklyRenderActivity.kt:84 setKeepScreenOn(pageName, enabled)，:95 applyScreenAwakeRequest() 按「页面请求 × Activity 前台」添加/清除 WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON。
• .../kuikly/modules/KMPBridgeModule.kt:116-120 接收 setKeepScreenOn 桥接调用。
• 提交：KMP f98e6f3b（2026-09-24，陈宝旺，「屏幕常亮抽象到BasePage」）、Android e840dc3b6（2026-09-24，陈宝旺，BUG 1015747）。
• 分支覆盖核对（本期新增关键结论）：

也就是说：线上 8.4.1.6 所属的 8.4.1.x 维护分支与 hotfix_8.4.1 都没有这条修复，只有 8.4.2 之后的版本才有。这解释了为什么确认修复已合入近两个月后，线上仍持续出现同一条反馈。

• 调用链：PlayBackPage.pageDidAppear() → BasePager.syncKeepScreenOn(true) → bridgeModule.setKeepScreenOn(pageName, true) → KMPBridgeModule → KuiklyRenderActivity.setKeepScreenOn → applyScreenAwakeRequest() → window.addFlags(FLAG_KEEP_SCREEN_ON)。8.4.1.6 上这条链从第一环就不存在（PlayBackPage 没有覆写，宿主也没有桥接方法）。
• 修复方向锚点：把 f98e6f3b 与 e840dc3b6 完整 Backport 到 8.4.1.x 维护分支——两个提交必须成对回溯，只带 KMP 侧覆写而不带宿主窗口标志等于没修。

5. 根因结论

• 置信度：🟢 强（现象 + 日志 + 代码 + 分支覆盖四路互证）。
• 一句话根因：Android 8.4.1.6 的 KMP 回放页未向宿主申请 FLAG_KEEP_SCREEN_ON，系统按用户设置的自动锁屏时长照常息屏，而修复代码至今只在 8.4.2 及之后的分支。
• 关键证据链：260353 Logan 中 SCREEN_OFF 出现在「回放中 · 页面已出图」的 71 秒后，且全文件无常亮请求 → 代码确认 8.4.1.x/hotfix_8.4.1 无 setKeepScreenOn 与 keepScreenOnWhenVisible 覆写 → 神策证明回放是日均 12 万 UV 的一级功能。

6. 建议下一步

• 分配给：陈宝旺（KMP 与 Android 宿主常亮实现作者），Android 发版负责人配合出 8.4.1.x 补丁包。
• 优先处理：① 把两个提交成对 Backport 到 hotfix_8.4.1 并进入下一次 8.4.1.x 发版；② 若短期不出补丁包，至少在发布说明中明示「回放息屏问题将于 8.4.2 修复」，并对 ling901172 做一次客服回访，结束长期无反馈循环。
• 验证方法：系统息屏时间分别设为 15 秒与 30 秒，卡回放、云回放各连续播放 10 分钟，断言页面可见期间不出现 SCREEN_OFF；退出回放、切普通页面、退到后台三类场景各 10 次，断言常亮被成对释放（日志中 Screen awake applied=false）。
• 任务账本：沿用 T-20260926-170258-576a（已更新本期证据与分支覆盖结论），不新建重复任务。

🟠 问题 2：Android 8.4.1.6 回放出现有声无图/不出图，播放失败事件后仍被标记「首帧成功」 ｜ 负责人：陈宝旺

1. 现象与覆盖范围

• 现象：用户在 Android 上看回放时看不到画面——一种描述是「回放没有视频」，HarmonyOS 侧对应描述是「回放时只有声音没有画面」；另有用户描述「为什么不能回放」。
• 涉及反馈：本期 4 条相关原声，覆盖 3 个平台维度中的 2 个。
• 260391（2026-10-30 08:03，Android 8.4.1.6，HONOR MAA-AN10，吉林长春）「回放没有视频呢」，附 Logan
• 260392（2026-10-30 08:05，HarmonyOS 1.1.2.3，HUAWEI CHZ-AL00，山东潍坊）「回放时怎么只有声音没有画面？」，无 Logan
• 260316（2026-10-29 18:23，Android 8.4.1.6，OPPO PESM10，辽宁朝阳）「为什么不能回放」，附 Logan
• 260318（2026-10-29 18:30，HarmonyOS 1.1.2.3，HUAWEI ALN-AL00，山东）「回放有时候黑屏」，无 Logan
• 关键佐证：260353 在描述息屏问题的同一份 Logan 里，20:15:23 出现过两次 receive playback play failed event, devId=20033072, result=0。
• 严重度评分：61 / 100（反馈量 10 ／ 共性 21 ／ 关键度 30）。反馈量按 4 条原声但仅 1 份可用 Logan 计；共性按「2 平台 × 3 品牌 × 3 地区 × 多版本」计。

2. 神策证据

• 回放播放量（DeviceVideoPlayback）：10 月 29 日 PV 20 173 737 / UV 5 273 450；10 月 30 日截至查询 PV 13 534 781 / UV 4 112 016（当日未跑完）。播放状态 video_play_status 逐日只返回 1 一个取值，无法用该字段统计失败率。
• CloudPlayback 的 is_success / error_code 字段本窗口取值折叠（详见问题 1 第 2 节），回放成功率不可引用。
• 结论边界：神策既不能证实也不能证伪「有声无图」的比例。该问题本期不依赖神策定量，只作为业务量级背景。

3. Logan 关键日志

反馈 260353（HUAWEI DVC-AN20，Android 8.4.1.6）20:15 段落按时间顺序：

• 20:15:20.898 KMPPlayBackVideoView-|playVideoByTime devId=20033072, time=20261029181055, alarmType=268435455, audioEnable=1
• 20:15:20.925 RecordPlayerView-startReplay: devId=20033072, date=20261029181055, recordType=268435455
• 20:15:20.925/20:15:20.926 LibImpl-startNvrReplay:1:record=[null] → startNvrReplay:2:ret=[0]（入参 record 为 null、返回 0）
• 20:15:23.662 / 20:15:23.788 PlayBackPage-|receive playback play failed event, devId=20033072, result=0
• 20:15:23.722 LibImpl-onNvrReplayResp, act=0, have audio=1, video codec=H265（音频通道已起、视频编码已识别）
• 20:15:23.872 RecordPlayerView-onRecvFirstFrame: devId=20033072 … isOwner=true
• 20:15:23.890 PlayBackPage-|mark card playback first frame, devId=20033072（失败后 128 ms 又标记首帧成功）
• 注：日志中没有 retry replay after stop 记录，说明 result=0 这一支并未走到重播分支。

4. 代码定位

• 关键文件：seetong-kmp/modulePlayback/src/commonMain/kotlin/com/seetong/moduleplayback/page/playback/card/CardPlayBackPageLogic.kt
• 失败事件处理：:3117-3151 Events.PLAYBACK_PLAY_FAILED_EVENT 监听。
• :115 CARD_PLAYBACK_FULL_PEOPLE_TYPE = -14
• :117 CARD_PLAYBACK_FAILED_RESULT_THRESHOLD = 0，注释写明「负值表示回放启动失败，需要按 Android 行为执行 stop 后重播」
• :3129 分支 result == -14 → 人数已满提示；:3137 分支 result < 0 → stopDev() + playOrSeek(replayTimeSec) 重播
• result == 0 落在两个分支之外，直接静默返回——日志里「收到 play failed 但没有任何后续动作」正对应这一点。
• 首帧处理：:3054-3080 Events.RECORD_FIRST_FRAME_EVENT，:3071 打印 mark card playback first frame 并清 showVideoLoading／showVideoMask，没有校验当前是否处于失败态、也没有校验该设备是否刚收到 result=0。
• 调用链：KMPPlayBackVideoView.playVideoByTime → RecordPlayerView.startReplay → SDK LibImpl.startNvrReplay → SDK 回调 PLAYBACK_PLAY_FAILED_EVENT(result=0) → CardPlayBackPageLogic 失败监听（无动作）→ SDK 又回调 RECORD_FIRST_FRAME_EVENT → markPlaybackFirstFrame 置成功。
• 修复方向锚点：① :3137 的失败判定从 result < CARD_PLAYBACK_FAILED_RESULT_THRESHOLD 改为显式枚举失败码或改为 <=，至少让 result=0 不再静默吞掉；② :3071 首帧标记前增加失败态守卫（若最近 N 秒内该 devId 收到失败事件则先重播再置成功）；③ startNvrReplay 入参 record=[null] 需要在 Kotlin 侧拦截，空录像列表不应发起播放。

5. 根因结论

• 置信度：🟡 中。失败事件被吞、首帧误判两条在代码与日志里能对上；但本期只有 1 份可用 Logan，且该样本最终仍出了图，无法确认用户实际看到的「没有视频」就是这条路径。
• 一句话根因：回放启动失败（result=0）既不在重播分支也不在人数已满分支，被静默忽略；随后 SDK 又回调首帧事件，页面把失败场景渲染成成功，用户侧表现为长时间黑屏/有声无图。
• 关键证据链：260353 日志中「play failed(result=0) → 128 ms 后 mark first frame」的时间顺序 → CardPlayBackPageLogic.kt:3137 的 result < 0 分支漏掉 result == 0 → :3071 首帧标记无失败态守卫。

6. 建议下一步

• 分配给：KMP 回放模块负责人（CardPlayBackPageLogic.kt 近期提交者）。
• 优先处理：① 补齐 result=0（及 SDK 全部失败码）的失败态处理与重播上限，禁止静默返回；② 首帧标记加失败态守卫；③ 在 startNvrReplay 前拦截空 record。
• 验证方法：构造「设备离线」「SD 卡无录像」「唤醒未完成」「回放人数已满」四类场景各 10 次，断言失败场景不出现 mark card playback first frame，且用户能看到明确文案或自动重播；回归正常回放 20 次，断言首帧耗时无回退。
• 任务账本：新建 T-20261030-171339-f474（保持 captured，等研发确认后再升级状态）。

本期扫描全量（全部沉淀到知识库）

本窗口共 187 条：🟣 普遍网络问题 142 条仅计入总量（其中 -102/-101 模板原文占绝大多数，Android 8.4.1.6 125 条），下表列出其余 45 条非网络类原声。

已折叠 5 条普遍性网络问题（含 -102/-101/-1002 与中/英/俄/法/西/葡/土/阿/日多语言网络提示模板，如 Проверьте телефонную сеть、Please check your mobile network）；全量明细见同名 Markdown 知识库。

网络类 142 条按平台分布：Android 8.4.1.6 125 条、Android 8.3.13.3 7 条、Android 8.3.14.2 4 条、Android 8.3.5.4 2 条、其他旧版本 4 条；Harmony/iOS 全部 24 条非网络类中未出现新的网络模板集中。

应用市场反馈（2026-10-30 00:00–23:59）

差评原文摘录：本窗口没有采集到应用市场评论。

采集状态：App Store 0 条｜华为应用市场 0 条｜应用宝 0 条｜Google Play 失败（未配置代理）｜待导入：荣耀应用市场 / vivo 应用商店 / OPPO 软件商店 / 小米应用商店。上述失败项按原样记录，不等于「没有反馈」。

数据源状态

心愿单亮点

待补证

• 260354 缺回放页日志：11 643 行里 PlayBackPage 命中 0，无法确认用户是在 KMP 回放页还是旧原生回放页息屏。下期需通过客服回访确认操作路径，或请用户重新抓取一次完整 Logan。
• 260391 / 260316 的 Logan 未深挖：问题 2 目前只有 260353 一份样本能对上代码路径，需再从这两份日志里确认 result=0 与首帧误判是否重复出现，才能把置信度从「中」提到「强」。
• 神策 CloudPlayback 字段不可用：is_success / error_code 取值折叠、$os / $app_version 返回字面量，与第 260 期是同一问题。建议数据侧核对事件属性映射，否则后续所有回放类问题都只能靠 Logan 单点取证。
• 8.4.1.x 是否还会发包：问题 1 的修复要落到线上，前提是 hotfix_8.4.1 还会出补丁版本。若确定不再出 8.4.1.x，则应改为客服话术 + 强制升级引导，不能继续让用户重复反馈。
• 应用市场渠道长期盲区：App Store 未配 ASC Key、Google Play 无代理、四家手商店未导入，应用市场侧仍完全没有信号。

下一期 = 第262期 = 2026-10-31-H17.md（明天下午 17:00；窗口 2026-10-30 17:00～2026-10-31 17:00）