<doc>
	<legacy_id>2024</legacy_id>
	<name>playLoudness</name>
	<type>property</type>

	<syntax>
		<example>set the playLoudness [of {<i>audioClip</i> | <i>player</i>}] to <i>percentage</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies the volume of sounds played by the play command.</summary>

	<examples>
<example>set the playLoudness to 100 <i>-- maximum loudness</i></example>
<example>set the playLoudness of audioclip ID 1054 to 50</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="4.5.2">iOS suppoer added</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Images &amp; Multimedia</category>
	</classification>

	<references>
		<function tag="recordLoudness">recordLoudness Function</function>
		<command tag="beep">beep Command</command>
		<command tag="play">play Command</command>
	</references>

	<description>
	<overview>Use the playLoudness property to set the speaker volume.</overview>

		<parameters>
		</parameters>

	<value>The playLoudness is an integer between zero and 100.<p></p><p>By default, the playLoudness property is a number corresponding to the current system setting.</p></value>
	<comments>Setting the playLoudness to zero turns off sounds.<p></p><p>If no audio clip, video clip, or player is specified, the setting of the playLoudness property applies to all sounds LiveCode makes, including those made with the <command tag="beep">beep</command> and <command tag="play">play</command> commands.</p><p></p><p>Users can manually set the playLoudness of a <object tag="player">player</object> using the slider on the left side of the <object tag="player">player's</object> controller bar, which is visible if the <object tag="player">player's</object> <property tag="showController">showController</property> property is true.</p></comments>
	</description>
</doc>