不可用与失败

不可用与失败

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

本栏回应什么问题

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

适合：编写状态提示的产品人员、网页开发初学者和自学读者

学习步骤

  1. 未上传媒体：显示“本节暂未提供视频，可阅读文字稿”，不放假播放按钮。仅自动播放受限：显示“自动播放未开始，请选择播放”，保留用户手动播放入口。
  2. 格式不支持时可提示“当前环境无法播放此媒体”，提供确实存在的文字版。重试按钮只在应用能发起新请求时出现；重试失败应退出忙碌态，避免永久转圈。

常见误区

  • 把权限限制写成文件损坏
  • 提供未接通的重试动作

本栏学习卡片

相关指南

常见问题

没有视频时该放什么按钮？

明确显示“本节暂未提供视频”。仅链接实际存在的文字稿或练习；没有媒体时不放可点击的假播放按钮，也不显示永久加载。

阅读相关指南