Класс Media

public final class Media
extends Object

• Краткое описание свойств

  Все методыМетоды экземпляраКонкретные методы

  Тип	Свойство и описание
  ReadOnlyObjectProperty<Duration>	duration Продолжительность источника медиа в секундах.
  ReadOnlyObjectProperty<MediaException>	error Свойство, установленное в значение MediaException при возникновении ошибки.
  ReadOnlyIntegerProperty	height Высота источника медиа в пикселях.
  ObjectProperty<Runnable>	onError Обработчик событий, вызываемый при возникновении ошибки.
  ReadOnlyIntegerProperty	width Ширина источника медиа в пикселях.

• Краткое описание конструкторов

  Конструкторы

  Конструктор и описание
  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 и является неизменяемым. Поддерживаются только ссылки URL HTTP, FILE и JAR. Если предоставленный URL недействителен, будет выброшено исключение. Если произойдёт асинхронная ошибка, свойство error будет установлено. Слушайте это свойство, чтобы быть уведомлёнными о таких ошибках.

    Если источник использует протокол без блокировки, такой как FILE, то любые проблемы, которые могут быть обнаружены сразу, вызовут сброс MediaException. К таким проблемам относится недоступность медиа или неподдерживаемый формат. Однако, если используется потенциально блокирующий протокол, такой как HTTP, соединение будет инициализировано асинхронно, поэтому такие ошибки будут сигнализироваться установкой свойства error.

    Ограничения:

    • Предоставленный URI должен соответствовать RFC-2396, как требуется java.net.URI.
    • Поддерживаются только URI HTTP, FILE и JAR.

    См. java.net.URI для получения дополнительной информации о форматировании URI в целом. Синтаксис URL JAR указан в java.net.JarURLConnection.

    Параметры:

    source - URI источника медиа.

    Исключения:

    NullPointerException - если строка URI null.

• Подробное описание методов

  • 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 источника медиа.

    Возвращает:

    URI источника медиа в виде String.