enableChannel

From Bohemia Interactive Community
Jump to: navigation, search
Introduced with Arma 3 version 1.42
  Effects of this scripting command are not broadcasted over the network and remain local to the client the command is executed on

Click on the images for descriptions

Introduced in

Game:
Arma 3
Version:
1.42

Description

Description:
Enables/disables UI functionality which is responsible for sending text or voice chat to the given chat channel. If the channel was disabled in description.ext, it can be enabled with this command, however the UI functionality changes will be local to the PC executing this command. What this command cannot do:
  • It cannot disable incoming text or voice
  • It cannot interrupt own client's transmission in progress
  • It cannot affect any Custom Radio channels, only channels 0-5
  • It cannot persist, so if user is logged out, the changes are reset
  • It has no effect on chat related scripting commands, such as vehicleChat, globalChat, globalRadio, sideRadio, etc.
So in short, just like with getPlayerChannel, this command provides a nice ability to hack into chat UI with some limitations. And the reason why it is possible to disable entire channels (except Group) in description.ext, is because no one can talk or text, therefore no transmission is happening. NOTE: Group channel cannot be disabled, neither with enableChannel, nor with description.ext param. Channel / Number correspondence:
  • 0 = Global
  • 1 = Side
  • 2 = Command
  • 3 = Group
  • 4 = Vehicle
  • 5 = Direct
  • 6-15 = Custom Radio (Is not supported by enableChannel)

Syntax

Syntax:
channel enableChannel enable
Parameters:
channel: Number
enable: Boolean - enable both VoN and chat
Return Value:
Nothing

Alternative Syntax

Syntax:
channel enableChannel [chat, VoN]         since Arma 3 v1.59.135661
Parameters:
channel: Number
[chat, VoN]: Array
chat: Boolean - true to enable text chat
VoN: Boolean - true to enable voice chat
Return Value:
Nothing

Examples

Example 1:
0 enableChannel false; // Disable user ability to send voice and text on global channel
Example 2:
0 enableChannel [true, false]; // Enable user ability to send text but disable voice on global channel

Additional Information

Multiplayer:
-
See also:
currentChannelsetCurrentChannelgetPlayerChannelchannelEnabledradioChannelCreate

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

Notes

Bottom Section

Posted on June 17, 2016 - 21:48 (UTC)
AgentRev
If the user is admin, global channel is fully enabled, regardless of this command.
Posted on July 30, 2016 - 15:46 (UTC)
Lucian
Alternative Syntax supports Custom Radio Channels