enableChannel: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Added enableChannel site)
 
m (Some wiki formatting)
 
(72 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
______________________________________________________________________________________________


| a3 |= Game name
|game1= arma3
|version1= 1.42


|1.42|= Game version
|eff= local


|gr1= Radio and Chat


__________________________________________________________________________________________
|descr= Enables/disables UI functionality which is responsible for sending text or voice chat to the given chat channel.
{{Feature|informative|
This command:
* can override [[Description.ext]] or [[server.cfg]]'s channel setting
* cannot disable Global channel for the admin or server host, because Global channel is always available for the admin
* does not disable ''incoming'' text or voice
* actively interrupts (since {{arma3}} v2.02) the current communication in progress
* does not affect chat related scripting commands such as [[vehicleChat]], [[globalRadio]] etc.
}}
 
{{{!}} class="wikitable align-center"
! colspan="16" {{!}} [[Channel IDs|Channel ID]] number correspondence
{{!}}-
{{!}} colspan="6" {{!}} Default Channels
{{!}} colspan="10" {{!}} Custom Channels
{{!}}- style="font-size: .9em"
{{!}} Global
{{!}} Side
{{!}} Command
{{!}} Group
{{!}} Vehicle
{{!}} Direct
{{!}} CC 1
{{!}} CC 2
{{!}} CC 3
{{!}} CC 4
{{!}} CC 5
{{!}} CC 6
{{!}} CC 7
{{!}} CC 8
{{!}} CC 9
{{!}} CC 10
{{!}}-
{{!}} 0
{{!}} 1
{{!}} 2
{{!}} 3
{{!}} 4
{{!}} 5
{{!}} 6
{{!}} 7
{{!}} 8
{{!}} 9
{{!}} 10
{{!}} 11
{{!}} 12
{{!}} 13
{{!}} 14
{{!}} 15
{{!}}}
 
|s1= channelID [[enableChannel]] enable


| Enables/disables chat channel
|p1= channelID: [[Number]] - [[Channel IDs|channel ID]]
|= Description
____________________________________________________________________________________________


| '''channel <nowiki>=</nowiki> enableChannel state'''|= Syntax
|p2= enable: [[Boolean]] - [[true]] to enable, [[false]] to disable (both VoN and chat)


|p1= channel: [[Number]] |= Parameter 1
|r1= [[Nothing]]
|p2= state: [[Boolean]] |= Parameter 2


| [[Nothing]] |= Return value
|s2= channelID [[enableChannel]] [chat, VoN]
____________________________________________________________________________________________
 
|x1= <code>0 [[enableChannel]] false; // Disable global channel</code> |= Example 1
____________________________________________________________________________________________


|[[currentChannel]], [[setCurrentChannel]], [[radioChannelAdd]]|= See also
|s2since= arma3 1.60


}}
|p21= channelID: [[Number]] - [[Channel IDs|channel ID]]
 
|p22= chat: [[Boolean]] - [[true]] to enable text chat
 
|p23= VoN: [[Boolean]] - [[true]] to enable voice chat


<h3 style="display:none">Notes</h3>
|r2= [[Nothing]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x1= <sqf>0 enableChannel false; // disable user ability to send voice and text on global channel</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x2= <sqf>0 enableChannel [true, false]; // enable user ability to send text but disable voice on global channel</sqf>


[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
|seealso= [[currentChannel]] [[setCurrentChannel]] [[getPlayerChannel]] [[channelEnabled]] [[radioChannelCreate]]
[[Category:Command_Group:_Radio_Control|{{uc:{{PAGENAME}}}}]]
}}

Latest revision as of 18:10, 5 June 2023

Arma 3 logo black.png1.42
LELocal
Hover & click on the images for description

Description

Description:
Enables/disables UI functionality which is responsible for sending text or voice chat to the given chat channel.
ⓘ
This command:
  • can override Description.ext or server.cfg's channel setting
  • cannot disable Global channel for the admin or server host, because Global channel is always available for the admin
  • does not disable incoming text or voice
  • actively interrupts (since Arma 3 v2.02) the current communication in progress
  • does not affect chat related scripting commands such as vehicleChat, globalRadio etc.
Channel ID number correspondence
Default Channels Custom Channels
Global Side Command Group Vehicle Direct CC 1 CC 2 CC 3 CC 4 CC 5 CC 6 CC 7 CC 8 CC 9 CC 10
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Groups:
Radio and Chat

Syntax

Syntax:
channelID enableChannel enable
Parameters:
channelID: Number - channel ID
enable: Boolean - true to enable, false to disable (both VoN and chat)
Return Value:
Nothing

Alternative Syntax

Syntax:
channelID enableChannel [chat, VoN]
Parameters:
channelID: Number - channel ID
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

See also:
currentChannel setCurrentChannel getPlayerChannel channelEnabled radioChannelCreate

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Retrieved from "https://community.bistudio.com/wiki?title=enableChannel&oldid=341496"