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 입니다.
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.
Examples
Node Menu
Audio | ||||||
---|---|---|---|---|---|---|
Back | Audio Clip Input | Play One Shot | Play One Shot & Wait |