Processing:Библиотеки/Sound/Класс SoundFile/play()

Содержание

Среда разработки Processing

Справочник языка Processing

Библиотеки

Примеры

Режимы программирования

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

play()

Класс

SoundFile

Обозначение

play()

Описание

Запускает проигрывание аудиофайла. Проигрывает аудиофайл только один раз, т.е. курсор воспроизведения доходит до конца аудиофайла, а потом останавливается. Если ранее в программе была вызвана функция cue() или pause(), то проигрывание аудиофайла возобновится с позиции, заданной с помощью какой-либо из этих функций.

Синтаксис

.play()
.play(rate)
.play(rate, amp)
.play(rate, pos, amp)
.play(rate, pos, amp, add)
.play(rate, pos, amp, add, cue)

Параметры

rate – относительная скорость проигрывания аудиофайла. Если задать «1», аудиофайл будет проигрываться с обычной скоростью, если «0.5» – скорость проигрывания будет в 2 раза ниже обычной, а частота звука упадет на одну октаву, если «2.0» – скорость проигрывания увеличится в 2 раза, а частота звука возрастет на 1 октаву. Тип данных – float
pos – задает стерео-значение аудиофайла. Значения варьируются от «-1.0» (звук будет звучать только в левом «ухе») до «1.0» (звук будет звучать только в правом «ухе»). Работает только с моно-аудиофайлами! Тип данных – float
amp – задает громкость аудиофайла. Значения варьируются от «0.0» (полная тишина) до «1.0» (полная громкость). Тип данных – float
add – корректирует так называемое «смещение постоянного тока» (от англ. «DC offset»), т.е. смещает звуковую волну на заданное значение относительно нулевого уровня. Более подробно читайте http://wikisound.org/Постоянное_амплитудное_смещение. Тип данных – float
cue – позиция в аудиофайле, с которой нужно начать проигрывание (в секундах). Тип данных – float

Возвращаемое значение

void

Пример

import processing.sound.*;
SoundFile file;

void setup() {
  size(640, 360);
  background(255);
    
  // загружаем аудиофайл из папки «data» скетча
  // и начинаем проигрывать этот аудиофайл:
  file = new SoundFile(this, "sample.mp3");
  file.play();
}

void draw() {
}