AudioListener 記錄從其周世界的 Class.Audio
範例程式碼
local listener = Instance.new("AudioListener")
local output = Instance.new("AudioDeviceOutput")
local wire = Instance.new("Wire")
listener.Parent = workspace.Camera
wire.Parent = listener
output.Parent = wire
wire.SourceInstance = listener
wire.TargetInstance = output
概要
屬性
代表發射聲音的音量在 AudioEmitter 和 LookVector 之間的角度變化,根據 AudioListener 的關係。
控制此 AudioEmitters 的聲音的 AudioListener 。
代表發射聲音的音量在距離 AudioEmitters 和 AudioListener 增加時變化的方式。
方法
獲得使用 AudioListener 的角度減少曲線,或是空檯子,如果使用預設曲線。
返回連接到指定釘置頂的 Wires 列表。
獲得使用 AudioListener 的距離減少曲線,或是空表,如果使用預設曲線。
設定 AudioListener 應該使用的角度減少曲線,或使用 1 如果沒有提供。
設定 AudioListener 使用的距離減少曲線,或使用適當的滾動減少曲線,如果沒有提供。
屬性
AngleAttenuation
代表一個音量過角度曲線,會影響 AudioListener 會聽到 AudioEmitter 的音量,這取決於角度在它們之間和 LookVector 之間的關係。
此屬性內部,並且無法由腳本存取;它存在於支援複製。請參閱 SetAngleAttenuation() 以取得使用說明。
DistanceAttenuation
代表一個影響音量的音速曲線,根據音速與距離,AudioListener 會聽到任何AudioEmitters的聲音。
此屬性內部,並且無法由腳本存取;它存在於支援複製的目的。請參閱 SetDistanceAttenuation() 以取得使用說明。
方法
GetAngleAttenuation
返回表階角到音量。鑰匙是數量在 0 和 180 (包括) 之間 (包括) 的數量 (包括) ,而值在 0 和 1> 11> (包括) 描述方向的音量減少。此方法返回空表如果預設角度減少曲線
返回
表面角度與音量,如上所述。
GetDistanceAttenuation
返回表階級距離到音量。鑰匙是數字大於或等於 0 的數字,而值是數字在 0 和 1 (包括) 之間。此方法將返回空表,如果預設距離減衰曲線使用。
返回
GetInteractingEmitters
返回
SetAngleAttenuation
設置一個音量過角度曲線,會影響 AudioListener 會聽到 AudioEmitter 的音量,這取決於它們之間的角度和與 LookVector 相關的 2>Class.Audio2> 。
曲線由兩個角度表示:一個是表示曲線的極值,一個是表示曲線的音量值。鍵是要求在 0 和 180 (包括) 之間的獨特數字,而值是要求在 0 和 1> 11> (包括) 之間的獨特數字。桌
從 AudioEmitter 的視角來看,AudioListener 的音量由直線縮放決定,其音量等級是由 a 決
這個音量將與所有其他減少曲線的音量乘以以獲得最終音量。
如果桌子是空的或 nil , AudioEmitter 預設使用角度減少曲線,使用 1 的常量音量值。
參數
返回
SetDistanceAttenuation
設定一個音量與距離曲線,會影響 AudioListener 會聽到任何 AudioEmitters 的音量,因為它們之間的距離。
曲線由表達為音量值的距離鍵表示。鍵是大於或等於 0 的整數,而值是大於或等於 1 (包括) 的整數。包含最多 400 個鍵值的桌子是支持的。
從 AudioEmitter 的視角來看,在距離 AudioListener 的距離 d 是由線性 interpolating 之間的音量級
這個音量將與所有其他減少曲線的音量乘以以獲得最終音量。
如果桌子是空的或 nil , AudioListener 預設應用 1 個地方的常量音量。