Player states

The player state, that you can obtain either with the getPlayerState method or through the playerStateChange player event, is a central part of our API: it is from this value that you will know:

• when a new content finished loading
• when the content is paused to build buffer
• when the content is ended
• as a generality, in what “state” is the player currently

As such, it is important this concept is understood when developping with the rx-player, which is exactly the point of this page.

List of possible states

Today the player can have one of these 9 possible states:

• STOPPED
• LOADING
• LOADED
• PLAYING
• PAUSED
• BUFFERING
• SEEKING
• ENDED
• RELOADING

The STOPPED state

STOPPED is the default state of the player. It indicates that no content is playing.

To simplify state exploitation, STOPPED is also emitted as a transition state when loading a new content while another one was currently loaded (or loading). That way, you can just listen to the STOPPED state to know when the current content is not loaded anymore.

When the player encounters an error, it will also stop and switch to the STOPPED state.

The LOADING state

The LOADING state indicates that a new content is currently loading. It appears only after the STOPPED state.

That means that the player is currently downloading enough of the content to be able to play it.

While this state is active, most of the content-related APIs (like setAudioTrack) are not available. You have to wait for the LOADED state for that.

The LOADED state

LOADED appears only after a LOADING state, and indicates that the current content can now be played.

From this point onward, most of the content-related APIs (like setAudioTrack) are now available.

If the autoPlay loadVideo option has been set to true, the state will then switch to PLAYING directly. Else, the player will usually be paused and stay in the LOADED state (there is some edge cases, see the “Possible state transitions” chapter for more information).

The PLAYING state

Indicates that the player is currently playing the content.

The PAUSED state

Indicates that the player is currently paused in the content.

The BUFFERING state

The content is paused because it needs to build buffer.

The player will not play until it gets out of this state.

The SEEKING state

The content is paused because it needs to build buffer after seeking in the content (this can be seen as a special BUFFERING case).

The player will not play until it gets out of this state.

The ENDED state

The player reached the end of the content.

If the stopAtEnd player option has been set to true or not set, the player will immediately stop the content. In that case, the ENDED state can be considered like the STOPPED state - in terms of what you can do.

Else, it should now be paused at the last frame if a video content is available at this time and this state acts like what you can expect from HTML5 playback:

• when seeking when the content is ended, you will be paused (even if you were playing before)

• after calling play, you will play back from the beginning

The RELOADING state

This state indicates that the player needs to “re-load” then content.

This can happen for different reasons:

• When you switch the video track for another one, when the previous one was currently decoding.

• When you update manually the audio and video bitrate through respectively the setAudioBitrate and setVideoBitrate APIs (Only if you set the manualBitrateSwitchingMode loadVideo option to "direct").

• When the current audio or video codec changes and you had set the onCodecSwitch loadVideo option to "reload".

In those cases, we need to stop and reload the content on the browser-side, due to browser limitation.

While this state is active, multiple player API are unavailable:

• you cannot play or pause
• you cannot seek
• you cannot obtain the position or duration
• you cannot get or switch the available video, text or audio tracks.
• you cannot get or switch the available video or audio bitrates.

This is why we sometime recommend to manage this state as if it was the LOADING state (where those APIs - and other - are also not available).

However, the player won’t go to the LOADED state after RELOADING, you will instead know that it had finished reloading simply when it goes out of this state.