Docs
ReferenceProperties

Properties

Read-only properties exposed by the Moviie Player API.

The tables below cover every read-only property on window.Moviie. They mirror the fields returned by getState() and are kept in lockstep with the underlying media element.

Prefer getState() for atomic reads

Reading individual properties is convenient for one-off checks. When you need a coherent snapshot of multiple fields at the same instant, prefer getState() — it serialises the whole state in a single read.

Time

PropertyTypeDescription
currentTimenumberCurrent playback position in seconds.
durationnumberTotal duration of the video in seconds. May be `0` until metadata loads.
bufferednumberFurthest buffered position in seconds.
playednumberFurthest position the viewer has actually played, in seconds.

State

PropertyTypeDescription
pausedboolean`true` when the player is paused or has not started yet.
endedboolean`true` when playback has reached the end of the video.
seekingboolean`true` while a seek operation is in progress.
waitingboolean`true` while the player is waiting for more data to continue playback.
readyboolean`true` once the `ready` event has fired. Use this to gate any code that depends on the player being initialised.

Volume

PropertyTypeDescription
volumenumberCurrent volume level in `[0, 1]`. Independent from `muted`.
mutedboolean`true` when audio is muted, regardless of the volume level.

Display

PropertyTypeDescription
fullscreenboolean`true` while the player is in fullscreen mode.
pipboolean`true` while the player is in Picture-in-Picture mode.

Playback

PropertyTypeDescription
playbackRatenumberCurrent playback speed multiplier (default `1`).
playbackQualitystring | nullCurrently selected video quality (e.g. `'1080p'`). `null` while the adaptive bitrate is still negotiating.
availableQualitiesstring[]List of qualities the viewer can switch to.

Media

PropertyTypeDescription
videoWidthnumberIntrinsic width of the source video in pixels.
videoHeightnumberIntrinsic height of the source video in pixels.

Versioning

PropertyTypeDescription
versionstringPlayer API version exposed at runtime — matches `PLAYER_API_VERSION`.

On this page