record sound

Starts recording from the system's audio input to a file.

# Metadata

Platforms: desktop OS: mac Introduced: 1.1 Security: disk, privacy

# Syntax

record sound file filePath

# Params

- filePath : The name and location of the file that will hold the recorded sound data.

# Examples

record sound file "Testing"

record sound file it

# Description

Use the record sound command to record the user's speech, import sound data from a CD into an audio file, or record music from an external microphone.

While recording is going on, the recording property is set to true. To stop recording, use the stop recording command or set the recording to false.

The technical specifications of the recording are determined by the settings of the recordCompression, recordChannels, recordRate, and recordSampleSize properties. The file format is determined by the recordFormat property.

>*Note:* If you choose to record to a file that already exists, the > record sound command will overwrite the existing file, it will not > append the new recording to the end.

# Tags

multimedia,

# See

- **keyword:** file, player - **property:** filename, properties, recording, recordCompression, recordSampleSize, recordChannels, recordFormat, recordInput, recordRate - **command:** play, stop recording - **function:** recordLoudness, format, recordCompressionTypes - **glossary:** property, audio clip, file path, command