Носители (JavaFX 8.0)

java.lang. Объект
- javafx.scene.media. Носители

```
public final class Media
extends java.lang.Object
```
Media class представляет ресурс носителей. Это инстанцируют от строковой формы исходного URI. Информация о носителях, таких как продолжительность, метаданные, дорожки, и видео разрешение может быть получена из a Media экземпляр. Информация о носителях получается асинхронно и так не обязательно доступный сразу после инстанцирования class. Вся информация должна однако быть доступной, если экземпляр был связан с a MediaPlayer и тот проигрыватель перешел к MediaPlayer.Status.READY состояние. Быть уведомленным когда метаданные или Tracks добавляются, наблюдатели могут быть зарегистрированы в наборах, возвращенных getMetadata()и getTracks(), соответственно.

То же самое Media объект может быть совместно использован среди многократного MediaPlayer объекты. Такой совместно используемый экземпляр мог бы управлять единственной копией исходных данных носителей, которые будут использоваться всеми проигрывателями, или это могло бы потребовать отдельной копии данных для каждого проигрывателя. Выбор реализации не будет однако иметь никакого эффекта на поведение проигрывателя на уровне интерфейса.

См. Также:

MediaPlayer, MediaException

Сводка свойства

Все Методы Методы экземпляра Конкретные Методы
Ввести	Свойство и Описание
`ReadOnlyObjectProperty<Duration>`	`продолжительность` Продолжительность в секундах исходных носителей.
`ReadOnlyObjectProperty<MediaException>`	`ошибка` Набор свойств к MediaException оценивает, когда ошибка происходит.
`ReadOnlyIntegerProperty`	`height` height в пикселях исходных носителей.
`ObjectProperty<java.lang.Runnable>`	`onError` Обработчик событий, вызванный, когда ошибка происходит.
`ReadOnlyIntegerProperty`	`width` width в пикселях исходных носителей.

Сводка конструктора

Конструкторы
Конструктор и Описание

Media(java.lang.String source)
Конструкции a Media экземпляр.

Конструкторы
Конструктор и Описание
`Media(java.lang.String source)` Конструкции a `Media` экземпляр.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`ReadOnlyObjectProperty<Duration>`	`durationProperty()` Продолжительность в секундах исходных носителей.
`ReadOnlyObjectProperty<MediaException>`	`errorProperty()` Набор свойств к MediaException оценивает, когда ошибка происходит.
`Продолжительность`	`getDuration()` Получите продолжительность в секундах носителей.
`MediaException`	`getError()` Возвратите любую ошибку, с которой встречаются в носителях.
`int`	`getHeight()` Получите height в пикселях носителей.
`ObservableMap<java.lang.String,Duration>`	`getMarkers()` Получите маркеры, определенные на этом `Media` экземпляр.
`ObservableMap<java.lang.String,java.lang.Object>`	`getMetadata()` Получите метаданные, содержавшиеся в этом источнике носителей.
`java.lang.Runnable`	`getOnError()` Получите обработчик ошибок, который вызовут, если ошибка происходит.
`java.lang.String`	`getSource()` Получите исходный URI носителей.
`ObservableList<Track>`	`getTracks()` Получите дорожки, содержавшиеся в этом источнике носителей.
`int`	`getWidth()` Получите width в пикселях носителей.
`ReadOnlyIntegerProperty`	`heightProperty()` height в пикселях исходных носителей.
`ObjectProperty<java.lang.Runnable>`	`onErrorProperty()` Обработчик событий, вызванный, когда ошибка происходит.
`void`	`setOnError(java.lang.Runnable value)` Установите обработчик событий, который вызовут, когда ошибка происходит.
`ReadOnlyIntegerProperty`	`widthProperty()` width в пикселях исходных носителей.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь свойства
  - ошибка
```
public ReadOnlyObjectProperty<MediaException> errorProperty
```
    Набор свойств к MediaException оценивает, когда ошибка происходит. Если error не -null, тогда носители не могли быть загружены и не применимы. Если onError не -null, это будет вызвано когда error свойство устанавливается.
    
    См. Также:
    
    getError()
  - onError
```
public ObjectProperty<java.lang.Runnable> onErrorProperty
```
    Обработчик событий, вызванный, когда ошибка происходит. Это произойдет, если уродливый или недопустимый URL передадут конструктору или есть проблема, получающая доступ к URL.
    
    См. Также:
    
    getOnError(), setOnError(Runnable)
  - width
```
public ReadOnlyIntegerProperty widthProperty
```
    width в пикселях исходных носителей. Это может быть нулем, если у носителей нет никакого width, например, играя аудио, или если width в настоящий момент неизвестен, который может произойти с потоковыми медиа.
    
    См. Также:
    
    getWidth()
  - height
```
public ReadOnlyIntegerProperty heightProperty
```
    height в пикселях исходных носителей. Это может быть нулем, если у носителей нет никакого height, например, играя аудио, или если height в настоящий момент неизвестен, который может произойти с потоковыми медиа.
    
    См. Также:
    
    getHeight()
  - продолжительность
```
public ReadOnlyObjectProperty<Продолжительность> durationProperty
```
    Продолжительность в секундах исходных носителей. Если продолжительность носителей будет неизвестна тогда, то это значение свойства будет Duration.UNKNOWN.
    
    См. Также:
    
    getDuration()
- Деталь конструктора
  - Носители
```
public Media(java.lang.String source)
```
    Конструкции a Media экземпляр. Это - единственный способ определить источник носителей. Источник должен представить допустимое URI и является неизменным. Только HTTP, ФАЙЛ, и JAR URLs поддерживаются. Если обеспеченный URL будет недопустим тогда, то исключение будет выдано. Если асинхронная ошибка происходит, error свойство будет установлено. Слушайте это свойство, которое будет уведомлено относительно любых таких ошибок.
    Если источник будет использовать неблокирующий протокол, такой как ФАЙЛ, то любые проблемы, которые могут быть обнаружены сразу, вызовут a MediaException быть брошенным. Такие проблемы включают носители, являющиеся недоступным или в неподдерживаемом формате. Если однако потенциально блокирующий протокол, такой как HTTP будет использоваться, то соединение будет инициализировано асинхронно так, чтобы эти виды ошибок были сообщены, устанавливая error свойство.
    
    Ограничения:
    - Предоставленный URI должен соответствовать RFC 2396 как требуется java.net. URI.
    - Только HTTP, ФАЙЛ, и URI JAR поддерживаются.
    См. java.net. URI для получения дополнительной информации о URI, форматирующем вообще. JAR синтаксис URL определяется в java.net. JarURLConnection.
    Параметры:
    
    source - URI исходных носителей.
    
    Броски:
    
    java.lang.NullPointerException - если строка URI null.
    
    java.lang.IllegalArgumentException - если строка URI не соответствует RFC 2396 или, если приспособлено, Фляга спецификация URL, или находится в несовместимой форме, которая не может быть изменена к совместимой форме.
    
    java.lang.IllegalArgumentException - если у строки URI есть a null схема.
    
    java.lang.UnsupportedOperationException - если протокол, определенный для источника, не поддерживается.
    
    MediaException - если источник носителей не может быть соединен (тип MediaException.Type.MEDIA_INACCESSIBLE) или не поддерживается (тип MediaException.Type.MEDIA_UNSUPPORTED).
- Деталь метода
  - getError
```
public final MediaException getError()
```
    Возвратите любую ошибку, с которой встречаются в носителях.
    
    Возвраты:
    
    a MediaException или null если нет никакой ошибки.
  - errorProperty
```
public ReadOnlyObjectProperty<MediaException> errorProperty()
```
    Набор свойств к MediaException оценивает, когда ошибка происходит. Если error не -null, тогда носители не могли быть загружены и не применимы. Если onError не -null, это будет вызвано когда error свойство устанавливается.
    
    См. Также:
    
    getError()
  - setOnError
```
public final void setOnError(java.lang.Runnable value)
```
    Установите обработчик событий, который вызовут, когда ошибка происходит.
    
    Параметры:
    
    value - ошибочный обработчик событий.
  - getOnError
```
public final java.lang.Runnable getOnError()
```
    Получите обработчик ошибок, который вызовут, если ошибка происходит.
    
    Возвраты:
    
    обработчик ошибок или null если ни один не определяется.
  - onErrorProperty
```
public ObjectProperty<java.lang.Runnable> onErrorProperty()
```
    Обработчик событий, вызванный, когда ошибка происходит. Это произойдет, если уродливый или недопустимый URL передадут конструктору или есть проблема, получающая доступ к URL.
    
    См. Также:
    
    getOnError(), setOnError(Runnable)
  - getMetadata
```
public final ObservableMap<java.lang.String,java.lang.Object> getMetadata()
```
    Получите метаданные, содержавшиеся в этом источнике носителей. Если нет никаких метаданных, возвращенного ObservableMap будет пусто.
    
    Возвраты:
    
    метаданные содержатся в этом источнике носителей.
  - getWidth
```
public final int getWidth()
```
    Получите width в пикселях носителей.
    
    Возвраты:
    
    width носителей или нуль, если width неопределен или неизвестен.
  - widthProperty
```
public ReadOnlyIntegerProperty widthProperty()
```
    width в пикселях исходных носителей. Это может быть нулем, если у носителей нет никакого width, например, играя аудио, или если width в настоящий момент неизвестен, который может произойти с потоковыми медиа.
    
    См. Также:
    
    getWidth()
  - getHeight
```
public final int getHeight()
```
    Получите height в пикселях носителей.
    
    Возвраты:
    
    height носителей или нуль, если height неопределен или неизвестен.
  - heightProperty
```
public ReadOnlyIntegerProperty heightProperty()
```
    height в пикселях исходных носителей. Это может быть нулем, если у носителей нет никакого height, например, играя аудио, или если height в настоящий момент неизвестен, который может произойти с потоковыми медиа.
    
    См. Также:
    
    getHeight()
  - getDuration
```
public final Продолжительность getDuration()
```
    Получите продолжительность в секундах носителей.
    
    Возвраты:
    
    продолжительность носителей, Duration.UNKNOWN если неизвестный или Duration.INDEFINITE для живых потоков
  - durationProperty
```
public ReadOnlyObjectProperty<Продолжительность> durationProperty()
```
    Продолжительность в секундах исходных носителей. Если продолжительность носителей будет неизвестна тогда, то это значение свойства будет Duration.UNKNOWN.
    
    См. Также:
    
    getDuration()
  - getTracks
```
public final ObservableList<Дорожка> getTracks()
```
    Получите дорожки, содержавшиеся в этом источнике носителей. Если нет никаких дорожек, возвращенного ObservableList будет пусто.
    
    Возвраты:
    
    дорожки содержатся в этом источнике носителей.
  - getMarkers
```
public final ObservableMap<java.lang.String,Продолжительность> getMarkers()
```
    Получите маркеры, определенные на этом Media экземпляр. Если нет никаких маркеров возвращенного ObservableMap будет пусто. Программируемые маркеры могут быть добавлены, вставляя записи в возвращенном Map.
    
    Возвраты:
    
    маркеры определяются на этом источнике носителей.
  - getSource
```
public java.lang.String getSource()
```
    Получите исходный URI носителей.
    
    Возвраты:
    
    исходный URI носителей как <код> Строка </код>.

Носители класса

Сводка свойства

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Деталь свойства

ошибка

onError

width

height

продолжительность

Деталь конструктора

Носители

Деталь метода

getError

errorProperty

setOnError

getOnError

onErrorProperty

getMetadata

getWidth

widthProperty

getHeight

heightProperty

getDuration

durationProperty

getTracks

getMarkers

getSource