_SoundGroup

声音组类,用来播放声音文件。主要功能包括声音的播放、停止、音量的调整、静音等功能。 全部展开

属性展开

  • + mute : bool

    静音

    • 示例

       soundGroup = _SoundGroup.new()
      soundGroup.mute = true
  • + volume : number

    音量

    • 示例

       soundGroup = _SoundGroup.new()
      soundGroup.volume = 0.5

构造方法展开

  • + function _SoundGroup() : _SoundGroup

    示例

        sg = _SoundGroup.new()

公共方法展开

  • + function isPlaying() : bool

    是否正在播放。

    • 示例

       soundGroup = _SoundGroup.new()
      print(soundGroup:isPlaying())
  • + function play(filename : string/_SoundRecord, [type : uint], [postion : _Vector3], [minditance : float], [maxdistance : float], [volume : float])

    开始播放。

    • 参数
    • filename : 播放的声音文件名,或者声音录制对象。
    • type : 播放方式,值应为_SoundDevice的静态属性值。
    • pos : 当播放方式为3D方式时,声音播放的位置。
    • mindistance :3D声音的最小衰减距离。
    • maxdistance :3D声音的最大衰减距离。
    • volume :声音的播放时的音量。

    • 示例

       soundGroup = _SoundGroup.new()
      soundGroup:play('fight.mp3') //播放2d声音
      soundGroup:play('fight.mp3', _SoundDevice.Loop) //循环播放2d声音
      soundGroup:play('fight.mp3', 0, _Vector3.new(0, 0, 0)) //播放3d声音
      soundGroup:play('fight.mp3', 0, _Vector3.new(0, 0, 0), 50, 1000) //播放3d声音,并设置声音衰减距离
      soundGroup:play('fight.mp3', 0, _Vector3.new(0, 0, 0), 0.5) //播放3d声音,并设置声音音量
      soundGroup:play('fight.mp3', 0, _Vector3.new(0, 0, 0), 50, 1000,0.5) //播放3d声音,并设置声音音量和衰减距离
  • + function playBuffer(sbuffer : string, [type : uint[, postion : _Vector3]])

    开始播放。

    • 参数
    • sbuffer : 声音buffer,可以通过声音录制得到。
    • type : 播放方式,值应为_SoundDevice的静态属性值。
    • pos : 当播放方式为3D方式时,声音播放的位置。
  • + function stop([type : uint])

    停止播放。

代码示例

    sg = _SoundGroup.new()
    _app:onKeyDown(function(key)
    if key == _System.KeyA then
    sg:stop(_SoundDevice.FadeOut)
    sg:play('fight.mp3', _SoundDevice.FadeIn + _SoundDevice.Loop)
    elseif key == _System.KeyB then
    sg:stop(_SoundDevice.FadeOut)
    end
    end)
问题反馈(登录才可以发表哦!)