step

System object: dsp.AudioPlayer
Package: dsp

Write audio to audio output device

Compatibility

The dsp.AudioPlayer object has been removed. Existing instances of the object error out. Replace with audioDeviceWriter object. For more information, see Compatibility Considerations.

Syntax

step(H,AUDIO)
Underrun = step(H,AUDIO)

Description

Note

Starting in R2016b, instead of using the step method to perform the operation defined by the System objectâ„¢, you can call the object with arguments, as if it were a function. For example, y = step(obj,x) and y = obj(x) perform equivalent operations.

step(H,AUDIO) writes one frame of AUDIO samples to the audio output device.

Underrun = step(H,AUDIO) writes one frame of AUDIO samples to the audio output device. The output Underrun indicates the number of zero samples inserted due to queue underrun since the last call to the step method. This syntax applies when you set the OutputNumUnderrunSamples property to true.

Note

obj specifies the System object on which to run this step method.

The object performs an initialization the first time the step method is executed. This initialization locks nontunable properties and input specifications, such as dimensions, complexity, and data type of the input data. If you change a nontunable property or an input specification, the System object issues an error. To change nontunable properties or inputs, you must first call the release method to unlock the object.