media session api 是让网页媒体注册为系统级媒体源的接口，可控制锁屏、通知栏、耳机按键等处的标题、艺术家、专辑图及播放/暂停/跳过等操作。
Media Session API 是什么，它能控制哪些通知栏内容
Media Session API 不是给网页加个播放器 UI 的工具，它是让浏览器把你的网页媒体（audio 或 video 元素）“注册”为系统级媒体源，从而让操作系统在锁屏、通知栏、耳机物理按键、键盘多媒体键等场景下，能正确显示标题、艺术家、专辑图，并响应播放/暂停/跳过等操作。它不控制网页内 DOM，只影响系统层媒体控件。
关键点：必须有正在播放的媒体（play() 被调用且未被阻止），否则系统会忽略 mediaSession 设置；Chrome / Edge / Safari（有限）支持，Firefox 尚未实现 setActionHandler。
设置 metadata 信息（标题、作者、封面图）
通过 mediaSession.metadata 设置，但注意：封面图 src 必须是 HTTPS 地址，且建议尺寸 ≥ 512×512 像素，否则 Android 可能降级显示为默认图标；title 和 artist 是纯文本，不支持 HTML 或换行。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
navigator.mediaSession.metadata = new MediaMetadata({ title: "夜曲", artist: "周杰伦", album: "十一月的萧邦", artwork: [{ src: "https://example.com/cover.jpg", sizes: "512x512", type: "image/jpeg" }] });- 如果只设部分字段（比如漏掉
artist），对应位置在通知栏中会留空或显示“未知” - 修改
metadata后不会自动刷新通知栏 —— 必须触发一次播放状态变化（如play()→pause()→play()）或等待系统轮询（延迟不可控），所以实际中建议在play事件后立即赋值
绑定播放控制操作（play/pause/seek 等）
用 mediaSession.setActionHandler() 注册回调，但不是所有 action 都被所有平台支持。Android 支持 "play"、"pause"、"nexttrack"、"previoustrack"；桌面 Chrome 还支持 "seekto" 和 "seekforward"；Safari 目前仅支持 "play" 和 "pause"。
- 必须在用户手势（如 click、keydown）触发的上下文中首次调用
play()，否则setActionHandler会被忽略（SecurityError） - 示例：
navigator.mediaSession.setActionHandler("play", () => audio.play().catch(e => console.warn("play failed:", e))); - 不要在 handler 里直接修改
currentTime后立刻调用play()—— 某些 Android 版本会因状态竞争导致暂停后无法恢复，应先pause()，再改currentTime，再play()
常见失败原因和绕过技巧
最常遇到的是“通知栏没反应”或“按钮点了没回调”，基本都卡在这几个环节：
- 媒体元素没真正开始播放：检查是否被自动播放策略拦截（
audio.play()返回 Promise 并 reject？需捕获错误并引导用户点击启动） - HTTPS 缺失：本地
file://或 HTTP 页面完全不生效，必须部署在 HTTPS 环境 - metadata 赋值太早：在
loadstart甚至canplay阶段设可能无效，稳妥做法是在playing事件中设置 - 图标跨域问题：即使 URL 是 HTTPS，若服务器没返回
Access-Control-Allow-Origin: *，封面图会加载失败，通知栏显示空白 —— 可用img标签预加载并检查onerror来提前发现
真要兼容旧版 Android 或 Firefox，只能退回到用 document.title + 自定义通知（Notification API）模拟，但无法响应物理按键。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
