<doc>
  <legacy_id>2365</legacy_id>
  <name>record sound</name>
  <type>command</type>
  <syntax>
    <example>record sound file <i>filePath</i></example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Images  Multimedia</category>
  </classification>
  <references>
    <command tag="stop recording">stop recording Command</command>
    <function tag="recordLoudness">recordLoudness Function</function>
    <function tag="recordCompressionTypes">recordCompressionTypes Function</function>
    <property tag="recordSampleSize">recordSampleSize Property</property>
    <property tag="recordChannels">recordChannels Property</property>
    <property tag="recordCompression">recordCompression Property</property>
    <property tag="recordFormat">recordFormat Property</property>
    <property tag="recordRate">recordRate Property</property>
    <property tag="recordInput">recordInput Property</property>
  </references>
  <history>
    <introduced version="1.1">Added.</introduced>
    <changed version="2.0"></changed>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
    <disk access="???"/>
    <privacy/>
  </security>
  <summary>Starts recording from the system's audio input to a <keyword tag="file">file</keyword>.</summary>
  <examples>
    <example>record sound file "Testing"</example>
    <example>record sound file it</example>
  </examples>
  <description>
    <p>Use the <b>record sound</b> <glossary tag="command">command</glossary> to record the user's speech, import sound data from a CD into an audio file, or record music from an external microphone.</p><p/><p><b>Parameters:</b></p><p>The <i>filePath</i> is the <glossary tag="file path">name and location</glossary> of the <keyword tag="file">file</keyword> that will hold the recorded sound data.</p><p/><p><b>Comments:</b></p><p>The <b>record sound</b> <glossary tag="command">command</glossary> uses <glossary tag="QuickTime">QuickTime</glossary> to record.</p><p/><p>While recording is going on, the <b>recording</b> <glossary tag="property">property</glossary> is set to true. To stop recording, use the <command tag="stop recording">stop recording</command> <glossary tag="command">command</glossary> or set the <property tag="recording">recording</property> to false.</p><p/><p>The technical specifications of the recording are determined by the settings of the <b>recordCompression</b>, <property tag="recordChannels">recordChannels</property>, <property tag="recordRate">recordRate</property>, and <property tag="recordSampleSize">recordSampleSize</property> <property tag="properties">properties</property>. The file <function tag="format">format</function> is determined by the <property tag="recordFormat">recordFormat</property> <glossary tag="property">property</glossary>.</p><p/><p><b>Note:</b> If you choose to record to a file that already exists, the record sound command will <i>overwrite</i> the existing file, it will not append the new recording to the end.</p><p/><p><img src="202653"/> <b>Important!</b> If the <property tag="recordFormat">recordFormat</property> is set to "movie", the resulting <keyword tag="file">file</keyword> is in the <glossary tag="QuickTime">QuickTime</glossary> file format. <glossary tag="QuickTime">QuickTime</glossary> files cannot be played as <glossary tag="audio clip">audio clips</glossary>. To play such a sound, either create a <keyword tag="player">player</keyword> and set its <property tag="filename">filenameproperty</property> to the <glossary tag="file path">path</glossary> of the <keyword tag="file">file</keyword> you recorded, or use the play videoclip form of the <b>play</b> <glossary tag="command">command</glossary>.</p><p/><p><b>Changes:</b></p><p>The syntax of the <b>record sound</b> <glossary tag="command">command</glossary> was simplified in version 2.0. In previous versions, specification of sample rate, compression format, and whether to display a settings <glossary tag="dialog box">dialog box</glossary> was included in the <glossary tag="syntax">syntax</glossary> for the <command tag="record sound">record sound</command> <glossary tag="command">command</glossary>. These capabilities are now available using the <command tag="answer record">answer record</command> <glossary tag="command">command</glossary> and the <property tag="recordRate">recordRate</property> and <property tag="recordCompression">recordCompression</property> <property tag="properties">properties</property>.</p><p/><p>The ability to choose the format of the sound file with the <b>recordFormat</b> <glossary tag="property">property</glossary> was introduced in version 2.0. In previous versions, the <b>record sound</b> <glossary tag="command">command</glossary> always produced a <glossary tag="QuickTime">QuickTime</glossary> file.</p>
  </description>
</doc>