public final class Media extends Object
Media
クラスは、メディア・リソースを表します。これは、文字列形式のソースURIからインスタンス化されます。期間、メタデータ、トラックおよびビデオ解像度などのメディアに関する情報は、Media
インスタンスから取得できます。メディア情報は非同期に取得されるため、必ずしもクラスをインスタンス化した直後に使用可能になるとはかぎりません。ただし、インスタンスがMediaPlayer
に関連付けられ、プレイヤのステータスがMediaPlayer.Status.READY
に遷移している場合は、すべての情報が必ず使用可能となります。メタデータまたはTrack
が追加された場合に通知を受け取るために、それぞれgetMetadata()
およびgetTracks()
によって戻されるコレクションに対して、オブザーバを登録できます。
同じMedia
オブジェクトを、複数のMediaPlayer
オブジェクトの間で共有できます。したがって、共有インスタンスは、すべてのプレイヤで使用されるソース・メディア・データの単一コピーを管理することもあれば、各プレイヤ用のデータの別のコピーが必要となる場合もあります。ただし、実装の選択は、プレイヤのインタフェース・レベルの動作に影響しません。
MediaPlayer
、MediaException
Type | プロパティと説明 |
---|---|
ReadOnlyObjectProperty<Duration> |
duration
ソース・メディアの秒単位の期間。
|
ReadOnlyObjectProperty<MediaException> |
error
エラーが発生した場合にMediaException値に設定されるプロパティ。
|
ReadOnlyIntegerProperty |
height
ソース・メディアのピクセルの高さ。
|
ObjectProperty<Runnable> |
onError
エラーが発生する場合に呼び出されるイベント・ハンドラ。
|
ReadOnlyIntegerProperty |
width
ソース・メディアのピクセルの幅。
|
修飾子と型 | メソッドと説明 |
---|---|
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()
ソース・メディアのピクセルの幅。
|
public ReadOnlyObjectProperty<MediaException> errorProperty
error
がnull
でない場合、メディアはロードされず、使用できません。onError
がnull
でない場合、これはerror
プロパティが設定されると起動されます。getError()
public ObjectProperty<Runnable> onErrorProperty
public ReadOnlyIntegerProperty widthProperty
getWidth()
public ReadOnlyIntegerProperty heightProperty
getHeight()
public ReadOnlyObjectProperty<Duration> durationProperty
Duration.UNKNOWN
となります。getDuration()
public Media(String source)
Media
インスタンスを構築します。これは、メディア・ソースを指定する唯一の方法です。ソースは、有効なURI
を表し、不変である必要があります。HTTP、FILEおよびJARのURL
のみがサポートされます。指定されたURLが無効である場合、例外がスローされます。非同期エラーが発生した場合、error
プロパティが設定されます。このプロパティをリスニングして、このようなエラーがすべて通知されるようにしてください。
ソースが、FILEなどの非ブロッキング・プロトコルを使用している場合、すぐに検出できるなんらかの問題が発生すると、MediaException
がスローされます。このような問題には、メディアにアクセスできない、またはメディアのフォーマットがサポートされていない、などがあります。ただし、HTTPなどのブロッキングの可能性があるプロトコルを使用している場合、接続が非同期に初期化されるため、これらの種類のエラーはerror
プロパティを設定することによって通知されます。
制約:
一般的なURIフォーマットの詳細は、java.net.URIを参照してください。JAR URLの構文は、java.net.JarURLConnectionで指定されています。
source
- ソース・メディアのURINullPointerException
- URI文字列がnull
である場合。IllegalArgumentException
- URI文字列がRFC-2396またはJar URL 仕様(該当する場合)に準拠していない場合、または準拠形式に変更できない非準拠形式である場合。IllegalArgumentException
- URI文字列のスキームがnull
である場合。UnsupportedOperationException
- ソースに指定されたプロトコルがサポートされていない場合。MediaException
- メディア・ソースに接続できない場合(MediaException.Type.MEDIA_INACCESSIBLE
タイプ)、またはこれがサポートされていない場合(MediaException.Type.MEDIA_UNSUPPORTED
タイプ)。public final MediaException getError()
MediaException
。エラーがない場合はnull
。public ReadOnlyObjectProperty<MediaException> errorProperty()
error
がnull
でない場合、メディアはロードされず、使用できません。onError
がnull
でない場合、これはerror
プロパティが設定されると起動されます。getError()
public final void setOnError(Runnable value)
value
- エラー・イベント・ハンドラ。public final Runnable getOnError()
null
。public ObjectProperty<Runnable> onErrorProperty()
public final ObservableMap<String,Object> getMetadata()
ObservableMap
は空となります。public final int getWidth()
public ReadOnlyIntegerProperty widthProperty()
getWidth()
public final int getHeight()
public ReadOnlyIntegerProperty heightProperty()
getHeight()
public final Duration getDuration()
Duration.UNKNOWN
。ライブ・ストリームの場合はDuration.INDEFINITE
。public ReadOnlyObjectProperty<Duration> durationProperty()
Duration.UNKNOWN
となります。getDuration()
public final ObservableList<Track> getTracks()
ObservableList
は空になります。public final ObservableMap<String,Duration> getMarkers()
Media
インスタンスで定義されているマーカーを取得します。マーカーが存在しない場合、戻されるObservableMap
は空となります。プログラムによるマーカーは、戻されたMap
にエントリを挿入することによって追加できます。Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.