Difference between revisions of "Play One Shot (LogiX node)/ko"
Line 55: | Line 55: | ||
− | <code>Doppler</code> : 도플러 효과의 강도를 지정합니다. 기본값은 1이며, 0으로 하시는 경우 비활성화 됩니다. | + | <code>Doppler</code> : 도플러 효과의 강도를 지정합니다. 기본값은 1이며, 0으로 설정 하시는 경우 비활성화 됩니다. |
Revision as of 02:15, 19 April 2022
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으로 설정 하시는 경우 비활성화 됩니다.
The MinDistance
input determines the distance (in metres) from the sound source at which volume rolloff begins. This only takes effect if the Rolloff
value is Linear. Note that this input value is scaled depending on the DistanceSpace
input - if that is set to Global then the MinDistance value is interpreted in global coordinate space, if set to Local it is interpeted in local coordinate space which may then be affected by the scale of the audio output. Default is 1.
The MaxDistance
input determines the distance (in metres) from the sound source at which volume rolloff ends and the sound becomes inaudible. This only takes effect if the Rolloff
value is Linear. Note that this input value is scaled depending on the DistanceSpace
input - if that is set to Global then the MinDistance value is interpreted in global coordinate space, if set to Local it is interpeted in local coordinate space which may then be affected by the scale of the audio output. Default is 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 |