Play One Shot (LogiX node)/ko

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 입니다.

The Rolloff input determines the volume rolloff mode used for the audio output. This must be set to Linear for MinDistance and MaxDistance to take effect. Default is Logarithmic.

The Group input determines what volume group the played audio is categorized under. Default is Sound Effects.

The DistanceSpace input determines whether scale and distance values are interpreted relative to global coordinates or local coordinates. Default is 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.

The ParentUnderRoot input determines whether the spawned "OneShotAudio" slot is parented directly under the input Root slot. If set to False, the "OneShotAudio" slot will be parented under the world root slot. Default is True.

The LocalOnly input determines whether the played audio will only be audible for the local user who owns the impulse arriving at Play. Default is False.

Outputs

The OnStartedPlaying output fires an impulse when the one shot audio has started playing as a result of an impulse at Play. This fires as long as a valid Clip input is present and continues the impulse chain which arrived at Play.

Notes

When an impulse is received at Run, and a valid Clip is available, a new non-persistent slot is spawned called "OneShotAudio" with AudioOutput, AudioClipPlayer, and StoppedPlayableCleaner components. This slot is automatically deleted when playback ends.

Play One Shot is an excellent playback option for audio which should play to completion after some trigger. This is because it prevents cluttering the limited audio buffer unless the relevant sound effect is actually playing. Play One Shot may not be ideal for situations where triggers occur extremely rapidly (e.g. in the case of an automatic weapon) due to the network traffic required to spawn and delete slots and components. In situations like those, consider using a persistent AudioOutput and AudioClipPlayer and using nodes under Category:LogiX:Playback instead.

Node Menu

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