Type Alias: AuralAlertActivation
AuralAlertActivation =
object
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:81
Data describing how to activate an alert.
Properties
alias?
optional
alias:string
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:93
The alias to use to activate or trigger the alert instead of the alert's registered ID. The alias must be unique.
If an alias is defined, it will be used in place of the alert's registered ID when determining activation or trigger state. Alerts activated or triggered with multiple aliases will play once per alias. In effect, using an alias behaves as if a copy of the aliased alert were temporarily registered with the alias as its ID for as long as the alias is activated/triggered.
continuous?
optional
continuous:boolean
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:129
Whether the alert's sound sequence should loop from the beginning when it is finished playing. If true
, then the
alert effectively has an infinite duration, and once it starts playing it will never stop until forced to do so by
a deactivate, untrigger, or kill command. If not defined, then the alert will loop if and only if it was defined
to do so during registration.
queuedLifetime?
optional
queuedLifetime:number
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:150
The amount of time, in milliseconds, that the alert can remain in the queue before it is automatically removed from the queue. If not defined, then the lifetime defined when the alert was registered will be used.
repeat?
optional
repeat:boolean
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:136
Whether the alert should be requeued after it finishes playing if it is still active. If true
, then the alert
will play continuously while active as long as another alert of higher priority is not queued. If not defined,
then the alert will repeat if and only if it was defined to do so during registration.
sequence?
optional
sequence:string
| readonlystring
[]
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:121
The sequence of sound atoms to play for the alert, as either a single ID or an array of IDs. Each atom is a single sound file. If not defined, then the sequence defined when the alert was registered will be played.
suffix?
optional
suffix:string
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:107
The suffix to append to the alert's ID to activate or trigger the alert. Suffixing an alert ID will generate a
suffixed ID in the form `${uuid}::${suffix}`
. The suffixed ID must be unique.
If a suffix is defined, the suffixed ID will be used to determine activation/triggered state. An alert can be activated or triggered with multiple suffixes. However, it will still only be played once regardless of how many of its suffixes are active or triggered. An alert is considered deactivated or untriggered only when all of its suffixes are deactivated or untriggered.
If both an alias and a suffix are defined, the suffix will be appended to the alias instead of the alert's registered ID.
timeout?
optional
timeout:number
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:144
The amount of time, in milliseconds, after the alert starts playing at which to forcibly stop the alert. It is recommended to set this value to be at least several seconds longer than the expected length of the alert's entire sequence. If the alert is continuous, the timeout is reset with each loop. If not defined, then the timeout defined when the alert was registered will be used.
track?
optional
track:string
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:115
The name of the track on which to play the alert. Each queue has an arbitrary number of tracks. Alerts on different tracks can play at the same time. However, an alert will still wait until all other alerts in the same queue with higher priority are finished playing before it starts playing, even if the other alerts are playing on different tracks. If not defined, then the track defined when the alert was registered will be used.
uuid
uuid:
string
Defined in: src/sdk/utils/sound/AuralAlertSystem.ts:83
The ID of the alert to activate.