fix(§10.5): 通知中心叠加媒体保活——播放中 App 不 SIGSTOP（修播放中滑通知中心音乐停）

- launcher: run_app_notif_overlay 入口 meow_media_app_playing() 判定（当前源+PLAYING+app_id 匹配） → 不 SIGSTOP/不 SIGCONT，App 续跑保 PCM；非播放中维持 SIGSTOP 模板；关闭时 unlink 标记挪到恢复帧上屏后（防未冻结 App 抢 present 一帧回闪）。 - SDK gfx: present() 见 /tmp/meow_notif_active（env MEOW_NOTIF_ACTIVE_FILE 覆写）自抑上屏，仅 App 进程（系统 UI/launcher 不抑制），200ms 节流 stat，脏区累积解除后一次上屏； meow_gfx_overlay_suppressed_count 供单测断言。 - SDK input: 叠加期排空丢弃本进程 evdev 副本 + EVIOCGKEY 位图静默对齐（防面板点击被 App 双重消费/解除后边沿误判），进入沿复位触摸状态机。 - 宿主：新 test_overlay_suppress T1-T4 + test_media §8（8 用例）全 PASS；test_notif_*/ test_sdk_*/test_vol_ramp_jack 等回归全过；zig-mipsel -Wall -Wextra 全 TU 0 warning。 - meow_launcherd fbb82036（/usr/bin 只读待固件，fw_content.conf 已更）/ meow_ui.a d6242fc2 / hello a073535a / files 2b799d07（已热更到卡）；ncm 未重链（ncm_app 他 agent 在改）。
2026-09-01 15:23:32 +08:00
1 parent 820d1e52bf
commit ad9778476a
@@ -0,0 +1,97 @@
+/* test_overlay_suppress.c — §10.5 叠加让位 present 自抑宿主验证（离屏 480x720，16bpp）。
+ *
+ * 背景：媒体播放中的 App 前台唤起通知中心时 launcher 不 SIGSTOP（保 PCM 供流），改由 SDK
+ * present 层见 /tmp/meow_notif_active（宿主用 MEOW_NOTIF_ACTIVE_FILE 覆写）自抑上屏。
+ *
+ * 覆盖：
+ *   T1  无标记：flush 正常上屏（frames_presented 递增，抑制计数 0）；
+ *   T2  有标记：flush 被抑制（只画进 back_buf 不 present：frames 不变、抑制计数递增）；
+ *   T2b 抑制期第二次 flush 仍被抑制（200ms 节流缓存内行为一致）；
+ *   T3  标记消失：下一次 flush 恢复上屏（抑制期累积脏区一次上屏，无需重画）；
+ *   T4  系统 UI 进程（launcher，system_mode=1）即使有标记也不抑制（面板必须照常上屏）。
+ *
+ * 编译（宿主 gcc，链真实 gfx/sys/theme/vol/log/widget/input/activity/dialog/ime + 打桩 font/global）：
+ *   gcc -Wall -Wextra -o test_overlay_suppress test_overlay_suppress.c test_host_stub.c \
+ *       meow_ui_gfx.c meow_ui_sys.c meow_ui_theme.c meow_ui_vol.c meow_ui_log.c \
+ *       meow_ui_widget.c meow_ui_input.c meow_ui_activity.c meow_ui_dialog.c meow_ui_ime.c \
+ *       meow_ui_draw.c meow_ui_view.c meow_notify_ipc.c \
+ *       -I. -I../meow_launcherd -DMEOW_UI_HOST_TEST -pthread
+ */
+#include "meow_ui.h"
+#include "meow_ui_internal.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <assert.h>
+#include <unistd.h>
+#include <fcntl.h>
+
+#define MARKER "/tmp/test_notif_active_sdk"
+
+static void marker_write(void)
+{
+    int fd = open(MARKER, O_WRONLY | O_CREAT | O_TRUNC, 0644);
+    assert(fd >= 0);
+    if (write(fd, "1", 1) < 0) assert(0);
+    close(fd);
+}
+
+int main(void)
+{
+    setenv("MEOW_UI_DUMP", "/tmp/overlay_suppress.ppm", 1);
+    setenv("MEOW_NOTIF_ACTIVE_FILE", MARKER, 1);
+    unlink(MARKER);
+    meow_ui_opts o = { 480, 720 };
+    assert(meow_ui_init(&o) == 0);
+    meow_ui_set_refresh_always_max(1);   /* 绕过帧率门控：每次 flush 都直达 present 判定 */
+
+    /* T1：无标记正常上屏（默认 App 进程模式：render_enabled==0） */
+    assert(meow_ui_sys_render_enabled() == 0);
+    meow_ui_clear(0x112233);
+    meow_ui_flush();
+    assert(meow_ui_frames_presented() == 1);
+    assert(meow_gfx_overlay_suppressed_count() == 0);
+    printf("T1 PASS: no marker -> presented=1 suppressed=0\n");
+
+    /* T2：有标记 → 抑制（等 >200ms 越过存在性节流缓存） */
+    marker_write();
+    usleep(250000);
+    unsigned long long f0 = meow_ui_frames_presented();
+    meow_ui_clear(0x223344);
+    meow_ui_flush();
+    assert(meow_ui_frames_presented() == f0);
+    assert(meow_gfx_overlay_suppressed_count() == 1);
+    printf("T2 PASS: marker present -> suppressed (frames frozen at %llu)\n", f0);
+
+    /* T2b：抑制期再次 flush 仍抑制（节流缓存内一致） */
+    meow_ui_clear(0x334455);
+    meow_ui_flush();
+    assert(meow_ui_frames_presented() == f0);
+    assert(meow_gfx_overlay_suppressed_count() == 2);
+    printf("T2b PASS: still suppressed within throttle window\n");
+
+    /* T3：标记消失 → 恢复上屏（抑制期累积的整帧脏一次上屏，无需重画） */
+    unlink(MARKER);
+    usleep(250000);
+    meow_ui_flush();
+    assert(meow_ui_frames_presented() == f0 + 1);
+    assert(meow_gfx_overlay_suppressed_count() == 2);
+    printf("T3 PASS: marker gone -> present resumed (accumulated dirty flushed)\n");
+
+    /* T4：系统 UI 进程（launcher）不抑制——通知中心面板本身必须照常上屏 */
+    meow_ui_sys_set_system_mode(1);
+    assert(meow_ui_sys_render_enabled() == 1);
+    marker_write();
+    usleep(250000);
+    unsigned long long f1 = meow_ui_frames_presented();
+    meow_ui_clear(0x445566);
+    meow_ui_flush();
+    assert(meow_ui_frames_presented() == f1 + 1);
+    assert(meow_gfx_overlay_suppressed_count() == 2);   /* 不再增长 */
+    unlink(MARKER);
+    printf("T4 PASS: system-UI process (launcher) never suppressed\n");
+
+    meow_ui_shutdown();
+    printf("ALL PASS\n");
+    return 0;
+}