Sound Interface声音插件中文说明-小站

插件说明：

声音插件可以让krpano增加声音、音乐和在xml文件中对声音进行控制.

插件必须一次加载全部音乐，没缓存加载. 通过插件动作控制声音播放和停止.

HTML5 / iOS (iPhone/iPad) 不定一定可以播放mp3和mp4文件，可以用ogg或wav文件同时加载保证播放成功.

语法：

<plugin name="soundinterface"
        url.flash="soundinterface.swf"
        url.html5="soundinterface.js"
        preload="true"
        rootpath=""
        volume="1.0"
        mute="false"
        />

插件属性：

•rootpath  (可选)
◦设置音乐文件默认路径，设置后播放音乐是不需要重复设置完整路径
◦例如可以设置为%SWFPATH%
•volume  (可选)
◦声量大小控制
◦0.0 - 1.0, default=1.0
◦可通过动作动态调整，如(set(), tween(), ...)
 
•mute  (可选)
◦设置消声
◦true or false, default=false
◦可以动态通过动作控制，如 (set(), ...)

插件动作：

声音插件可以在krpano中全局调用.
•preloadsound(audiofile)
◦预加载一个音乐文件
◦可以减少加载延迟的感觉
◦audiofilefile = 预加载的路径
 
•playsound(name, audiofile, loops*, oncomplete*)
◦播放一个音乐文件的动作，最常用
◦name = 定义一个播放音乐的名称或id(可以用"auto"表示自动生成一个id)
◦audiofile = 音乐文件的路径
◦loops = 播放完成后循环播放次数, 0=不循环, default=1 (*可选)
◦oncomplete = 音乐文件播放完成后执行的动作(*可选)
 
•playsound2D(name, audiofile, volume*, pan*, loops*, oncomplete*)  (Flash only)
◦播放动作，但可以调整音量和左右声道控制，只支持flash
◦name = 定义一个播放音乐的名称或id(可以用"auto"表示自动生成一个id) 
◦audiofile = 音乐文件的路径 
◦volume = 设定音量(0.0 - 1.0, default=1.0) (*可选)
◦pan = 左右声道控制，负数是左声道，整数是右声道(-1.0(=left) - +1.0(=right), default=0.0) (*可选)
◦loops = 播放完成后循环播放次数, 0=不循环, default=1 (*可选) ◦oncomplete = 音乐文件播放完成后执行的动作(*可选)
 
•playsound3D(name, audiofile, ath, atv, range*, volume*, loops*, oncomplete*)  (Flash only)
◦播放一个有3D环绕效果的音乐
◦name = 定义一个播放音乐的名称或id(可以用"auto"表示自动生成一个id) 
◦audiofile = 音乐文件的路径 
◦ath = 设置声音源头水平方向坐标(-180 .. 180)
◦atv = 设置声音源头上下方向坐标(-90 .. +90)
◦range = 声音可以听到的扇面范围 (角度, default=90) (*可选)
◦volume = 设定音量(0.0 - 1.0, default=1.0) (*可选)
◦loops = 播放完成后循环播放次数, 0=不循环, default=1 (*可选) 
◦oncomplete = 音乐文件播放完成后执行的动作(*可选)
 
•playsound3Dh(name, audiofile, ath, range*, volume*, loops*, oncomplete*)  (Flash only)
◦播放一个有3D环绕效果的音乐在一个给定的水平位置
◦独立于垂直方向
◦name = 定义一个播放音乐的名称或id(可以用"auto"表示自动生成一个id) 
◦audiofile = 音乐文件的路径 
◦ath = 设置声音源头水平方向坐标(-180 .. 180) 
◦atv = 设置声音源头上下方向坐标(-90 .. +90) 
◦range = 声音可以听到的扇面范围 (角度, default=90) (*可选)
◦volume = 设定音量(0.0 - 1.0, default=1.0) (*可选)
◦loops = 播放完成后循环播放次数, 0=不循环, default=1 (*可选) 
◦oncomplete = 音乐文件播放完成后执行的动作(*可选)
 
•playsound3DHS(name, audiofile, hotspotname, range*, volume*, loops*, oncomplete*)  (Flash only)
◦播放一个有3D环绕效果的音乐在一个给定的热点位置
◦当然热点移动，声音会跟随移动
◦name = 定义一个播放音乐的名称或id(可以用"auto"表示自动生成一个id) 
◦audiofile = 音乐文件的路径 
◦hotspotname = 热点名称
◦range = 声音可以听到的扇面范围 (角度, default=90) (*可选)
◦volume = 设定音量(0.0 - 1.0, default=1.0) (*可选)
◦loops = 播放完成后循环播放次数, 0=不循环, default=1 (*可选) 
◦oncomplete = 音乐文件播放完成后执行的动作(*可选)
 
•pausesound(name)
◦暂停一个声音
◦name = 播放声音时已定义的ID
 
•resumesound(name)
◦恢复一个已暂停的声音
◦name = 播放声音时已定义的ID 
 
•pausesoundtoggle(name)
◦切换暂停或恢复的状态
◦name = 播放声音时已定义的ID 
 
•stopsound(name)
◦停止一个声音，领主tips:停止后无法恢复，只能用play...动作重头播放
◦name = 播放声音时已定义的ID 
 
•stopallsounds(globalstop*)
◦停止所有已在播放的音乐
◦globalstop = true or false, default=false (*可选)
该动作有可能让flash模式下的其他声音如videoplayer插件播放的声音也同时停止.

THE END