Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class Media
extends java.lang.Object
Media
class представляет ресурс носителей. Это инстанцируют от строковой формы исходного URI. Информация о носителях, таких как продолжительность, метаданные, дорожки, и видео разрешение может быть получена из a Media
экземпляр. Информация о носителях получается асинхронно и так не обязательно доступный сразу после инстанцирования class. Вся информация должна однако быть доступной, если экземпляр был связан с a MediaPlayer
и тот проигрыватель перешел к MediaPlayer.Status.READY
состояние. Быть уведомленным когда метаданные или Track
s добавляются, наблюдатели могут быть зарегистрированы в наборах, возвращенных 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 экземпляр. |
Модификатор и Тип | Метод и Описание |
---|---|
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 в пикселях исходных носителей.
|
public ReadOnlyObjectProperty<MediaException> errorProperty
error
не -null
, тогда носители не могли быть загружены и не применимы. Если onError
не -null
, это будет вызвано когда error
свойство устанавливается.getError()
public ObjectProperty<java.lang.Runnable> onErrorProperty
getOnError()
, setOnError(Runnable)
public ReadOnlyIntegerProperty widthProperty
getWidth()
public ReadOnlyIntegerProperty heightProperty
getHeight()
public ReadOnlyObjectProperty<Duration> durationProperty
Duration.UNKNOWN
.getDuration()
public Media(java.lang.String source)
Media
экземпляр. Это - единственный способ определить источник носителей. Источник должен представить допустимое URI
и является неизменным. Только HTTP, ФАЙЛ, и JAR URL
s поддерживаются. Если обеспеченный URL будет недопустим тогда, то исключение будет выдано. Если асинхронная ошибка происходит, error
свойство будет установлено. Слушайте это свойство, которое будет уведомлено относительно любых таких ошибок. Если источник будет использовать неблокирующий протокол, такой как ФАЙЛ, то любые проблемы, которые могут быть обнаружены сразу, вызовут a MediaException
быть брошенным. Такие проблемы включают носители, являющиеся недоступным или в неподдерживаемом формате. Если однако потенциально блокирующий протокол, такой как HTTP будет использоваться, то соединение будет инициализировано асинхронно так, чтобы эти виды ошибок были сообщены, устанавливая error
свойство.
Ограничения:
См.
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
).public final MediaException getError()
MediaException
или null
если нет никакой ошибки.public ReadOnlyObjectProperty<MediaException> errorProperty()
error
не -null
, тогда носители не могли быть загружены и не применимы. Если onError
не -null
, это будет вызвано когда error
свойство устанавливается.getError()
public final void setOnError(java.lang.Runnable value)
value
- ошибочный обработчик событий.public final java.lang.Runnable getOnError()
null
если ни один не определяется.public ObjectProperty<java.lang.Runnable> onErrorProperty()
getOnError()
, setOnError(Runnable)
public final ObservableMap<java.lang.String,java.lang.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<java.lang.String,Duration> getMarkers()
Media
экземпляр. Если нет никаких маркеров возвращенного ObservableMap
будет пусто. Программируемые маркеры могут быть добавлены, вставляя записи в возвращенном Map
.public java.lang.String getSource()
String
.Copyright (c) 2008, 2012, Oracle и/или его филиалы. Все права защищены. Использование подвергается