record

Record from audio device

Since R2025a

collapse all in page

    Syntax

    record(as)
    record(as,numSamples)

    Description

    record(as) records audio data from the audiostreamer device. Calling record starts a new recording and deletes any recorded data that was not previously read. By default, the function continuously records audio data into the audiostreamer buffer until you call pause or stop. You can read the recorded data from the buffer using the read function.

    example

    record(as,numSamples) records only the specified number of samples of audio.

    Examples

    collapse all

    Open Live Script

    Create an audiostreamer object with the "recorder" mode.

    as = audiostreamer("recorder");

    Call record to start recording with the audiostreamer. The audiostreamer will record continuously until you pause or stop the recording. Use the MATLAB pause function to wait for three seconds, then call stop on the audiostreamer object to stop recording.

    record(as)
pause(3)
stop(as)

    Call read to get all of the available recorded audio from the audiostreamer.

    x = read(as);

    Alternatively, you can call record with a specified number of samples after which the recording will automatically stop. Calling read with the specified number of samples will block MATLAB execution until that number of samples has been recorded.

    N = 3*as.SampleRate; % 3 seconds of samples
record(as,N)
y = read(as,N);

    Input Arguments

    collapse all

    The audiostreamer object used to record the audio.

    Number of audio samples to record, specified as a positive integer.

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    Version History

    Introduced in R2025a

    See Also

    |