插件说明:
- •声音插件可以让krpano增加声音、音乐和在xml文件中对声音进行控制.
- •插件必须一次加载全部音乐,没缓存加载. 通过插件动作控制声音播放和停止.
- •HTML5 / iOS (iPhone/iPad) 不定一定可以播放mp3和mp4文件,可以用ogg或wav文件同时加载保证播放成功.
语法:
1 2 3 4 5 6 7 8 |
<plugin name="soundinterface" url.flash="soundinterface.swf" url.html5="soundinterface.js" preload="true" rootpath="" volume="1.0" mute="false" /> |
插件属性:
1 2 3 4 5 6 7 8 9 10 11 12 |
•rootpath (可选) ◦设置音乐文件默认路径,设置后播放音乐是不需要重复设置完整路径 ◦例如可以设置为%SWFPATH% •volume (可选) ◦声量大小控制 ◦0.0 - 1.0, default=1.0 ◦可通过动作动态调整,如(set(), tween(), ...) •mute (可选) ◦设置消声 ◦true or false, default=false ◦可以动态通过动作控制,如 (set(), ...) |
插件动作:
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 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 |
声音插件可以在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插件播放的声音也同时停止. |