javafx.scene.media

Класс AudioClip

java.lang.Object

javafx.scene.media.AudioClip

public final class AudioClip
extends Object

Объект AudioClip представляет собой фрагмент аудио, который можно воспроизвести с минимальной задержкой. Клипы загружаются аналогично объектам Media, но имеют другое поведение, например, Media не может воспроизводиться сам. AudioClip также могут быть использованы немедленно. Поведение воспроизведения — "выстрел и забудь": после вызова одного из методов воспроизведения единственный управляемый параметр — stop(). Объект AudioClip также может быть воспроизведён несколько раз одновременно. Чтобы выполнить ту же задачу с помощью Media, нужно было бы создать новый объект MediaPlayer для каждого звука, воспроизводимого параллельно. Объекты Media лучше подходят для звуков длительного воспроизведения. Это главным образом потому, что AudioClip хранит в памяти исходные, не сжатые аудиоданные для всего звука, что может быть довольно большим для длинных аудиоклипов. Объект MediaPlayer будет содержать только достаточное количество декомпрессированных аудиоданных в памяти для воспроизведения в течение короткого времени, поэтому он намного более эффективен с точки зрения памяти для длинных клипов, особенно если они сжаты.

Пример использования:

AudioClip plonkSound = new AudioClip("http://somehost/path/plonk.aiff");
 plonkSound.play();

С:

JavaFX 2.0

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

Все методыМетоды экземпляраКонкретные методы
Тип	Свойство и описание
`DoubleProperty`	`balance` Относительные уровни громкости левого и правого каналов клипа.
`IntegerProperty`	`cycleCount` Число повторов клипа при вызове `play()`.
`DoubleProperty`	`pan` Относительный "центр" клипа.
`IntegerProperty`	`priority` Относительный приоритет клипа по отношению к другим клипам.
`DoubleProperty`	`rate` Относительная скорость воспроизведения клипа.
`DoubleProperty`	`volume` Относительный уровень громкости при воспроизведении клипа.

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

Поля
Модификатор и тип	Поле и описание
`static int`	`INDEFINITE` При установке `cycleCount` в это значение, `AudioClip` будет циклически повторяться до остановки.

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

Конструкторы
Конструктор и описание
`AudioClip(String source)` Создать `AudioClip`, загруженный из предоставленного URL-адреса источника.

Краткое описание методов

Все методыМетоды экземпляраКонкретные методы
Модификатор и тип	Метод и описание
`DoubleProperty`	`balanceProperty()` Относительные уровни громкости левого и правого каналов клипа.
`IntegerProperty`	`cycleCountProperty()` Число повторов клипа при вызове `play()`.
`double`	`getBalance()` Получить значение баланса по умолчанию для этого клипа.
`int`	`getCycleCount()` Получить значение цикла по умолчанию.
`double`	`getPan()` Получить значение панорамирования по умолчанию.
`int`	`getPriority()` Получить приоритет воспроизведения по умолчанию.
`double`	`getRate()` Получить скорость воспроизведения по умолчанию.
`String`	`getSource()` Получить URL-адрес источника, используемый для создания этого `AudioClip`.
`double`	`getVolume()` Получить уровень громкости по умолчанию.
`boolean`	`isPlaying()` Указывает, воспроизводится ли этот `AudioClip`.
`DoubleProperty`	`panProperty()` Относительный "центр" клипа.
`void`	`play()` Воспроизвести `AudioClip` с использованием всех параметров по умолчанию.
`void`	`play(double volume)` Воспроизвести `AudioClip` с использованием всех параметров по умолчанию, кроме громкости.
`void`	`play(double volume, double balance, double rate, double pan, int priority)` Воспроизвести `AudioClip` с заданными параметрами.
`IntegerProperty`	`priorityProperty()` Относительный приоритет клипа по отношению к другим клипам.
`DoubleProperty`	`rateProperty()` Относительная скорость воспроизведения клипа.
`void`	`setBalance(double balance)` Установить уровень баланса по умолчанию.
`void`	`setCycleCount(int count)` Установить значение цикла по умолчанию.
`void`	`setPan(double pan)` Установить значение панорамирования по умолчанию.
`void`	`setPriority(int priority)` Установить приоритет воспроизведения по умолчанию.
`void`	`setRate(double rate)` Установить скорость воспроизведения по умолчанию.
`void`	`setVolume(double value)` Установить уровень громкости по умолчанию.
`void`	`stop()` Немедленно остановить всё воспроизведение этого `AudioClip`.
`DoubleProperty`	`volumeProperty()` Относительный уровень громкости при воспроизведении клипа.

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

Подробное описание свойства
- volume
```
public DoubleProperty volumeProperty
```
  Относительный уровень громкости, с которым воспроизводится клип. Допустимый диапазон — от 0,0 (выключено) до 1,0 (полная громкость). Значения вне этого диапазона будут ограничены, поэтому они не будут оказывать дополнительного влияния. Громкость регулируется затуханием, поэтому значения ниже 1,0 уменьшают уровень звука соответственно.
  
  См. также:
  
  getVolume(), setVolume(double)
- balance
```
public DoubleProperty balanceProperty
```
  Относительные уровни громкости слева и справа для клипа. Допустимый диапазон — от -1,0 до 1,0. Значение -1,0 задаёт полную громкость левому каналу, выключая правый; 0,0 задаёт полную громкость обоим каналам; 1,0 задаёт полную громкость правому каналу, выключая левый. Значения вне этого диапазона ограничены внутри.
  
  См. также:
  
  getBalance(), setBalance(double)
- rate
```
public DoubleProperty rateProperty
```
  Относительная скорость воспроизведения клипа. Допустимый диапазон — от 0,125 (1/8 скорости) до 8,0 (8x скорости); значения вне этого диапазона ограничены внутри. Нормальное воспроизведение клипа — 1,0; любое другое значение повлияет на высоту тона и продолжительность соответственно.
  
  См. также:
  
  getRate(), setRate(double)
- pan
```
public DoubleProperty panProperty
```
  Относительное «центральное» положение клипа. Значение 0,0 воспроизводит клип нормально; -1,0 смещает клип полностью влево, а 1,0 — полностью вправо. В отличие от balance, это значение смешивает оба канала, поэтому данные ни одного из каналов не теряются. Установка pan для моно-клипа имеет тот же эффект, что и установка balance, но с гораздо большей нагрузкой на процессор, поэтому для моно-клипов это не рекомендуется.
  
  См. также:
  
  getPan(), setPan(double)
- priority
```
public IntegerProperty priorityProperty
```
  Относительный приоритет клипа по отношению к другим клипам. Это значение используется для определения, какие клипы необходимо удалить, когда достигнуто максимальное количество разрешённых клипов. Чем ниже приоритет, тем больше вероятность того, что клип будет остановлен и удалён из канала микшера, который он занимает. Допустимый диапазон — любое целое число; ограничений нет. По умолчанию приоритет всех клипов равен нулю до изменения. Количество одновременных звуков, которые могут быть воспроизведены, зависит от реализации и, возможно, от системы.
  
  См. также:
  
  getPriority(), setPriority(int)
- cycleCount
```
public IntegerProperty cycleCountProperty
```
  Количество раз, которое клип будет воспроизведён при вызове play(). Значение cycleCount, равное 1, воспроизводит клип ровно один раз, 2 — два раза и так далее. Допустимый диапазон — 1 и более, но установка значения INDEFINITE заставит клип повторяться до тех пор, пока не будет вызван stop().
  
  См. также:
  
  getCycleCount(), setCycleCount(int)

Подробное описание поля
- INDEFINITE
```
public static final int INDEFINITE
```
  Когда cycleCount установлено в это значение, AudioClip будет повторяться непрерывно до остановки. Это значение является синонимом MediaPlayer.INDEFINITE и Animation.INDEFINITE; эти значения можно использовать взаимозаменяемо.
  
  См. также:
  
  Значения постоянных полей

Подробное описание конструктора
- AudioClip
```
public AudioClip(String source)
```
  Создаёт AudioClip, загруженный из предоставленного URL-адреса.
  
  Параметры:
  
  source — строка URL-адреса, из которого загружается аудиоклип. Это может быть HTTP-, файловый или JAR-источник.
  
  Исключения:
  
  NullPointerException — если параметр является null.

Подробное описание метода
- getSource
```
public String getSource()
```
  Получить URL источника, использованного для создания этого AudioClip.
  
  Возвращает:
  
  URL источника, предоставленный конструктору
- setVolume
```
public final void setVolume(double value)
```
  Установить значение громкости по умолчанию. Новое значение применится только при последующих воспроизведениях.
  
  Параметры:
  
  value - новое значение громкости по умолчанию для этого клипа
  
  См. также:
  
  volume
- getVolume
```
public final double getVolume()
```
  Получить значение громкости по умолчанию.
  
  Возвращает:
  
  значение громкости по умолчанию для этого клипа
  
  См. также:
  
  volume
- volumeProperty
```
public DoubleProperty volumeProperty()
```
  Относительное значение громкости, с которой воспроизводится клип. Допустимый диапазон от 0.0 (выключено) до 1.0 (полная громкость). Значения вне этого диапазона будут ограничены, поэтому не окажут дополнительного влияния. Громкость регулируется затуханием, поэтому значения ниже 1.0 соответствующим образом уменьшат уровень звука.
  
  См. также:
  
  getVolume(), setVolume(double)
- setBalance
```
public void setBalance(double balance)
```
  Установить значение баланса по умолчанию. Новое значение повлияет только на последующие воспроизведения.
  
  Параметры:
  
  balance - новое значение баланса по умолчанию
  
  См. также:
  
  balance
- getBalance
```
public double getBalance()
```
  Получить значение баланса по умолчанию для этого клипа.
  
  Возвращает:
  
  значение баланса по умолчанию для этого клипа
  
  См. также:
  
  balance
- balanceProperty
```
public DoubleProperty balanceProperty()
```
  Относительное значение громкости левого и правого каналов клипа. Допустимый диапазон от -1.0 до 1.0, где -1.0 обеспечивает полную громкость левого канала, а правый канал выключен, 0.0 обеспечивает полную громкость обоих каналов, а 1.0 обеспечивает полную громкость правого канала, а левый канал выключен. Значения вне этого диапазона ограничены внутри.
  
  См. также:
  
  getBalance(), setBalance(double)
- setRate
```
public void setRate(double rate)
```
  Установить значение скорости воспроизведения по умолчанию. Новое значение повлияет только на последующие воспроизведения.
  
  Параметры:
  
  rate - новая скорость воспроизведения по умолчанию
  
  См. также:
  
  rate
- getRate
```
public double getRate()
```
  Получить значение скорости воспроизведения по умолчанию.
  
  Возвращает:
  
  скорость воспроизведения по умолчанию для этого клипа
  
  См. также:
  
  rate
- rateProperty
```
public DoubleProperty rateProperty()
```
  Относительная скорость воспроизведения клипа. Допустимый диапазон от 0,125 (в 8 раз медленнее) до 8,0 (в 8 раз быстрее); значения вне этого диапазона ограничены внутри. Нормальное воспроизведение клипа — 1,0; любая другая скорость повлияет на высоту тона и продолжительность соответственно.
  
  См. также:
  
  getRate(), setRate(double)
- setPan
```
public void setPan(double pan)
```
  Установить значение панорамирования по умолчанию. Новое значение повлияет только на последующие воспроизведения.
  
  Параметры:
  
  pan - новое значение панорамирования по умолчанию
  
  См. также:
  
  pan
- getPan
```
public double getPan()
```
  Получить значение панорамирования по умолчанию.
  
  Возвращает:
  
  значение панорамирования по умолчанию для этого клипа
  
  См. также:
  
  pan
- panProperty
```
public DoubleProperty panProperty()
```
  Относительное «центральное» положение клипа. Значение панорамирования 0.0 воспроизводит клип нормально, -1.0 смещает клип полностью влево, а 1.0 — полностью вправо. В отличие от баланса, эта настройка смешивает оба канала, поэтому ни один канал не теряет данных. Установка панорамирования для моно-клипа имеет тот же эффект, что и установка баланса, но с гораздо большей нагрузкой на ЦП, поэтому это не рекомендуется для моно-клипов.
  
  См. также:
  
  getPan(), setPan(double)
- setPriority
```
public void setPriority(int priority)
```
  Установить приоритет воспроизведения по умолчанию. Новое значение применится только при последующих воспроизведениях.
  
  Параметры:
  
  priority - новый приоритет воспроизведения по умолчанию
  
  См. также:
  
  priority
- getPriority
```
public int getPriority()
```
  Получить приоритет воспроизведения по умолчанию.
  
  Возвращает:
  
  приоритет воспроизведения по умолчанию для этого клипа
  
  См. также:
  
  priority
- priorityProperty
```
public IntegerProperty priorityProperty()
```
  Относительный приоритет клипа по отношению к другим клипам. Это значение используется для определения клипов для удаления при превышении максимального допустимого количества клипов. Чем ниже приоритет, тем выше вероятность остановки и удаления клипа из канала микшера, который он занимает. Допустимый диапазон — любое целое число; ограничений нет. Приоритет по умолчанию для всех клипов равен нулю до изменения. Количество одновременных звуков, которые могут быть воспроизведены, зависит от реализации и, возможно, от системы.
  
  См. также:
  
  getPriority(), setPriority(int)
- setCycleCount
```
public void setCycleCount(int count)
```
  Установить значение счетчика циклов по умолчанию. Новое значение применится только при последующих воспроизведениях.
  
  Параметры:
  
  count - новое значение счетчика циклов по умолчанию для этого клипа
  
  См. также:
  
  cycleCount
- getCycleCount
```
public int getCycleCount()
```
  Получить значение счетчика циклов по умолчанию.
  
  Возвращает:
  
  значение cycleCount по умолчанию для этого аудиоклипа
  
  См. также:
  
  cycleCount
- cycleCountProperty
```
public IntegerProperty cycleCountProperty()
```
  Число раз, которое клип будет воспроизведён при вызове play(). Значение cycleCount 1 воспроизведёт клип один раз, значение 2 — два раза и так далее. Допустимый диапазон — 1 и более, но установка значения INDEFINITE заставит клип непрерывно циклироваться до вызова stop().
  
  См. также:
  
  getCycleCount(), setCycleCount(int)
- play
```
public void play()
```
  Воспроизвести AudioClip используя все параметры по умолчанию.
- play
```
public void play(double volume)
```
  Воспроизвести AudioClip используя все параметры по умолчанию, за исключением громкости. Этот метод не изменяет параметры по умолчанию клипа.
  
  Параметры:
  
  volume - уровень громкости, с которым воспроизвести клип
- play
```
public void play(double volume,
                 double balance,
                 double rate,
                 double pan,
                 int priority)
```
  Воспроизвести AudioClip с заданными параметрами. Значения, выходящие за указанные диапазоны, ограничены соответствующими свойствами. Этот метод не изменяет параметры по умолчанию клипа.
  
  Параметры:
  
  volume - уровень громкости для воспроизведения этого клипа. Допустимый диапазон громкости от 0.0 до 1.0, где 0.0 соответствует эффективно выключенной громкости, а 1.0 — полной громкости.
- isPlaying
```
public boolean isPlaying()
```
  Указать, воспроизводится ли этот AudioClip. Если этот метод возвращает true, значит метод play() был вызван как минимум один раз и он все ещё воспроизводится.
  
  Возвращает:
  
  true, если клип находится в очереди в любом канале микшера, false в противном случае
- stop
```
public void stop()
```
  Немедленно остановить всё воспроизведение этого AudioClip.

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Класс AudioClip

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

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

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

Краткое описание методов

Методы, унаследованные от класса java.lang.Object

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

volume

balance

rate

pan

priority

cycleCount

Подробное описание поля

INDEFINITE

Подробное описание конструктора

AudioClip

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

getSource

setVolume

getVolume

volumeProperty

setBalance

getBalance

balanceProperty

setRate

getRate

rateProperty

setPan

getPan

panProperty

setPriority

getPriority

priorityProperty

setCycleCount

getCycleCount

cycleCountProperty

play

play

play

isPlaying

stop