Note - the Sound Interface actions are not available until the plugin was loaded.
Either use the plugin onloaded event or use the
preload="true" setting to make sure that the
plugin was loaded and is ready for usage.
The plugin will automatically set keep="true" for itself,
so it is not necessary to set that!
globalstop = true or false, default=false (*optional)
By default only the sounds started by the soundinterface will be stopped,
but with true as parameter also all other flash sounds, e.g. from the videoplayer plugin or
any other source, will be stopped.
When a sound will be played a sound[name] object will be created in krpano.
This object can be dynamically modifed with other krpano actions. The sound object will remove itself automatically
when that sound has played or when stopsound will be called.
For example to tween/change the volume of a sound:
There are additional system limitations on iOS devices (iPhone and iPad):
No Autoplay / Autostart!
A sound can't start to play automatically!
An user interaction is needed to start playing the sound, e.g. a touch on the screen by the user.
The krpano soundinterface plugin automatically detects that situations and when the playing is not possible
it automatically queues the playsound() command and waits for the next user interaction to start the sound
automatically (e.g. when the user touches the screen to pan the pano or to click a button).
Only one sound at one time!
Only one sound file can be played at one time! When there is the new playsound() call the last sound will be automatically stopped.
No volume change!
Changing the volume of a sound is not allowed on iOS devices.