# API You can initialize the player by calling `ÌndigoPlayer.init(domElement, container)`, and the **return value** is a player object, which you can use to interact with the player or listen to events. ## Methods Use the following methods to instruct the player to do an action.

Method	Arguments	Description
Actions
`player.play()`		The player will start playing the content (or ads)
`player.pause()`		Pauses content (or ads)
`player.seekTo(time)`	time: number	Seeks to a time in the content
`player.setVolume(volume)`	volume: number between 0 and 1	Seeks to a time in the content
`player.setError(error)`	error: PlayerError	Triggers a fatal error.
`player.destroy()`		Destroys the player entirely, the original DOM container is put back in place and can be reused.
Events
`player.on(name, callback)`	name: string callback: function	Registers an event listener for a given event.
`player.once(name, callback)`	name: string callback: function	Registers an event listener for a given event, but it gets removed once it's triggered once.
`player.removeListener(name, callback)`	name: string callback: function	Removes a previously registered event listener.
`player.emit(name, data)`	name: string data: object	Emits an event to all the registered event listeners.
Misc
`player.getStats()`		Returns an object with all the loaded modules (controller, media, player and extensions)
`player.getModule(name)`	name: string	Returns a module by the given name.

## Events The player emits a lot of events. Most events are used for development purposes. The ones listed here are related to the state of the player and the events that get triggered when the state changes. State events are standardized events across the different modules. All events are available in `IndigoPlayer.Events.`.

Event	Parameters	Description
State
`STATE_CHANGE`	state: State prevState: State	Whenever the state changes, this event is triggered. The state argument is immutable, this is great for UI's like React.
`STATE_READY`		The player is ready.
`STATE_PLAY_REQUESTED`		Playback has been requested (for content or ads), can be by a user click / tap or by autoplay.
`STATE_PLAYING`		The video (content or ads) is actually playing.
`STATE_PAUSED`		The video (content or ads) is paused.
`STATE_CURRENTTIME_CHANGE`		The current time (content or ads) has changed.
`STATE_BUFFERING`		The video is buffering (or rebuffering).
`STATE_ADBREAKS`	adBreaks: Array	An ad provider has provided a list of ads.
`STATE_ADBREAK_STARTED`	adBreak: AdBreak	The given ad break has started.
`STATE_AD_STARTED`	ad: Ad	An ad inside an ad break has started.
`STATE_AD_ENDED`	ad: Ad	An ad inside an ad break has ended.
`STATE_ADBREAK_ENDED`	adBreak - AdBreak	The ad break has ended.
`STATE_ENDED`		The video has ended.
`STATE_ERROR`	error - PlayerError	An unrecoverable error occured.
`STATE_VOLUME_CHANGE`	volume - number	The volume has changed.
`STATE_DURATION_CHANGE`	duration - number	The duration has changed.
`STATE_FULLSCREEN_SUPPORTED`	fullscreenSupported - boolean	The native fullscreen API is supported.
`STATE_FULLSCREEN_CHANGE`	fullscreen - boolean	The fullscreen state has changed.
`STATE_TRACKS`	tracks: Array	Media has provided several quality tracks.
`STATE_TRACK_CHANGE`	track: Track	A current quality track has been changed.
`STATE_SUBTITLE_CHANGE`	subtitle: Subtitle	An active subtitle has been changed.
`STATE_PLAYBACKRATE_CHANGE`	playbackRate: number	The current playback rate has been changed.
`STATE_PIP_CHANGE`	pip: boolean	Picture-in-Picture mode has either been enabled or disabled.
UI
`UI_VISIBLECONTROLS_CHANGE`	visibleControls: boolean	The controls are made visible or not.