MediaElement (geckoview 69.0.20190611213319 API)

Object
- org.mozilla.geckoview.MediaElement

```
@AnyThread
public class MediaElement
extends Object
```
GeckoSession applications can use this class to handle media events and control the HTMLMediaElement externally.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`MediaElement.Delegate` This interface allows apps to handle media events.
`static class`	`MediaElement.LoadProgressInfo` Data class that indicates infomation about a media load progress event.
`static class`	`MediaElement.Metadata` Data class with the Metadata associated to a Media Element.

Field Summary

Fields
Modifier and Type	Field and Description
`protected MediaElement.Delegate`	`mDelegate`
`static int`	`MEDIA_ERROR_ABORTED` The fetching of the associated resource was aborted by the user's request.
`static int`	`MEDIA_ERROR_DECODE` Despite having previously been determined to be usable, an error occurred while trying to decode the media resource, resulting in an error.
`static int`	`MEDIA_ERROR_NETWORK` Some kind of network error occurred which prevented the media from being successfully fetched, despite having previously been available.
`static int`	`MEDIA_ERROR_NETWORK_NO_SOURCE` Media source not found or unable to select any of the child elements for playback during resource selection.
`static int`	`MEDIA_ERROR_SRC_NOT_SUPPORTED` The associated resource or media provider object has been found to be unsuitable.
`static int`	`MEDIA_READY_STATE_HAVE_CURRENT_DATA` Data is available for the current playback position, but not enough to actually play more than one frame.
`static int`	`MEDIA_READY_STATE_HAVE_ENOUGH_DATA` Enough data is available—and the download rate is high enough that the media can be played through to the end without interruption.
`static int`	`MEDIA_READY_STATE_HAVE_FUTURE_DATA` Data for the current playback position as well as for at least a little bit of time into the future is available.
`static int`	`MEDIA_READY_STATE_HAVE_METADATA` Enough of the media resource has been retrieved that the metadata attributes are available.
`static int`	`MEDIA_READY_STATE_HAVE_NOTHING` No information is available about the media resource.
`static int`	`MEDIA_STATE_ABORT` Sent when playback is aborted; for example, if the media is playing and is restarted from the beginning, this event is sent.
`static int`	`MEDIA_STATE_EMPTIED` The media has become empty.
`static int`	`MEDIA_STATE_ENDED` Sent when playback completes.
`static int`	`MEDIA_STATE_PAUSE` Sent when the playback state is changed to paused.
`static int`	`MEDIA_STATE_PLAY` The media is no longer paused, as a result of the play method, or the autoplay attribute.
`static int`	`MEDIA_STATE_PLAYING` Sent when the media has enough data to start playing, after the play event, but also when recovering from being stalled, when looping media restarts, and after seeked, if it was playing before seeking.
`static int`	`MEDIA_STATE_SEEKED` Sent when a seek operation completes.
`static int`	`MEDIA_STATE_SEEKING` Sent when a seek operation begins.
`static int`	`MEDIA_STATE_STALLED` Sent when the user agent is trying to fetch media data, but data is unexpectedly not forthcoming.
`static int`	`MEDIA_STATE_SUSPEND` Sent when loading of the media is suspended.
`static int`	`MEDIA_STATE_WAITING` Sent when the requested operation (such as playback) is delayed pending the completion of another operation (such as a seek).
`protected GeckoSession`	`mSession`
`protected long`	`mVideoId`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`MediaElement.Delegate`	`getDelegate()` Gets the current the media callback handler.
`void`	`pause()` Pauses the media.
`void`	`play()` Plays the media.
`void`	`seek(double time)` Seek the media to a given time.
`void`	`setDelegate(MediaElement.Delegate delegate)` Sets the media callback handler.
`void`	`setMuted(boolean muted)` Mutes the media.
`void`	`setPlaybackRate(double playbackRate)` Sets the playback rate at which the media will be played.
`void`	`setVolume(double volume)` Set the volume at which the media will be played.

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MEDIA_STATE_PLAY
```
public static final int MEDIA_STATE_PLAY
```
    The media is no longer paused, as a result of the play method, or the autoplay attribute.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_PLAYING
```
public static final int MEDIA_STATE_PLAYING
```
    Sent when the media has enough data to start playing, after the play event, but also when recovering from being stalled, when looping media restarts, and after seeked, if it was playing before seeking.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_PAUSE
```
public static final int MEDIA_STATE_PAUSE
```
    Sent when the playback state is changed to paused.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_ENDED
```
public static final int MEDIA_STATE_ENDED
```
    Sent when playback completes.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_SEEKING
```
public static final int MEDIA_STATE_SEEKING
```
    Sent when a seek operation begins.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_SEEKED
```
public static final int MEDIA_STATE_SEEKED
```
    Sent when a seek operation completes.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_STALLED
```
public static final int MEDIA_STATE_STALLED
```
    Sent when the user agent is trying to fetch media data, but data is unexpectedly not forthcoming.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_SUSPEND
```
public static final int MEDIA_STATE_SUSPEND
```
    Sent when loading of the media is suspended. This may happen either because the download has completed or because it has been paused for any other reason.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_WAITING
```
public static final int MEDIA_STATE_WAITING
```
    Sent when the requested operation (such as playback) is delayed pending the completion of another operation (such as a seek).
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_ABORT
```
public static final int MEDIA_STATE_ABORT
```
    Sent when playback is aborted; for example, if the media is playing and is restarted from the beginning, this event is sent.
    
    See Also:
    
    Constant Field Values
  - MEDIA_STATE_EMPTIED
```
public static final int MEDIA_STATE_EMPTIED
```
    The media has become empty. For example, this event is sent if the media has already been loaded, and the load() method is called to reload it.
    
    See Also:
    
    Constant Field Values
  - MEDIA_READY_STATE_HAVE_NOTHING
```
public static final int MEDIA_READY_STATE_HAVE_NOTHING
```
    No information is available about the media resource.
    
    See Also:
    
    Constant Field Values
  - MEDIA_READY_STATE_HAVE_METADATA
```
public static final int MEDIA_READY_STATE_HAVE_METADATA
```
    Enough of the media resource has been retrieved that the metadata attributes are available.
    
    See Also:
    
    Constant Field Values
  - MEDIA_READY_STATE_HAVE_CURRENT_DATA
```
public static final int MEDIA_READY_STATE_HAVE_CURRENT_DATA
```
    Data is available for the current playback position, but not enough to actually play more than one frame.
    
    See Also:
    
    Constant Field Values
  - MEDIA_READY_STATE_HAVE_FUTURE_DATA
```
public static final int MEDIA_READY_STATE_HAVE_FUTURE_DATA
```
    Data for the current playback position as well as for at least a little bit of time into the future is available.
    
    See Also:
    
    Constant Field Values
  - MEDIA_READY_STATE_HAVE_ENOUGH_DATA
```
public static final int MEDIA_READY_STATE_HAVE_ENOUGH_DATA
```
    Enough data is available—and the download rate is high enough that the media can be played through to the end without interruption.
    
    See Also:
    
    Constant Field Values
  - MEDIA_ERROR_NETWORK_NO_SOURCE
```
public static final int MEDIA_ERROR_NETWORK_NO_SOURCE
```
    Media source not found or unable to select any of the child elements for playback during resource selection.
    
    See Also:
    
    Constant Field Values
  - MEDIA_ERROR_ABORTED
```
public static final int MEDIA_ERROR_ABORTED
```
    The fetching of the associated resource was aborted by the user's request.
    
    See Also:
    
    Constant Field Values
  - MEDIA_ERROR_NETWORK
```
public static final int MEDIA_ERROR_NETWORK
```
    Some kind of network error occurred which prevented the media from being successfully fetched, despite having previously been available.
    
    See Also:
    
    Constant Field Values
  - MEDIA_ERROR_DECODE
```
public static final int MEDIA_ERROR_DECODE
```
    Despite having previously been determined to be usable, an error occurred while trying to decode the media resource, resulting in an error.
    
    See Also:
    
    Constant Field Values
  - MEDIA_ERROR_SRC_NOT_SUPPORTED
```
public static final int MEDIA_ERROR_SRC_NOT_SUPPORTED
```
    The associated resource or media provider object has been found to be unsuitable.
    
    See Also:
    
    Constant Field Values
  - mSession
```
@NonNull
protected final GeckoSession mSession
```
  - mVideoId
```
protected final long mVideoId
```
  - mDelegate
```
@Nullable
protected MediaElement.Delegate mDelegate
```
- Method Detail
  - getDelegate
```
@Nullable
public MediaElement.Delegate getDelegate()
```
    Gets the current the media callback handler.
    
    Returns:
    
    the current media callback handler.
  - setDelegate
```
public void setDelegate(@Nullable
                        MediaElement.Delegate delegate)
```
    Sets the media callback handler. This will replace the current handler.
    
    Parameters:
    
    delegate - An implementation of MediaDelegate.
  - pause
```
public void pause()
```
    Pauses the media.
  - play
```
public void play()
```
    Plays the media.
  - seek
```
public void seek(double time)
```
    Seek the media to a given time.
    
    Parameters:
    
    time - Seek time in seconds.
  - setVolume
```
public void setVolume(double volume)
```
    Set the volume at which the media will be played.
    
    Parameters:
    
    volume - A Volume value. It must fall between 0 and 1, where 0 is effectively muted and 1 is the loudest possible value.
  - setMuted
```
public void setMuted(boolean muted)
```
    Mutes the media.
    
    Parameters:
    
    muted - True in order to mute the audio.
  - setPlaybackRate
```
public void setPlaybackRate(double playbackRate)
```
    Sets the playback rate at which the media will be played.
    
    Parameters:
    
    playbackRate - The rate at which the media will be played. A value of 1.0 indicates normal speed.

Class MediaElement

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class Object

Field Detail

MEDIA_STATE_PLAY

MEDIA_STATE_PLAYING

MEDIA_STATE_PAUSE

MEDIA_STATE_ENDED

MEDIA_STATE_SEEKING

MEDIA_STATE_SEEKED

MEDIA_STATE_STALLED

MEDIA_STATE_SUSPEND

MEDIA_STATE_WAITING

MEDIA_STATE_ABORT

MEDIA_STATE_EMPTIED

MEDIA_READY_STATE_HAVE_NOTHING

MEDIA_READY_STATE_HAVE_METADATA

MEDIA_READY_STATE_HAVE_CURRENT_DATA

MEDIA_READY_STATE_HAVE_FUTURE_DATA

MEDIA_READY_STATE_HAVE_ENOUGH_DATA

MEDIA_ERROR_NETWORK_NO_SOURCE

MEDIA_ERROR_ABORTED

MEDIA_ERROR_NETWORK

MEDIA_ERROR_DECODE

MEDIA_ERROR_SRC_NOT_SUPPORTED

mSession

mVideoId

mDelegate

Method Detail

getDelegate

setDelegate

pause

play

seek

setVolume

setMuted

setPlaybackRate