<doc>
	<legacy_id></legacy_id>
	<name>soundFinishedOnChannel</name>
	<type>message</type>

	<syntax>
		<example>soundFinishedOnChannel <i>channel</i>, <i>sound</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sent to the object which played a sound when a sound finishes playing.</summary>

	<examples>
<example>soundFinishedOnChannel theChannel, theSound</example>
<example>soundFinishedOnChannel &quot;queued&quot;, &quot;sounds/warning.mp4&quot;</example>
<example><p>on soundFinishedOnChannel pChannel, pSound</p><p>   put pChannel into field &quot;channel&quot;</p><p>   put pSound into field &quot;finished sound&quot;</p><p>end soundFinishedOnChannel</p></example>
	</examples>

	<history>
		<introduced version="4.6">Introduced</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5">Android support added</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>sound</category>
	</classification>

	<references>
		<function tag="mobileSoundChannelVolume">mobileSoundChannelVolume Function</function>
		<function tag="mobileSoundOnChannel">mobileSoundOnChannel Function</function>
		<function tag="mobileNextSoundOnChannel">mobileNextSoundOnChannel Function</function>
		<function tag="mobileSoundChannels">mobileSoundChannels Function</function>
		<function tag="mobileSoundChannelStatus">mobileSoundChannelStatus Function</function>
		<command tag="mobilePlaySoundOnChannel">mobilePlaySoundOnChannel Command</command>
		<command tag="mobileStopPlayingOnChannel">mobileStopPlayingOnChannel Command</command>
		<command tag="mobilePausePlayingOnChannel">mobilePausePlayingOnChannel Command</command>
		<command tag="mobileResumePlayingOnChannel">mobileResumePlayingOnChannel Command</command>
		<command tag="mobileSetSoundChannelVolume">mobileSetSoundChannelVolume Command</command>
		<command tag="mobileDeleteSoundChannel">mobileDeleteSoundChannel Command</command>
	</references>

	<description>
	<overview>Handle the <b>soundFinishedOnChannel</b> message if you want to perform a task or take an action when a sound finishes playing.</overview>

		<parameters>
  <parameter>
    <name>channel</name>
    <description>The name of the channel the sound was played on.</description>
  </parameter>
  <parameter>
    <name>sound</name>
    <description>The sound file that was played.</description>
  </parameter>		</parameters>

	<value></value>
	<comments>When a sound has finished playing naturally (not stopped or replaced) on a given channel the <b>soundFinishedOnChannel</b> message is sent to the object which played the sound. </comments>
	</description>
</doc>