案例展示 开发工具 文档 教程 在线开发
登录 注册

_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)
问题反馈（登录才可以发表哦！）