Media

java.lang.Object
- javafx.scene.media.Media

```
public final class Media
extends java.lang.Object
```
The Media class represents a media resource. It is instantiated from the string form of a source URI. Information about the media such as duration, metadata, tracks, and video resolution may be obtained from a Media instance. The media information is obtained asynchronously and so not necessarily available immediately after instantiation of the class. All information should however be available if the instance has been associated with a MediaPlayer and that player has transitioned to MediaPlayer.Status.READY status. To be notified when metadata or Tracks are added, observers may be registered with the collections returned by getMetadata()and getTracks(), respectively.
The same Media object may be shared among multiple MediaPlayer objects. Such a shared instance might manage a single copy of the source media data to be used by all players, or it might require a separate copy of the data for each player. The choice of implementation will not however have any effect on player behavior at the interface level.

Since:

JavaFX 2.0

See Also:

MediaPlayer, MediaException

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`<any>`	`duration` The duration in seconds of the source media.
`<any>`	`error` A property set to a MediaException value when an error occurs.
`ReadOnlyIntegerProperty`	`height` The height in pixels of the source media.
`<any>`	`onError` Event handler called when an error occurs.
`ReadOnlyIntegerProperty`	`width` The width in pixels of the source media.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

private class Media._MetadataListener

private class Media.InitLocator

Nested Classes
Modifier and Type	Class and Description
`private class`	`Media._MetadataListener`
`private class`	`Media.InitLocator`

Field Summary

Fields
Modifier and Type	Field and Description
`private <any>`	`duration` The duration in seconds of the source media.
`private <any>`	`error` A property set to a MediaException value when an error occurs.
`private ReadOnlyIntegerWrapper`	`height` The height in pixels of the source media.
`private Locator`	`jfxLocator` Locator used by the jfxmedia player, MediaPlayer needs access to this
`private MetadataParser`	`jfxParser`
`private <any>`	`markers` The markers defined on this media source.
`private <any>`	`metadata` An `ObservableMap` of metadata which can contain information about the media.
`private <any>`	`metadataBacking`
`private MetadataListener`	`metadataListener`
`private <any>`	`onError` Event handler called when an error occurs.
`private java.lang.String`	`source` The source URI of the media;
`private <any>`	`tracks` An `ObservableList` of tracks contained in this media object.
`private <any>`	`tracksBacking`
`private ReadOnlyIntegerWrapper`	`width` The width in pixels of the source media.

Constructor Summary

Constructors
Constructor and Description

Media(java.lang.String source)
Constructs a Media instance.

Constructors
Constructor and Description
`Media(java.lang.String source)` Constructs a `Media` instance.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`(package private) void`	`_setError(MediaException.Type type, java.lang.String message)`
`(package private) void`	`_updateMedia(com.sun.media.jfxmedia.Media _media)`
`<any>`	`durationProperty()` The duration in seconds of the source media.
`private <any>`	`durationPropertyImpl()`
`<any>`	`errorProperty()` A property set to a MediaException value when an error occurs.
`private <any>`	`errorPropertyImpl()`
`Duration`	`getDuration()` Retrieve the duration in seconds of the media.
`MediaException`	`getError()` Return any error encountered in the media.
`int`	`getHeight()` Retrieve the height in pixels of the media.
`<any>`	`getMarkers()` Retrieve the markers defined on this `Media` instance.
`<any>`	`getMetadata()` Retrieve the metadata contained in this media source.
`java.lang.Runnable`	`getOnError()` Retrieve the error handler to be called if an error occurs.
`java.lang.String`	`getSource()` Retrieve the source URI of the media.
`<any>`	`getTracks()` Retrieve the tracks contained in this media source.
`private Track`	`getTrackWithID(long trackID)`
`int`	`getWidth()` Retrieve the width in pixels of the media.
`ReadOnlyIntegerProperty`	`heightProperty()` The height in pixels of the source media.
`private ReadOnlyIntegerWrapper`	`heightPropertyImpl()`
`<any>`	`onErrorProperty()` Event handler called when an error occurs.
`(package private) Locator`	`retrieveJfxLocator()`
`private void`	`runMetadataParser()`
`(package private) void`	`setDuration(Duration value)`
`private void`	`setError(MediaException value)`
`(package private) void`	`setHeight(int value)`
`void`	`setOnError(java.lang.Runnable value)` Set the event handler to be called when an error occurs.
`(package private) void`	`setWidth(int value)`
`private void`	`updateMetadata(java.util.Map<java.lang.String,java.lang.Object> metadata)`
`ReadOnlyIntegerProperty`	`widthProperty()` The width in pixels of the source media.
`private ReadOnlyIntegerWrapper`	`widthPropertyImpl()`

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

- Property Detail
  - error
```
public <any> errorProperty
```
    A property set to a MediaException value when an error occurs. If error is non-null, then the media could not be loaded and is not usable. If onError is non-null, it will be invoked when the error property is set.
    
    See Also:
    
    getError()
  - onError
```
public <any> onErrorProperty
```
    Event handler called when an error occurs. This will happen if a malformed or invalid URL is passed to the constructor or there is a problem accessing the URL.
    
    See Also:
    
    getOnError(), setOnError(Runnable)
  - width
```
public ReadOnlyIntegerProperty widthProperty
```
    The width in pixels of the source media. This may be zero if the media has no width, e.g., when playing audio, or if the width is currently unknown which may occur with streaming media.
    
    See Also:
    
    getWidth()
  - height
```
public ReadOnlyIntegerProperty heightProperty
```
    The height in pixels of the source media. This may be zero if the media has no height, e.g., when playing audio, or if the height is currently unknown which may occur with streaming media.
    
    See Also:
    
    getHeight()
  - duration
```
public <any> durationProperty
```
    The duration in seconds of the source media. If the media duration is unknown then this property value will be Duration#UNKNOWN.
    
    See Also:
    
    getDuration()
- Field Detail
  - error
```
private <any> error
```
    A property set to a MediaException value when an error occurs. If error is non-null, then the media could not be loaded and is not usable. If onError is non-null, it will be invoked when the error property is set.
    
    See Also:
    
    MediaException
  - onError
```
private <any> onError
```
    Event handler called when an error occurs. This will happen if a malformed or invalid URL is passed to the constructor or there is a problem accessing the URL.
  - metadataListener
```
private MetadataListener metadataListener
```
  - metadata
```
private <any> metadata
```
    An ObservableMap of metadata which can contain information about the media. Metadata entries use Strings for keys and contain Object values. This map is unmodifiable: its contents or stored values cannot be changed.
  - metadataBacking
```
private final <any> metadataBacking
```
  - width
```
private ReadOnlyIntegerWrapper width
```
    The width in pixels of the source media. This may be zero if the media has no width, e.g., when playing audio, or if the width is currently unknown which may occur with streaming media.
    
    See Also:
    
    height
  - height
```
private ReadOnlyIntegerWrapper height
```
    The height in pixels of the source media. This may be zero if the media has no height, e.g., when playing audio, or if the height is currently unknown which may occur with streaming media.
    
    See Also:
    
    width
  - duration
```
private <any> duration
```
    The duration in seconds of the source media. If the media duration is unknown then this property value will be Duration#UNKNOWN.
  - tracks
```
private <any> tracks
```
    An ObservableList of tracks contained in this media object. A Media object can contain multiple tracks, such as a video track with several audio track. This list is unmodifiable: the contents cannot be changed.
    
    See Also:
    
    Track
  - tracksBacking
```
private final <any> tracksBacking
```
  - markers
```
private <any> markers
```
    The markers defined on this media source. A marker is defined to be a mapping from a name to a point in time between the beginning and end of the media.
  - source
```
private final java.lang.String source
```
    The source URI of the media;
  - jfxLocator
```
private final Locator jfxLocator
```
    Locator used by the jfxmedia player, MediaPlayer needs access to this
  - jfxParser
```
private MetadataParser jfxParser
```
- Constructor Detail
  - Media
```
public Media(java.lang.String source)
```
    Constructs a Media instance. This is the only way to specify the media source. The source must represent a valid URI and is immutable. Only HTTP, HTTPS, FILE, and JAR URLs are supported. If the provided URL is invalid then an exception will be thrown. If an asynchronous error occurs, the error property will be set. Listen to this property to be notified of any such errors.
    If the source uses a non-blocking protocol such as FILE, then any problems which can be detected immediately will cause a MediaException to be thrown. Such problems include the media being inaccessible or in an unsupported format. If however a potentially blocking protocol such as HTTP is used, then the connection will be initialized asynchronously so that these sorts of errors will be signaled by setting the error property.
    
    Constraints:
    - The supplied URI must conform to RFC-2396 as required by java.net.URI.
    - Only HTTP, HTTPS, FILE, and JAR URIs are supported.
    See java.net.URI for more information about URI formatting in general. JAR URL syntax is specified in java.net.JarURLConnection.
    Parameters:
    
    source - The URI of the source media.
    
    Throws:
    
    java.lang.NullPointerException - if the URI string is null.
    
    java.lang.IllegalArgumentException - if the URI string does not conform to RFC-2396 or, if appropriate, the Jar URL specification, or is in a non-compliant form which cannot be modified to a compliant form.
    
    java.lang.IllegalArgumentException - if the URI string has a null scheme.
    
    java.lang.UnsupportedOperationException - if the protocol specified for the source is not supported.
    
    MediaException - if the media source cannot be connected (type MediaException.Type.MEDIA_INACCESSIBLE) or is not supported (type MediaException.Type.MEDIA_UNSUPPORTED).
- Method Detail
  - setError
```
private void setError(MediaException value)
```
  - getError
```
public final MediaException getError()
```
    Return any error encountered in the media.
    
    Returns:
    
    a MediaException or null if there is no error.
  - errorProperty
```
public <any> errorProperty()
```
    A property set to a MediaException value when an error occurs. If error is non-null, then the media could not be loaded and is not usable. If onError is non-null, it will be invoked when the error property is set.
    
    See Also:
    
    getError()
  - errorPropertyImpl
```
private <any> errorPropertyImpl()
```
  - setOnError
```
public final void setOnError(java.lang.Runnable value)
```
    Set the event handler to be called when an error occurs.
    
    Parameters:
    
    value - the error event handler.
  - getOnError
```
public final java.lang.Runnable getOnError()
```
    Retrieve the error handler to be called if an error occurs.
    
    Returns:
    
    the error handler or null if none is defined.
  - onErrorProperty
```
public <any> onErrorProperty()
```
    Event handler called when an error occurs. This will happen if a malformed or invalid URL is passed to the constructor or there is a problem accessing the URL.
    
    See Also:
    
    getOnError(), setOnError(Runnable)
  - getMetadata
```
public final <any> getMetadata()
```
    Retrieve the metadata contained in this media source. If there are no metadata, the returned ObservableMap will be empty.
    
    Returns:
    
    the metadata contained in this media source.
  - setWidth
```
final void setWidth(int value)
```
  - getWidth
```
public final int getWidth()
```
    Retrieve the width in pixels of the media.
    
    Returns:
    
    the media width or zero if the width is undefined or unknown.
  - widthProperty
```
public ReadOnlyIntegerProperty widthProperty()
```
    The width in pixels of the source media. This may be zero if the media has no width, e.g., when playing audio, or if the width is currently unknown which may occur with streaming media.
    
    See Also:
    
    getWidth()
  - widthPropertyImpl
```
private ReadOnlyIntegerWrapper widthPropertyImpl()
```
  - setHeight
```
final void setHeight(int value)
```
  - getHeight
```
public final int getHeight()
```
    Retrieve the height in pixels of the media.
    
    Returns:
    
    the media height or zero if the height is undefined or unknown.
  - heightProperty
```
public ReadOnlyIntegerProperty heightProperty()
```
    The height in pixels of the source media. This may be zero if the media has no height, e.g., when playing audio, or if the height is currently unknown which may occur with streaming media.
    
    See Also:
    
    getHeight()
  - heightPropertyImpl
```
private ReadOnlyIntegerWrapper heightPropertyImpl()
```
  - setDuration
```
final void setDuration(Duration value)
```
  - getDuration
```
public final Duration getDuration()
```
    Retrieve the duration in seconds of the media.
    
    Returns:
    
    the duration of the media, Duration#UNKNOWN if unknown or Duration#INDEFINITE for live streams
  - durationProperty
```
public <any> durationProperty()
```
    The duration in seconds of the source media. If the media duration is unknown then this property value will be Duration#UNKNOWN.
    
    See Also:
    
    getDuration()
  - durationPropertyImpl
```
private <any> durationPropertyImpl()
```
  - getTracks
```
public final <any> getTracks()
```
    Retrieve the tracks contained in this media source. If there are no tracks, the returned ObservableList will be empty.
    
    Returns:
    
    the tracks contained in this media source.
  - getMarkers
```
public final <any> getMarkers()
```
    Retrieve the markers defined on this Media instance. If there are no markers the returned ObservableMap will be empty. Programmatic markers may be added by inserting entries in the returned Map.
    
    Returns:
    
    the markers defined on this media source.
  - runMetadataParser
```
private void runMetadataParser()
```
  - getSource
```
public java.lang.String getSource()
```
    Retrieve the source URI of the media.
    
    Returns:
    
    the media source URI as a String.
  - retrieveJfxLocator
```
Locator retrieveJfxLocator()
```
  - getTrackWithID
```
private Track getTrackWithID(long trackID)
```
  - _updateMedia
```
void _updateMedia(com.sun.media.jfxmedia.Media _media)
```
  - _setError
```
void _setError(MediaException.Type type,
               java.lang.String message)
```
  - updateMetadata
```
private void updateMetadata(java.util.Map<java.lang.String,java.lang.Object> metadata)
```

Class Media

Property Summary

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Property Detail

error

onError

width

height

duration

Field Detail

error

onError

metadataListener

metadata

metadataBacking

width

height

duration

tracks

tracksBacking

markers

source

jfxLocator

jfxParser

Constructor Detail

Media

Method Detail

setError

getError

errorProperty

errorPropertyImpl

setOnError

getOnError

onErrorProperty

getMetadata

setWidth

getWidth

widthProperty

widthPropertyImpl

setHeight

getHeight

heightProperty

heightPropertyImpl

setDuration

getDuration

durationProperty

durationPropertyImpl

getTracks

getMarkers

runMetadataParser

getSource

retrieveJfxLocator

getTrackWithID

_updateMedia

_setError

updateMetadata