# AgoraRtePlayerEvent (/zh-CN/api-reference/rtc/ios/enum-rteplayerevent)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="enum_rteplayerevent__detailed_desc"></a>

:::info[自从]
自 v4.4.0 版本新增。
:::

<a id="enum_rteplayerevent__parameters"></a>

## 枚举值 [#枚举值]

<ParameterList>
<a id="agorarteplayereventseekbegin"></a>
<Parameter name="AgoraRtePlayerEventSeekBegin">

（0）：开始跳转到指定位置播放。

</Parameter>
<a id="agorarteplayereventseekcomplete"></a>
<Parameter name="AgoraRtePlayerEventSeekComplete">

（1）：跳转到指定位置完成。

</Parameter>
<a id="agorarteplayereventseekerror"></a>
<Parameter name="AgoraRtePlayerEventSeekError">

（2）：跳转到指定位置时发生错误。

</Parameter>
<a id="agorarteplayereventbufferlow"></a>
<Parameter name="AgoraRtePlayerEventBufferLow">

（3）：当前缓冲数据不足，无法继续播放。

</Parameter>
<a id="agorarteplayereventbufferrecover"></a>
<Parameter name="AgoraRtePlayerEventBufferRecover">

（4）：当前缓冲数据已恢复，可继续播放。

</Parameter>
<a id="agorarteplayereventfreezestart"></a>
<Parameter name="AgoraRtePlayerEventFreezeStart">

（5）：音频或视频发生卡顿。

</Parameter>
<a id="agorarteplayereventfreezestop"></a>
<Parameter name="AgoraRtePlayerEventFreezeStop">

（6）：音频或视频卡顿结束。

</Parameter>
<a id="agorarteplayereventoneloopplaybackcompleted"></a>
<Parameter name="AgoraRtePlayerEventOneLoopPlaybackCompleted">

（7）：完成一次循环播放。

</Parameter>
<a id="agorarteplayereventauthenticationwillexpire"></a>
<Parameter name="AgoraRtePlayerEventAuthenticationWillExpire">

（8）：Token 即将过期。收到该事件后需生成新的 Token，并通过 [openWithUrl\:startTime\:cb:](/zh-CN/api-reference/rtc/ios/play/rte-player#api_player_openwithurl) 更新 URL。

</Parameter>
<a id="agorarteplayereventabrfallbacktoaudioonlylayer"></a>
<Parameter name="AgoraRtePlayerEventAbrFallbackToAudioOnlyLayer">

（9）：因网络问题，从接收音视频流降级为仅接收远端音频流。

</Parameter>
<a id="agorarteplayereventabrrecoverfromaudioonlylayer"></a>
<Parameter name="AgoraRtePlayerEventAbrRecoverFromAudioOnlyLayer">

（10）：网络恢复后，从仅接收远端音频流恢复为接收音视频流。

</Parameter>
<a id="agorarteplayereventswitchbegin"></a>
<Parameter name="AgoraRtePlayerEventSwitchBegin">

（11）：开始切换到新 URL。

</Parameter>
<a id="agorarteplayereventswitchcomplete"></a>
<Parameter name="AgoraRtePlayerEventSwitchComplete">

（12）：切换到新 URL 完成。

</Parameter>
<a id="agorarteplayereventswitcherror"></a>
<Parameter name="AgoraRtePlayerEventSwitchError">

（13）：切换到新 URL 时发生错误。

</Parameter>
<a id="agorarteplayereventfirstdisplayed"></a>
<Parameter name="AgoraRtePlayerEventFirstDisplayed">

（14）：首帧视频已显示。

</Parameter>
<a id="agorarteplayereventreachcachefilemaxcount"></a>
<Parameter name="AgoraRtePlayerEventReachCacheFileMaxCount">

（15）：缓存文件数量达到上限。

</Parameter>
<a id="agorarteplayereventreachcachefilemaxsize"></a>
<Parameter name="AgoraRtePlayerEventReachCacheFileMaxSize">

（16）：缓存文件大小达到上限。

</Parameter>
<a id="agorarteplayereventtryopenstart"></a>
<Parameter name="AgoraRtePlayerEventTryOpenStart">

（17）：开始尝试打开新 URL。

</Parameter>
<a id="agorarteplayereventtryopensucceed"></a>
<Parameter name="AgoraRtePlayerEventTryOpenSucceed">

（18）：成功打开新 URL。

</Parameter>
<a id="agorarteplayereventtryopenfailed"></a>
<Parameter name="AgoraRtePlayerEventTryOpenFailed">

（19）：打开新 URL 失败。

</Parameter>
<a id="agorarteplayereventaudiotrackchanged"></a>
<Parameter name="AgoraRtePlayerEventAudioTrackChanged">

（20）：当前音轨已切换。

</Parameter>
</ParameterList>