_SoundDevice

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

渐入的标示。

• 示例

  print(_SoundDevice.FadeIn)
  

渐出的标示。

• 示例

   print(_SoundDevice.FadeOut)
  

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

• 示例

    print(_SoundDevice.LinearRolloff)
  

循环的标示。

• 示例

   print(_SoundDevice.Loop)
  

声音组类。

• 示例

    sg = _sd.masterGroup
  

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

• 示例

    print(_rd.recordEnable)
  

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

• 示例

    _sd.autoListener = true
  

设置渐入渐出的时间。

• 示例

   _sd.fadeTime = 5000
  

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

• 示例

    _sd.maxDistance = 2000
  

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

• 示例

    _sd.minDistance = 50
  

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

• 示例

   _sd.mute = true
  

示例

    sd = _SoundDevice.new()

获取声音文件的信息。

• 参数
• name : 声音文件的文件名。
• 返回
• 返回一个的表，表中的duration是声音时长，frequency是采样频率，channels是声道数，bits是样点位数，bitrates是平均比特率，type是声音类型。
• 说明
• 若返回nil,表示文件不存在或是个非法的声音文件。

• 返回
• 设备是否在播放。
  • 示例

•  sd = _SoundDevice.new()
   print(sd:isPlaying())
  

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))
  

设置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))