This reference is for Processing 3.0+. If you have a previous version, use the reference included with your software in the Help menu. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Core Javadoc and Libraries Javadoc.

Class

SoundFile

Name

play()
Examples
import processing.sound.*;
SoundFile file;

void setup() {
  size(640, 360);
  background(255);
    
  // Load a soundfile from the /data folder of the sketch and play it back
  file = new SoundFile(this, "sample.mp3");
  file.play();
}

void draw() {
}
Description Starts the playback of the soundfile. Only plays to the end of the soundfile once. If cue() or pause() were called previously, playback will resume from the cued position.
Syntax
.play()
.play(rate)
.play(rate, amp)
.play(rate, pos, amp)
.play(rate, pos, amp, add)
.play(rate, pos, amp, add, cue)
Parameters
rate float: relative playback rate to use. 1 is the original speed. 0.5 is half speed and one octave down. 2 is double the speed and one octave up.
pos float: the panoramic position of this sound unit from -1.0 (left) to 1.0 (right). Only works for mono soundfiles!
amp float: the desired playback amplitude of the audiosample as a value from 0.0 (complete silence) to 1.0 (full volume)
add float: offset the output of the generator by the given value
cue float: position in the audiosample that playback should start from, in seconds.
Returnsvoid
Updated on January 1, 2021 03:38:11am EST

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.