Arma 3 Scripting

directSay

  • Global argument
  • Local effect
  • Arma 3 v0.50
  • First in Arma 2 v1.00

Command · also in Sounds · Markdown · JSON · original wiki page

Description

Sends given audio message to the direct channel. Command operates just like xxxxRadio commands, but the sound is played over direct channel and is independent of fadeSound. The message is defined in CfgRadio in the description.ext file or config radio protocol or a kbAddTopic. The transmission will play only on the PC where command was executed. If you need the transmission to play on all computers, you have to execute it globally (see remoteExec). Use clearRadio to clear chat history

Note

When transmitting unit gets killed, transmission will be interrupted. However when receiving unit gets killed, the transmission continues to play.

Syntax

unit directSay radioName

Parameters:

Returns: Nothing

Examples

Example 1

player directSay configName selectRandom ("true" configClasses (configFile >> "CfgRadio"));

Example 2

An equivalent of a directChat command:

[player, "Hello there", 30] call {
    params ["_unit", "_text", "_distance"];
    [_unit, _text] remoteExec ["globalChat", call BIS_fnc_listPlayers select { _x distance _unit < _distance }];
};

A function can be made for localisation purpose:

/* TAG_fnc_globalChat */
params [
    ["_unit", objNull, [objNull]],
    ["_text", "", [""]]
];

_unit globalChat (_text call BIS_fnc_localize);

// usage
[player, "STR_HelloThere"] remoteExec ["TAG_fnc_globalChat", call BIS_fnc_listPlayers select { _x distance _unit < 30 }];

See also

sideRadio · groupRadio · customRadio · vehicleRadio · globalRadio · commandRadio

Community notes

Killzone_Kid

To transmit user custom sounds (see Multiplayer_Custom_Sounds_Tutorial), prefix the full filename including file extension with #. For example if there is a custom user sound file called MySound.ogg, to play it on the radio use:

player directSay "#MySound.ogg";