Media (JavaFX 8)

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

```
public final class Media
extends Object
```
Mediaクラスは、メディア・リソースを表します。これは、文字列形式のソースURIからインスタンス化されます。期間、メタデータ、トラックおよびビデオ解像度などのメディアに関する情報は、Mediaインスタンスから取得できます。メディア情報は非同期に取得されるため、必ずしもクラスをインスタンス化した直後に使用可能になるとはかぎりません。ただし、インスタンスがMediaPlayerに関連付けられ、プレイヤのステータスがMediaPlayer.Status.READYに遷移している場合は、すべての情報が必ず使用可能となります。メタデータまたはTrackが追加された場合に通知を受け取るために、それぞれgetMetadata()およびgetTracks()によって戻されるコレクションに対して、オブザーバを登録できます。

同じMediaオブジェクトを、複数のMediaPlayerオブジェクトの間で共有できます。したがって、共有インスタンスは、すべてのプレイヤで使用されるソース・メディア・データの単一コピーを管理することもあれば、各プレイヤ用のデータの別のコピーが必要となる場合もあります。ただし、実装の選択は、プレイヤのインタフェース・レベルの動作に影響しません。

導入されたバージョン:

JavaFX 2.0

関連項目:

MediaPlayer、MediaException

プロパティのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
Type	プロパティと説明
`ReadOnlyObjectProperty<Duration>`	`duration` ソース・メディアの秒単位の期間。
`ReadOnlyObjectProperty<MediaException>`	`error` エラーが発生した場合にMediaException値に設定されるプロパティ。
`ReadOnlyIntegerProperty`	`height` ソース・メディアのピクセルの高さ。
`ObjectProperty<Runnable>`	`onError` エラーが発生する場合に呼び出されるイベント・ハンドラ。
`ReadOnlyIntegerProperty`	`width` ソース・メディアのピクセルの幅。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

Media(String source)
Mediaインスタンスを構築します。

コンストラクタ
コンストラクタと説明
`Media(String source)` `Media`インスタンスを構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`ReadOnlyObjectProperty<Duration>`	`durationProperty()` ソース・メディアの秒単位の期間。
`ReadOnlyObjectProperty<MediaException>`	`errorProperty()` エラーが発生した場合にMediaException値に設定されるプロパティ。
`Duration`	`getDuration()` メディアの期間を秒単位で取得します。
`MediaException`	`getError()` メディアで発生したすべてのエラーを戻します。
`int`	`getHeight()` メディアのピクセルの高さを取得します。
`ObservableMap<String,Duration>`	`getMarkers()` この`Media`インスタンスで定義されているマーカーを取得します。
`ObservableMap<String,Object>`	`getMetadata()` このメディア・ソースに含まれるメタデータを取得します。
`Runnable`	`getOnError()` エラーが発生した場合に呼び出されるエラー・ハンドラを取得します。
`String`	`getSource()` メディアのソースURIを取得します。
`ObservableList<Track>`	`getTracks()` このメディア・ソースに含まれるトラックを取得します。
`int`	`getWidth()` メディアのピクセルの幅を取得します。
`ReadOnlyIntegerProperty`	`heightProperty()` ソース・メディアのピクセルの高さ。
`ObjectProperty<Runnable>`	`onErrorProperty()` エラーが発生する場合に呼び出されるイベント・ハンドラ。
`void`	`setOnError(Runnable value)` エラーが発生した場合に呼び出されるイベント・ハンドラを設定します。
`ReadOnlyIntegerProperty`	`widthProperty()` ソース・メディアのピクセルの幅。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- プロパティの詳細
  - error
```
public ReadOnlyObjectProperty<MediaException> errorProperty
```
    エラーが発生した場合にMediaException値に設定されるプロパティ。 errorがnullでない場合、メディアはロードされず、使用できません。 onErrorがnullでない場合、これはerrorプロパティが設定されると起動されます。
    
    関連項目:
    
    getError()
  - onError
```
public ObjectProperty<Runnable> onErrorProperty
```
    エラーが発生する場合に呼び出されるイベント・ハンドラ。これは、誤った形式の、または無効なURLがコンストラクタに渡された場合、またはURLへのアクセスに問題がある場合に発生します。
    
    関連項目:
    
    getOnError()、setOnError(Runnable)
  - width
```
public ReadOnlyIntegerProperty widthProperty
```
    ソース・メディアのピクセルの幅。これは、メディアに幅がない場合、つまり、オーディオの再生時や現在幅が不明な場合(ストリーミング・メディアで発生する場合がある)に、ゼロとなる場合があります。
    
    関連項目:
    
    getWidth()
  - height
```
public ReadOnlyIntegerProperty heightProperty
```
    ソース・メディアのピクセルの高さ。これは、メディアに高さがない場合、つまり、オーディオの再生時や現在高さが不明な場合(ストリーミング・メディアで発生する場合がある)に、ゼロとなる場合があります。
    
    関連項目:
    
    getHeight()
  - duration
```
public ReadOnlyObjectProperty<Duration> durationProperty
```
    ソース・メディアの秒単位の期間。メディアの期間が不明な場合、このプロパティ値はDuration.UNKNOWNとなります。
    
    関連項目:
    
    getDuration()
- コンストラクタの詳細
  - Media
```
public Media(String source)
```
    Mediaインスタンスを構築します。これは、メディア・ソースを指定する唯一の方法です。ソースは、有効なURIを表し、不変である必要があります。 HTTP、FILEおよびJARのURLのみがサポートされます。指定されたURLが無効である場合、例外がスローされます。非同期エラーが発生した場合、errorプロパティが設定されます。このプロパティをリスニングして、このようなエラーがすべて通知されるようにしてください。
    ソースが、FILEなどの非ブロッキング・プロトコルを使用している場合、すぐに検出できるなんらかの問題が発生すると、MediaExceptionがスローされます。このような問題には、メディアにアクセスできない、またはメディアのフォーマットがサポートされていない、などがあります。ただし、HTTPなどのブロッキングの可能性があるプロトコルを使用している場合、接続が非同期に初期化されるため、これらの種類のエラーはerrorプロパティを設定することによって通知されます。
    
    制約:
    - 指定されるURIは、java.net.URIの要求に従い、RFC-2396に準拠する必要があります。
    - HTTP、FILEおよびJARのURIのみがサポートされます。
    一般的なURIフォーマットの詳細は、java.net.URIを参照してください。 JAR URLの構文は、java.net.JarURLConnectionで指定されています。
    パラメータ:
    
    source - ソース・メディアのURI
    
    例外:
    
    NullPointerException - URI文字列がnullである場合。
    
    IllegalArgumentException - URI文字列がRFC-2396またはJar URL 仕様(該当する場合)に準拠していない場合、または準拠形式に変更できない非準拠形式である場合。
    
    IllegalArgumentException - URI文字列のスキームがnullである場合。
    
    UnsupportedOperationException - ソースに指定されたプロトコルがサポートされていない場合。
    
    MediaException - メディア・ソースに接続できない場合(MediaException.Type.MEDIA_INACCESSIBLEタイプ)、またはこれがサポートされていない場合(MediaException.Type.MEDIA_UNSUPPORTEDタイプ)。
- メソッドの詳細
  - getError
```
public final MediaException getError()
```
    メディアで発生したすべてのエラーを戻します。
    
    戻り値:
    
    MediaException。エラーがない場合はnull。
  - errorProperty
```
public ReadOnlyObjectProperty<MediaException> errorProperty()
```
    エラーが発生した場合にMediaException値に設定されるプロパティ。 errorがnullでない場合、メディアはロードされず、使用できません。 onErrorがnullでない場合、これはerrorプロパティが設定されると起動されます。
    
    関連項目:
    
    getError()
  - setOnError
```
public final void setOnError(Runnable value)
```
    エラーが発生した場合に呼び出されるイベント・ハンドラを設定します。
    
    パラメータ:
    
    value - エラー・イベント・ハンドラ。
  - getOnError
```
public final Runnable getOnError()
```
    エラーが発生した場合に呼び出されるエラー・ハンドラを取得します。
    
    戻り値:
    
    エラー・ハンドラ。何も定義されていない場合はnull。
  - onErrorProperty
```
public ObjectProperty<Runnable> onErrorProperty()
```
    エラーが発生する場合に呼び出されるイベント・ハンドラ。これは、誤った形式の、または無効なURLがコンストラクタに渡された場合、またはURLへのアクセスに問題がある場合に発生します。
    
    関連項目:
    
    getOnError()、setOnError(Runnable)
  - getMetadata
```
public final ObservableMap<String,Object> getMetadata()
```
    このメディア・ソースに含まれるメタデータを取得します。メタデータが存在しない場合、戻されるObservableMapは空となります。
    
    戻り値:
    
    このメディア・ソースに含まれるメタデータ。
  - getWidth
```
public final int getWidth()
```
    メディアのピクセルの幅を取得します。
    
    戻り値:
    
    メディアの幅。幅が未定義または不明な場合はゼロ。
  - widthProperty
```
public ReadOnlyIntegerProperty widthProperty()
```
    ソース・メディアのピクセルの幅。これは、メディアに幅がない場合、つまり、オーディオの再生時や現在幅が不明な場合(ストリーミング・メディアで発生する場合がある)に、ゼロとなる場合があります。
    
    関連項目:
    
    getWidth()
  - getHeight
```
public final int getHeight()
```
    メディアのピクセルの高さを取得します。
    
    戻り値:
    
    メディアの高さ。高さが未定義または不明な場合はゼロ。
  - heightProperty
```
public ReadOnlyIntegerProperty heightProperty()
```
    ソース・メディアのピクセルの高さ。これは、メディアに高さがない場合、つまり、オーディオの再生時や現在高さが不明な場合(ストリーミング・メディアで発生する場合がある)に、ゼロとなる場合があります。
    
    関連項目:
    
    getHeight()
  - getDuration
```
public final Duration getDuration()
```
    メディアの期間を秒単位で取得します。
    
    戻り値:
    
    メディアの期間。不明の場合はDuration.UNKNOWN。ライブ・ストリームの場合はDuration.INDEFINITE。
  - durationProperty
```
public ReadOnlyObjectProperty<Duration> durationProperty()
```
    ソース・メディアの秒単位の期間。メディアの期間が不明な場合、このプロパティ値はDuration.UNKNOWNとなります。
    
    関連項目:
    
    getDuration()
  - getTracks
```
public final ObservableList<Track> getTracks()
```
    このメディア・ソースに含まれるトラックを取得します。トラックが存在しない場合、戻されるObservableListは空になります。
    
    戻り値:
    
    このメディア・ソースに含まれるトラック。
  - getMarkers
```
public final ObservableMap<String,Duration> getMarkers()
```
    このMediaインスタンスで定義されているマーカーを取得します。マーカーが存在しない場合、戻されるObservableMapは空となります。プログラムによるマーカーは、戻されたMapにエントリを挿入することによって追加できます。
    
    戻り値:
    
    このメディア・ソースで定義されているマーカー。
  - getSource
```
public String getSource()
```
    メディアのソースURIを取得します。
    
    戻り値:
    
    Stringとしてのメディア・ソースURI。

クラスMedia

プロパティのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

プロパティの詳細

error

onError

width

height

duration

コンストラクタの詳細

Media

メソッドの詳細

getError

errorProperty

setOnError

getOnError

onErrorProperty

getMetadata

getWidth

widthProperty

getHeight

heightProperty

getDuration

durationProperty

getTracks

getMarkers

getSource