TV浏览器禁用file://协议是出于安全规约，因其将本地文件系统视为不可信来源，禁止video.src、fetch()、importScripts()等HTML5 API在非HTTP(S)环境下运行，必须通过HTTP服务（如http://192.168.1.100:8080）托管并适配TV特定限制。
TV浏览器（如三星Tizen、LG webOS、索尼Android TV内置浏览器）对HTML5的支持不是“全功能桌面级环境”，而是受限于系统Web运行时（如Tizen Web Runtime、webOS WebView、Chromium Embedded Framework），默认只允许部分HTML5 API在特定协议上下文中工作，且多数TV浏览器完全禁用 file:// 协议执行。直接双击打开本地HTML文件几乎必然失败——这不是bug，是安全规约。
为什么TV浏览器拒绝 file:// 协议下的HTML5媒体与API？
TV操作系统将本地文件系统视为不可信来源，禁止以下行为：
• video.src 指向本地MP4路径（即使同目录）
• fetch() 加载本地JSON或二进制资源
• importScripts() 在Web Worker中加载相对路径脚本
• MediaSource 或 WebGL 上下文在非HTTP(S)协议中初始化
这些限制由TV平台的WebView内核硬编码实现，无法通过用户标志（如Chrome的 --unsafely-treat-insecure-origin-as-secure）绕过。
必须用HTTP服务托管，且端口/路径有隐含限制
TV浏览器只接受明确的 http://（非HTTPS）地址，且常见限制包括：
• 仅允许 http://localhost 或局域网IP（如 http://192.168.1.100），拒绝 http://0.0.0.0 或未绑定主机名的地址
• 部分Tizen版本要求端口为 80、8080 或 3000，其他端口可能被防火墙拦截
• 路径不能含中文、空格或特殊字符（如 %20），否则Tizen会静默失败而不报错
python3 -m http.server 8080 --directory ./dist # 确保 ./dist/index.html 存在，且所有资源路径为相对路径（如 ./video.mp4）
访问时输入完整URL：http://192.168.1.100:8080/index.html（不要用localhost，TV设备不解析该主机名）
华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。
立即学习“前端免费学习笔记（深入）”；
HTML代码需主动适配TV浏览器能力断层
Tizen 6.5+ 和 webOS 6+ 支持 <video>，但不支持自动播放（autoplay）、静音播放（muted）或 playsinline；部分机型甚至不触发 canplay 事件。必须手动控制：
- 移除所有
autoplay、preload="auto"属性，改用用户点击后调用.play() -
<video>标签必须显式设置width和height（如width="1280" height="720"），否则渲染为空白 - 避免使用
MediaSource或WebRTC—— TV浏览器基本不支持 - 音频解码仅保证
mp3和aac，ogg或flac会静音或报错
调试时别依赖桌面Chrome DevTools模拟
TV浏览器的User-Agent和实际能力与桌面Chrome差异极大（例如：Tizen返回 Mozilla/5.0 (SMART-TV; Linux; Tizen 6.5) AppleWebKit/537.36，但缺失大量WebKit私有API）。真实调试必须：
- 启用Tizen Studio的Remote Debugging（USB连接后访问
http://[TV-IP]:8000） - 在webOS中使用
luna-send命令启动开发者模式并连接http://[TV-IP]:9000 - 日志中重点捕获
DOMException: The element has no supported sources（视频源不被识别）或TypeError: Cannot read property 'play' of null（video元素未挂载）
最常被忽略的一点：TV浏览器不会显示JavaScript错误弹窗，也不会在控制台打印跨域或协议错误——它只会让video黑屏、fetch静默失败、canvas不渲染。必须靠远程调试器逐行确认元素状态和网络请求是否发出。
