_SoundDevice

声音设备类,主要用来管理所有SoundGroup。 全部展开

单例展开

  • + _sd : _SoundDevice

    程序开始时自动创建。脚本中应该使用此对象。

静态属性展开

  • + FadeIn : uint

    渐入的标示。

  • + FadeOut : uint

    渐出的标示。

  • + LinearRolloff : uint

    线性衰减的标志。3D声效默认是指数衰减。

  • + Loop : uint

    循环的标示。

只读属性展开

  • + masterGroup : _SoundGroup

    声音组类。

    • 示例

        sg = _sd.masterGroup
  • + recordEnable : _SoundGroup

    录音功能是否可用,麦克风不存在时返回false。

    • 示例

        print(_rd.recordEnable)

属性展开

  • + autoListener : bool

    为true时会自动根据当前摄像机位置设置3D音效的环境,即不需要调用 setListener,默认为true。

    • 示例

        _sd.autoListener = true
  • + fadeTime : uint

    设置渐入渐出的时间。

    • 示例

       _sd.fadeTime = 5000
  • + maxDistance : float

    默认的声音衰减的终点位置。默认值为2000。对数衰减模式下为不再衰减的距离,线性衰减模式下为衰减到0的位置,即声音传播的最大半径。

    • 示例

        _sd.maxDistance = 2000
  • + minDistance : float

    默认的声音衰减的起始位置,默认值为50。对数衰减模式下每隔该距离声音强度衰减一半,线性衰减模式下为开始衰减的位置。

    • 示例

        _sd.minDistance = 50
  • + mute : bool

    用来控制全局的声音开关。

    • 示例

       _sd.mute = true

构造方法展开

  • + function _SoundDevice() : _SoundDevice

    示例

        sd = _SoundDevice.new()

公共方法展开

  • + function getSoundInfo(String : name) : table

    获取声音文件的信息。

    • 参数
    • name : 声音文件的文件名。
    • 返回
    • 返回一个的表,表中的duration是声音时长,frequency是采样频率,channels是声道数,bits是样点位数,bitrates是平均比特率,type是声音类型。
    • 说明
    • 若返回nil,表示文件不存在或是个非法的声音文件。
  • + function isPlaying() : _bool
    • 返回
    • 设备是否在播放。
      • 示例
    •  sd = _SoundDevice.new()
      print(sd:isPlaying())
  • + function set3DSettings(dopplerscale : number, distancefactor : number, rolloffscale : number)

    3d音效的设置。

    • 参数
    • dopplerscale : doppler效应的比例。当音源接近用户时,假如频率升高太快,则须递减dopplerscale值,反之则须递增dopplerscale值。默认值为1.0。
    • distancefactor : 指定距离的单位。默认值为50.0。
    • rolloffscale : 控制声音衰减的快慢。默认值为1.0。
      • 示例
    •  _sd:set3DSettings(2, 50, 2)
      _sd.fadeTime = 5000
      _sd.autoListener = false
      _sd:setListener(_Vector3.new(0,0,0), _Vector3.new(0,1,0), _Vector3.new(0,0,1))
  • + function setListener(positon : _Vector3, forward : _Vector3, up : _Vector3)

    设置Listener的属性。

    • 参数
    • position : Listener的位置。
    • forward : Listener的朝向。
    • up : Listener的上方向。
    • 示例

       _sd:set3DSettings(2, 50, 2, 50, 2000)
      _sd.fadeTime = 5000
      _sd.autoListener = false
      _sd:setListener(_Vector3.new(0,0,0), _Vector3.new(0,1,0), _Vector3.new(0,0,1))
问题反馈(登录才可以发表哦!)