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

Содержание

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

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

Библиотеки

Примеры

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

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

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

SoundFile

Класс

SoundFile

Описание

Класс SoundFile позволяет проигрывать звуковые файлы и манипулировать ими. Поддерживаются форматы WAV, AIF/AIFF, MP3. На процессорах ARM (Android, Raspberry Pi) декодирование MP3 может проходить очень медленно, поэтому рекомендуем использовать с ними файлы WAV и AIF, которые считаются loseless-форматами (можно перевести как «без потерь»; то есть это форматы, файлы которых создаются с помощью сжатия аудиоданных без потерь).

Методы

• channels() – возвращает количество каналов аудиофайла
• cue() – ставит курсор воспроизведения на заданную позицию аудиофайла
• duration() – возвращает продолжительность аудиофайла (в секундах)
• frames() – возвращает количество кадров этого аудиофайла
• play() – запускает проигрывание аудиофайла; доходит до конца и останавливается
• jump() – перескакивает на заданную позицию аудиофайла, продолжая проигрывание
• pause() – останавливает проигрывание аудиофайла и ставит курсор воспроизведения на текущую позицию, поэтому при следующем вызове play() аудиофайл начнет проигрываться с того места, где был поставлен на паузу
• isPlaying() – проверяет, выполняется ли в сейчас проигрывание аудиофайла
• loop() – запускает циклическое проигрывание аудиофайла; то есть, когда курсор воспроизведения дойдет до конца аудиофайла, его проигрывание начнется сначала
• amp() – меняет громкость этого аудиофайла
• pan() – меняет стерео-значение аудиофайла (работает только с моно-аудиофайлами!)
• rate() – задает скорость проигрывания аудиофайла
• stop() – останавливает проигрывание аудиофайла

Конструктор

SoundFile(parent, path)

Параметры

parent – как правило, используется «this». Тип данных – PApplet
path   – название аудиофайла, который надо загрузить. Тип данных – String

Пример

import processing.sound.*;
SoundFile file;

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

void draw() {
}