
android端chrome浏览器在chromecast投屏过程中,若遭遇网络断开、接收设备断电或wi-fi关闭等异常情况,页面会无提示强制退出;该问题在windows平台未复现,根本原因在于`session.sendmessage()`调用缺乏前置健壮性校验。
在基于Cast SDK的Web投屏应用中,session.sendMessage() 是向已连接的Chromecast接收端发送消息的核心API。然而,在android Chrome(v83–v98.0.4758.101)中,该方法在底层网络通道不可达时不会抛出javaScript错误,也不会触发onError或onDisconnect事件,而是直接引发浏览器进程崩溃(表现为标签页静默关闭),且adb日志、chrome://crashes及前端window.onerror均无有效线索——这正是该问题难以调试的关键。
为规避此缺陷,必须在每次调用 session.sendMessage() 前实施三重主动健康检查,确保通信链路处于可预期的稳定状态:
async function safeSendMessage(session, namespace, data) { // 1. 检查Cast会话是否活跃且未终止 if (!session || session.status !== chrome.cast.SessionStatus.ACTIVE) { console.warn('Cast session is not active'); await cleanupSession(session); return false; } // 2. 检查浏览器网络连通性(客户端层面) if (!navigator.onLine) { console.warn('Navigator reports offline'); await cleanupSession(session); return false; } // 3. 执行轻量级网络探活(推荐使用HEAD请求或短超时GET) try { const res = await fetch('/api/health', { method: 'HEAD', cache: 'no-cache', signal: AbortSignal.timeout(2000) }); if (!res.ok) throw new Error(`Health check failed: ${res.status}`); } catch (err) { console.warn('Network health check failed:', err); await cleanupSession(session); return false; } // 全部通过后才执行实际发送 try { await session.sendMessage(namespace, data); return true; } catch (err) { console.error('sendMessage failed unexpectedly:', err); await cleanupSession(session); return false; } } async function cleanupSession(session) { if (session && session.endSession) { try { await session.endSession(); } catch (e) { console.debug('Session cleanup ignored:', e); } } }
⚠️ 关键注意事项:
- navigator.onLine 仅反映操作系统网络接口状态,不能替代真实http探测(例如Wi-Fi已连但网关失联);务必叠加服务端健康检查。
- 避免在message回调中直接调用sendMessage形成递归风险;所有发送逻辑应统一走safeSendMessage封装。
- 健康检查引入的延迟(通常
- 建议在session.addUpdateListener中监听SessionStatus.STOPPED或SessionStatus.INVALID,并同步清理本地会话引用,防止内存泄漏。
综上,这不是SDK Bug的修复,而是对Android Chrome底层不兼容行为的必要防御性编程。将“假设连接可靠”转变为“验证后才通信”,是构建高可用投屏Web应用的必备实践。