• this plugin adds functions to play and controls sounds direct from the xml.
• only this one plugin must be loaded for all sound.
• note - the functions are not available until the plugin was loaded use the plugin onloaded event or the preload="true" plugin setting to verify that!

	Source code
1 2 3 4 5	<plugin name="soundinterface" url="soundinterface.swf" onloaded="action(preloadsounds);" rootpath="." />

• onloaded
  • this action is called when the plugin was loaded and is ready for use.
  • can be used for preloading sound.
• rootpath
  • root path of the sound files
  • relative from the xml file, default=""
  • with krpano 1.0.8 or higher it's possible to use placeholders like %SWFPATH% here
• volume
  • set the global volume for all sounds
  • 0.0 - 1.0, default=1.0
  • can be changed dynamically via actions (set/tween/...)
• mute
  • set the global mute for all sounds
  • true or false, default=false
  • can be changed dynamically via actions (set/switch/...)
  
  

• preloadsound(mp3file);
  • preloads a sound file
  • this can be used to reduce the latency when starting play
  • mp3file = the filename/path of a sound file

• playsound(id, mp3file, loops*, oncomplete*);
  • plays a sound file
  • id = id/name of the sound (use "auto" for a automatic new id for every play)
  • mp3file = the filename/path of a sound file
  • loops = number of loops, 0=endless, default=1 (*optional)
  • oncomplete = action/event that will called on complete (*optional)

• playsound2D(id, mp3file, volume*, pan*, loops*, oncomplete*);
  • plays a sound file with adjustable volume and panning
    
  • id = id/name of the sound (use "auto" for a automatic new id for every play)
  • mp3file = the filename/path of a sound file
  • volume = sound volume (0.0 - 1.0, default=1.0) (*optional)
  • pan = left/right panning (-1.0(=left) - +1.0(=right), default=0.0) (*optional)
    
  • loops = number of loops, 0=endless, default=1 (*optional)
  • oncomplete = action/event that will called on complete (*optional)

• playsound3D(id, mp3file, ath, atv, range*, volume*, loops*, oncomplete*);
  • plays a directional 3D sound
    
  • id = id/name of the sound (use "auto" for a automatic new id for every play)
  • mp3file = the filename/path of a sound file
  • ath = horizontal sound source position (-180 .. 180°)
  • atv = vertical sound source position (-90 .. +90°)
  • range = range of sound (in degrees, default=90) (*optional)
  • volume = sound volume (0.0 - 1.0, default=1.0) (*optional)
  • loops = number of loops, 0=endless, default=1 (*optional)
  • oncomplete = action/event that will called on complete (*optional)

• playsound3DHS(id, mp3file, hotspotname, range*, volume*, loops*, oncomplete*);
  • plays a directional 3D sound at a hotspot position
  • it follows the hotspot if the hotspot is moving
    
  • id = id/name of the sound (use "auto" for a automatic new id for every play)
  • mp3file = the filename/path of a sound file
  • hotspotname = name of the hotspot
  • range = range of sound (in degrees, default=90) (*optional)
  • volume = sound volume (0.0 - 1.0, default=1.0) (*optional)
  • loops = number of loops, 0=endless, default=1 (*optional)
  • oncomplete = action/event that will called on complete (*optional)

• pausesound(id);- pauses a sound
  • id = id/name of the sound

• resumesound(id);- resumes a paused sound
  • id = id/name of the sound

• pausesoundtoggle(id);- pauses OR resumes a sound
  • id = id/name of the sound

• stopsound(id);- stops playing a sound
  • id = id/name of the sound

• stopallsounds();
  • stop all current playing sounds

	Source code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	<plugin name=soundinterface" url="plugins/soundinterface.swf" rootpath="sounds/" /> <hotspot name="s1" url="spot.png" onclick="playsound(auto,tada.mp3);" onover="playsound(auto,over.mp3);" onout="playsound(auto,out.mp3);" /> <hotspot name="s2" url="spot.png" onclick="stopallsounds(); loadpano(next.xml,null,MERGE,BLEND(1)); playsound(auto,newsound.mp3);" />

Quoted from "spacerywitualne"

The left channel is the right channel on our computers. We do not know, if so this has to be... and as to change this.
But...

Quoted from "Virtual Northland"

Klaus or anyone else that has directional audio in effect, would you be so kind as to share the .xml you used in your directional sound example. If I try to load the .xml of the example off the internet it gives me an error. I am have having a little issue with the syntax and would love to see the code in action.

Source code

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

<krpano> <display flash10="off" /> <view fov="90" fovmin="60" fovmax="120" /> <plugin name="soundinterface" url="soundinterface.swf" onloaded="" /> <!-- play sound at 0/0 --> <hotspot name="b1" url="button1.png" ath="0" atv="0" onclick="playsound3D(s1,music1.mp3, 0,0);" /> <!-- play sound at 90/0 - range 120 --> <hotspot name="b2" url="button2.png" ath="90" atv="0" onclick="playsound3D(s2,music2.mp3, 90,0, 120); " /> <!-- play sound at hotspot positon --> <hotspot name="b3" url="button3.png" ath="180" atv="0" onclick="playsound3DHS(s3,music3.mp3, b3);" /> <!-- stop all other sounds, play sound at moving hotspot positon --> <hotspot name="b4" url="button4.png" ath="270" atv="0" onclick="stopallsounds(); playsound3DHS(s4, music4.mp3, b4); tween(ath,630,20);" /> <image> <sphere url="pano.jpg" /> </image> </krpano>