Play One Shot (로직스 노드)

Play One Shot
Inputs
	Impulse	Play
	IAssetProvider`1	Clip
	Float	Volume
	Float	Speed
	Bool	Spatialize
	Float	SpatialBlend
	Float3	Point
	Slot	Root
	Int	Priority
	Float	Doppler
	Float	MinDistance
	Float	MaxDistance
	AudioRolloffMode	Rolloff
	AudioTypeGroup	Group
	AudioDistanceSpace	DistanceSpace
	Float	MinScale
	Float	MaxScale
	Bool	ParentUnderRoot
	Bool	LocalOnly
Outputs
	Impulse	OnStartedPlaying

이 노드는 Play에 임펄스가 입력되면 Clip에 연결된 음향파일을 재생합니다. 다른 입력 인자를 통해 재생 관련 설정을 다양하게 하실 수 있습니다.

사용방법

입력

Clip : 재생할 음향파일이 설정된 Audio Clip Input 노드와 연결합니다.

Volume : 재생할 파일의 볼륨을 지정합니다. 기본값은 1이며, 1은 100%를 의미합니다.

Speed : 음향파일을 재생할 속도를 지정합니다. 1이 기본값이며, 마찬가지로 1은 100%를 의미합니다.

Spatialize : 음향이 일정한 공간 내에서만 들려야 하는지 설정합니다. 이후 나오는 SpatialBlend 옵션을 조정하면, 이 설정은 무시될 수 있습니다. 기본값은 True 입니다.

SpatialBlend : 전역으로 음향이 들리는 것과 지정 범위에서 들리는 것의 정도를 지정합니다. 1이 기본값이며 1로 하는 경우 완전하게 지정 범위에서만 들리고, 0으로 하는 경우 월드 전역에서 들리게 됩니다. 이 값은 Spatialize 보다 우선순위가 높습니다.

Point : 음향 방출이 시작되는 좌표를 지정합니다. 이 좌표는 Root에 연결된 슬롯의 로컬 좌표를 기준으로 합니다. 기본값은 [0;0;0] 입니다.

Root : 소리가 재생될 슬롯을 지정합니다. Point가 이에 의존합니다. 기본값은 이 노드의 슬롯 입니다. (즉, 이 노드에서 소리가 발생)

Priority : 월드에 너무 많은 오디오가 재생되면, 몇몇 소리는 묵음처리 됩니다. 이에 대한 우선순위를 설정하여 묵음되는 순서를 정의할 수 있습니다. 0 ~ 256까지 가능하며, 낮은 숫자일수록 우선순위가 높아서 소리가 죽을 확률이 줄어듭니다. 기본값은 균형조정으로 중간값인 128입니다.

Doppler : 도플러 효과의 강도를 지정합니다. 기본값은 1이며, 0으로 설정 하시는 경우 비활성화 됩니다.

MinDistance : 음향이 방출되는 시점부터, 음향이 줄어들기 시작하는 거리를 미터 단위로 지정합니다. 이 옵션은 Rolloff가 Linear인 경우에만 적용됩니다. 또한, 사용자가 느끼는 거리에 대한 절대값은 DistanceSpace에 의해 다를 수 있습니다. 기본값은 1 입니다.

MaxDistance : 음향이 도달되는 최대 거리를 의미합니다. 좀 더 정확히는 MinDistance에 의해 줄어드는 소리의 크기가 아예 들리지 않게되는 거리를 말합니다. 마찬가지로 미터 단위를 사용하고, Rolloff가 Linear인 경우에만 적용됩니다. 또한, 사용자가 느끼는 거리에 대한 절대값은 DistanceSpace에 의해 다를 수 있습니다. 기본값은 500 입니다.

Rolloff : 거리에 따라 변경될 음량의 리듬을 선택합니다. 기본값은 로그(Logarithmic)형 그래프의 흐름을 따릅니다. 만약, MinDistance와 MaxDistance을 통해 제어를 하시고자 한다면, 선형(Linear) 모델을 선택하세요.

Group : 재생될 소리의 분류를 지정합니다. 기본값은 Sound Effects입니다. 이 옵션을 통해 네오스 설정의 오디오 볼륨 설정의 영향을 받을 분류를 지정할 수 있습니다.

DistanceSpace : 축척이나 거리값이 전역(Global) 기준으로 계산될지, 지역(Local) 기준으로 계산될지 선택합니다. 기본값은 Global 입니다.

The MinScale input determines the MinScale field value on the spawned AudioOutput.

The MaxScale input determines the MaxScale field value on the spawned AudioOutput.

ParentUnderRoot : 이 노드는 음향 재생시 "OneShotAudio"라는 슬롯을 자동으로 생성하여, 소리를 발생시킵니다. 이 슬롯이 배치될 위치를 월드의 root 슬롯으로 할지 말지를 결정합니다. False로 하는 경우 Root에 입력된 슬롯으로 지정됩니다. 기본값은 True 입니다.

LocalOnly : 소리가 들릴 사용자를 Play 임펄스를 발생시킨 사용자에게 한정시킬지 결정합니다. 기본값은 False 입니다.

출력

OnStartedPlaying : Play를 통해 임펄스가 들어오고 Clip의 파일이 정상적으로 재생을 시작하면 임펄스가 발생합니다. 반대로 말하면 Clip에 연결된 대상이 존재하지 않는 경우, 임펄스가 발생하지 않습니다.

일러두기

Play를 통해 임펄스가 수신되면, 저장되지 않는 슬롯인 "OneShotAudio"이 지정된 옵션의 위치에 생성되고 소리의 재생이 완료되면 자동으로 삭제됩니다. 이 슬롯은 AudioOutput, AudioClipPlayer, StoppedPlayableCleaner 구성요소로 이루어져 있습니다.

이 노드는 임펄스가 발생하면 오디오의 재생이 끝까지 이루어져야 할때 사용하기 좋은 옵션입니다. 다만, 소리의 재생시 슬롯과 컴포넌트를 생성하고 삭제 하는 작업이 동반되므로, 매우 빠르고 연속적으로 발생되는 소리를 재생(예. 자동소총 같은)할 경우 많은 트래픽을 유발합니다. 이런 상황에서는 AudioOutput 및 AudioClipPlayer를 사용하고 로직스의 Playback 항목에 있는 노드를 사용하는 편이 더 좋은 선택이 될 수 있습니다.

노드 메뉴(Node Menu)

Audio
Back	Audio Clip Input	Play One Shot	Play One Shot & Wait