AudioListener 는 3D 세계에서 주변의 오디오 스트림을 기록합니다(AudioEmitters ).그것은 다른 핀을 통해 출력 핀을 연결할 수 있는 단일 핀을 제공합니다. Wires부모가 Attachment , Camera 또는 PVInstance 인 경우, 부모의 세계 CFrame 가 수신에 사용됩니다.부모가 이러한 클래스 중 하나가 아니면, AudioListener 효과적으로 아무것도 듣지 않습니다.
코드 샘플
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 가 사용해야 하는 거리 감소 곡선을 설정하거나, 제공되지 않으면 역전 롤오프 곡선을 사용합니다.
이벤트
다른 인스턴스가 를 통해 연결되거나 연결 해제되면 발생합니다. 연결되거나 연결 해제되면 발생합니다.
속성
AngleAttenuation
각도와 관련된 볼륨-오버-앤젤 곡선을 나타내며, 이는 서로 간의 각도와 관련된 AudioListener 와 연관된 AudioEmitter 의 소리를 얼마나 크게 들을지에 영향을 줍니다, 그리고 이는 LookVector 와 연관된 AudioListener 에 관련된 것입니다.
이 속성은 내부이며 스크립트에서 액세스할 수 없습니다; 복제를 지원하기 위해 존재합니다. 사용 세부 정보는 SetAngleAttenuation() 참조하십시오.
DistanceAttenuation
서로 사이의 거리에 따라 어떻게 크게 들리는지에 영향을 미치는 볼륨-거리 곡선을 나타냅니다.Represents a volume-over-distance curve that affects how loudly the AudioListener hears any AudioEmitters , based on the distance between them.
이 속성은 내부이며 스크립트에서 액세스할 수 없습니다; 복제를 지원하기 위해 존재합니다. 사용 세부 정보는 SetDistanceAttenuation() 참조하십시오.
SimulationFidelity
메서드
GetAngleAttenuation
테이블 매핑 각도를 볼륨으로 반환합니다.키는 0 와 180 사이의 숫자이며, 값은 0 와 1 사이의 숫자로 볼륨이 방향에 따라 감소하는 방법을 설명합니다.기본 각도 감소 곡선이 사용되는 경우 이 메서드는 빈 테이블을 반환합니다.
반환
위에 설명한 대로 테이블 매핑 각도를 볼륨으로 변환합니다.
GetConnectedWires
지정된 핀하다연결된 배열 Wires 을 반환합니다. AudioListener 에는 "출력" 핀하다하나 있습니다.
매개 변수
반환
GetDistanceAttenuation
테이블 매핑 거리를 볼륨으로 반환합니다.키는 0보다 큰 또는 같은 숫자이며, 값은 0에서 1(포함)까지의 숫자로 볼륨이 거리에서 어떻게 감소하는지 설명합니다.기본 거리 감소 곡선이 사용되는 경우 이 메서드는 빈 테이블을 반환합니다.
반환
GetInteractingEmitters
반환
SetAngleAttenuation
서로 간의 각도와 관련된 음량 위에 각도 곡선을 설정하여 가 어떻게 크게 들을 수 있는지, 그리고 관련된 와 함께 연결된 에 따라 영향을 줍니다.
곡선은 볼륨 값에 대한 테이블 매핑 각도 키로 표시됩니다.키는 0 와 180 (포함) 사이의 고유한 숫자로 예상되며, 값은 0 와 1 (포함) 사이의 숫자로 예상됩니다.최대 400개의 키-값 쌍이 포함된 테이블이 지원됩니다.
각도 AudioEmitter 에서 곡선의 점의 볼륨 레벨을 직선으로 간접 계산하여 결정되며, 각도 값이 직접 위쪽과 아래쪽에 있는 점의 볼륨 레벨과 일치하는 경우 AudioListener 입니다.The volume of a from the perspective of the at an angle a is determined by linearly interpolating between the volume levels for the points on the curve whose angle values are directly above and below a .아래에 a 포인트가 없거나 위에 a 포인트가 없으면 다른 포인트의 용량 수준이 선택됩니다.본질적으로 곡선은 직선으로 연결된 점의 시퀀스이며, 왼쪽과 오른쪽 끝점을 넘어서 곡선은 각각의 볼륨 수준에서 외부로 확장됩니다.
이 볼륨은 모든 다른 공격 곡선의 볼륨(송신 AudioEmitter 포함)과 곱해져서 최종 청취 가능성을 얻습니다.
테이블이 비어 있거나 인 경우, 기본값은 상수 용량 값의 각도 감소 곡선을 사용하도록 설정됩니다.
매개 변수
반환
SetDistanceAttenuation
서로 사이의 거리에 따라 어떻게 크게 들리는지에 영향을 미치는 볼륨-거리 곡선을 설정합니다.Sets a volume-over-distance curve that affects how loudly the AudioListener will hear any AudioEmitters , based on the distance between them.
곡선은 테이블 매핑 거리 키와 볼륨 값으로 표시됩니다.키는 0보다 큰 또는 같은 유일한 숫자로 예상되며, 값은 0에서 1(포함) 사이의 숫자로 예상됩니다.최대 400개의 키-값 쌍이 포함된 테이블이 지원됩니다.
원거리에서 곡선의 점의 볼륨 수준을 직선으로 간접 계산하여 AudioEmitter 의 볼륨 수준 사이에서 볼륨 수준을 결정합니다. The volume of a from the perspective of the AudioListener at a distance d is determined by linearly interpolating between the volume levels for the points on the curve whose distance values are directly above and below d .아래에 d 포인트가 없거나 위에 d 포인트가 없으면 다른 포인트의 용량 수준이 선택됩니다.본질적으로 곡선은 직선으로 연결된 점의 시퀀스이며, 왼쪽과 오른쪽 끝점을 넘어서 곡선은 각각의 볼륨 수준에서 무한대로 확장됩니다.
이 볼륨은 모든 다른 공격 곡선의 볼륨(송신 AudioEmitter 포함)과 곱해져서 최종 청취 가능성을 얻습니다.
테이블이 비어 있거나 nil 이면, AudioListener 모든 곳에 상수 용량을 적용하는 기본값이 됩니다.
매개 변수
반환
이벤트
WiringChanged
연결되거나 연결 해제된 Wire 후 발생하는 이벤트로, Wire 는 현재 또는 이전에 AudioListener 및 다른 연결 가능한 인스턴스에 고정되었거나 고정되었습니다.
매개 변수
인스턴스가 연결되었거나 연결 해제되었는지 여부.
타겟 AudioListener 에 있는 핀은 다음과 같습니다.The pin on the that the Wire targets.
Wire 와 다른 인스턴스 사이의 AudioListener.