理解一个具体问题

不可用与失败：只说明已知原因

没有配置视频、播放请求受限、媒体加载出错是不同问题。提示应写明已知状态，给出真实可用的下一步，未知根因保留未知。

未核验
不可用与失败：只说明已知原因的关键字段
学习编号 LEARN-003
核心问题 不可用与失败：只说明已知原因
分类 不可用与失败
材料性质 本站原创教学卡；案例为非露骨虚构情境，状态文案是设计示例。

判断依据

先查业务状态是否提供媒体，再查 play() 拒绝与媒体 error。NotAllowedError 不应写成视频损坏；MediaError 的宽泛分类也不足以证明某个 CDN、用户设备或网络运营商出错。

虚构文案案例

未上传媒体：显示“本节暂未提供视频，可阅读文字稿”，不放假播放按钮。仅自动播放受限：显示“自动播放未开始，请选择播放”，保留用户手动播放入口。

核对动作

格式不支持时可提示“当前环境无法播放此媒体”，提供确实存在的文字版。重试按钮只在应用能发起新请求时出现；重试失败应退出忙碌态，避免永久转圈。

适用范围

适合

  • 编写播放器提示的产品与内容人员
  • 学习媒体状态的网页开发初学者

不适合

  • 仅凭页面状态诊断具体网络故障
  • 将视频播放完成作为知识掌握证明

继续阅读对应指南

接下来可以看

数据透明度

来源与核验状态

未核验
  • MDN：play() 的成功与拒绝 已核验
    发布方
    MDN Web Docs
    访问日期
    2026-09-11
    支持字段
    播放请求返回 Promise，可能因权限或格式被拒绝；不证明点击后立即播放
    查看来源
  • MDN：媒体错误代码 已核验
    发布方
    MDN Web Docs
    访问日期
    2026-09-11
    支持字段
    中止、网络、解码和不支持来源四类错误；不是精确的服务器诊断
    查看来源