From d616986d049e1c629da3fe48821912a7f98189db Mon Sep 17 00:00:00 2001
From: Jessou115 <jessy.dufour@ghosthub.fr>
Date: Sun, 12 Jul 2026 17:02:22 +0200
Subject: [PATCH] feat(cef): allow UI audio without a user gesture
 (autoplay-policy)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

CEF views here are host-driven overlays (notifications, HUD, menus) that
never receive a real user activation, so Chromium's default autoplay policy
silently blocks all sound — both Web Audio (AudioContext stays suspended)
and <audio> playback. Opt the embedded browser out with
--autoplay-policy=no-user-gesture-required so resources can play UI sounds.

There's no page-side workaround for a passive overlay: it never gets a
gesture and synthetic events don't count as activation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 code/framework/src/gui/cef/app.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/code/framework/src/gui/cef/app.cpp b/code/framework/src/gui/cef/app.cpp
index b2715f913..d614a0d5a 100644
--- a/code/framework/src/gui/cef/app.cpp
+++ b/code/framework/src/gui/cef/app.cpp
@@ -47,6 +47,10 @@ namespace Framework::GUI::CEF {
         commandLine->AppendSwitch("disable-spell-checking");
         commandLine->AppendSwitch("disable-component-update");
         commandLine->AppendSwitchWithValue("disable-features", "WebUSB,WebHID");
+        // Allow UI audio without a user gesture: CEF views are host-driven overlays (notifications,
+        // HUD, menus) that never receive a real "user activation", so the default autoplay policy
+        // would silently block all sound (Web Audio / <audio>). This opts the embedded browser out.
+        commandLine->AppendSwitchWithValue("autoplay-policy", "no-user-gesture-required");
         // No internal begin-frame scheduler: rendering uses external begin frames.
     }