options.url: an absolute path to a SMIL file

Load the file (but don't start playback yet).

src: a text document URL, optionally including a fragment identifier

TODO will this be absolute or relative? Or should we try to accommodate both?

Returns the node object containing that src, or null.

node: a SMIL node to start playback from

Used for initializing SMIL playback. To start at a specific point, use findNodeByTextSrc to find the node, and then pass it to this function. If node is null, then playback will start at the beginning of the file.

Pause the audio

Resume the audio

Escape the current structure. If the current structure's epub:type value is not in the list of types which may be escaped, then this command is ignored and normal playback continues.

Add an epub:type value to the list of items which must be skipped by the player.

Remove an epub:type value from the list of items which must be skipped by the player.

Add an epub:type value to the list of items which may be escaped by the user.

Remove an epub:type value from the list of items which may be escaped by the user.

string

Base URL portion of the text src of the active SMIL text node (i.e. without the fragment identifier).

TODO: should this be absolute or relative? It will be relative in the SMIL file itself; should we resolve it before broadcasting?

string

Fragment identifier portion of the text src of the active SMIL text node. Could also be an empty string if not in use.

boolean

Indicates that the file is loaded and ready to play.

boolean

Indicates whether audio is playing or not.

boolean

Default: true

Indicates whether the text should be highlighted or not. This is purely a user preference which is not changed internally by the Media Overlays player.

boolean

Indicates that playback of the file has completed.

boolean

Indicates that the currently-playing structure may be escaped by the user.