API Docs for: 2.7.1
Show:

Activity Class

Extends BaseSound
Module: Models

A model plays back the source at various speeds based on the movement of the activity parameter.

Constructor

Activity

(
  • [context]
  • [source]
  • [onLoadProgress]
  • [onLoadComplete]
  • [onAudioStart]
  • [onAudioEnd]
)

Parameters:

  • [context] AudioContext optional

    AudioContext to be used.

  • [source] Array/String/AudioBuffer/File optional

    Single or Array of either URLs or AudioBuffers or File Object of the audio source.

  • [onLoadProgress] Function optional

    Callback when the audio file is being downloaded.

  • [onLoadComplete] Function optional

    Callback when the source has finished loading.

  • [onAudioStart] Function optional

    Callback when the audio is about to start playing.

  • [onAudioEnd] Function optional

    Callback when the audio has finished playing.

Methods

connect

(
  • destination
  • [output]
  • [input]
)

Inherited from BaseSound

If the parameter output is an AudioNode, it connects to the releaseGainNode. If the output is a BaseSound, it will connect BaseSound's releaseGainNode to the output's inputNode.

Parameters:

  • destination AudioNode

    AudioNode to connect to.

  • [output] Number optional

    Index describing which output of the AudioNode from which to connect.

  • [input] Number optional

    Index describing which input of the destination AudioNode to connect to.

disconnect

(
  • [outputIndex]
)

Inherited from BaseSound

Disconnects the Sound from the AudioNode Chain.

Parameters:

  • [outputIndex] Number optional

    Index describing which output of the AudioNode to disconnect.

listParams

(
  • [paramArray]
)

Inherited from BaseSound:

List all SPAudioParams this Sound exposes

Parameters:

  • [paramArray] Array optional

    Array of all the SPAudioParams this Sound exposes.

pause

()

Inherited from BaseSound

Pause the currently playing source at the current position.

play

(
  • [when]
)

Inherited from BaseSound

Enable playback.

Parameters:

  • [when] Number optional

    At what time (in seconds) the source be triggered

release

(
  • [when]
  • [fadeTime]
)

Inherited from BaseSound

Linearly ramp down the gain of the audio in time (seconds) to 0.

Parameters:

  • [when] Number optional

    Time (in seconds) at which the Envelope will release.

  • [fadeTime] Number optional

    Amount of time (seconds) it takes for linear ramp down to happen.

setOutputEffect

(
  • effect
)

Inherited from BaseSound:

Adds an sound effect to the output of this model, and connects the output of the effect to the Audio Destination

Parameters:

  • effect Object

    An Sound Effect of type BaseEffect to be appended to the output of this Sound.

setSources

(
  • source
  • [onLoadProgress]
  • [onLoadComplete]
)

Inherited from BaseSound

Reinitializes a Activity and sets it's sources.

Parameters:

  • source Array/AudioBuffer/String/File

    Single or Array of either URLs or AudioBuffers of audio sources.

  • [onLoadProgress] Function optional

    Callback when the audio file is being downloaded.

  • [onLoadComplete] Function optional

    Callback when all sources have finished loading.

start

(
  • when
  • [offset]
  • [duration]
  • [attackDuration]
)

Inherited from BaseSound

Start playing after specific time and from a specific offset.

Parameters:

  • when Number

    The delay in seconds before playing the model

  • [offset] Number optional

    The starting position of the playhead

  • [duration] Number optional

    Duration of the portion (in seconds) to be played

  • [attackDuration] Number optional

    Duration (in seconds) of attack ramp of the envelope.

stop

(
  • when
)

Inherited from BaseSound

Stops the source and resets play head to 0.

Parameters:

  • when Number

    Time offset to stop

Properties

action

SPAudioParam

Controls the playback of the source. The more this parameter is moved, the higher the speed of playback.

Default: 0

audioContext

AudioContext

Inherited from BaseSound:

Web Audio API's AudioContext. If the context passed to the constructor is an AudioContext, a new one is created here.

destinations

Array

Inherited from BaseSound:

Set of nodes the output of this sound is currently connected to.

easeIn

SPAudioParam

Rate of increase of Play Speed. It is the time-constant value of first-order filter (exponential) which approaches the target speed set by the playSpeed property.

Default: 1

easeOut

SPAudioParam

Rate of decrease of Play Speed. It is the time-constant value of first-order filter (exponential) which approaches the target speed set by the playSpeed property.

Default: 1

inputNode

Object

Inherited from BaseSound:

The input node that the output node will be connected to.
Set this value to null if no connection can be made on the input node

Default: null

isInitialized

Boolean

Inherited from BaseSound:

If Sound is currently initialized.

Default: false

isPlaying

Boolean

Inherited from BaseSound:

If Sound is currently playing.

Default: false

maxSources

Number

Inherited from BaseSound:

Maximum number of sources that can be given to this Sound

Default: 0

maxSpeed

SPAudioParam

Maximum value at which the playback speed of the source will be capped to.

Default: 1

minSources

Number

Inherited from BaseSound:

Minimum number of sources that can be given to this Sound

Default: 0

modelName

String

Inherited from BaseSound:

String name of the model.

Default: "Model"

numberOfInputs

Number

Inherited from BaseSound:

Number of inputs

Default: 0

numberOfOutputs

Number

Inherited from BaseSound:

Number of outputs

Default: 0

onAudioEnd

Function

Inherited from BaseSound:

Callback for the audio is about to stop playing.

Default: null

onAudioStart

Function

Inherited from BaseSound:

Callback for when the audio is about to start playing.

Default: null

onLoadComplete

Function

Inherited from BaseSound:

Callback for when loading of audio files is done and the the model is initalized.

Default: null

onLoadProgress

Function

Inherited from BaseSound:

Callback for handling progress events thrown during loading of audio files.

Default: null

releaseGainNode

GainNode final

Inherited from BaseSound:

Release Gain Node

Default: Internal GainNode

sensitivity

SPAudioParam

Maximum value for random pitch shift of the triggered voices in semitones.

Default: 0.5