Agora Web API Reference
Hierarchy
- StreamPlayError
Index
Properties
Readonly reason
播放失败的原因。该值一般为触发播放失败的事件名，通常有以下几种：
- "stalled"：可能与浏览器播放策略相关。详见 stalled event。
- "pause"：可能由于用户点按了暂停键。详见 pause event。
- "suspend"：可能与浏览器播放策略相关。详见 suspend event。
- "canplay"：某些浏览器会自动停止被遮挡的播放器播放。详见 canplay event。
- "error"：一般是浏览器自动播放策略造成的播放失败。
由于不同浏览器的实现差异，对于同一行为，reason 可能出现不同的值。
Readonly status
播放器状态，通常有以下两种：
- "aborted"：播放器在开始播放之前就被移除
- "paused"：播放器处于停止状态
流播放错误信息
调用 Stream.play 方法播放音视频流失败时，可以通过该接口了解可能的原因。
通常情况下，除了 status 为 "aborted" 外，都可以引导用户尝试用手势触发恢复视频播放（调用 Stream.resume 方法）。