Channel IDs: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
Line 11: Line 11:
! Channel ID !! Channel Name !! Visibile To !! Additional Information
! Channel ID !! Channel Name !! Visibile To !! Additional Information
|-
|-
|| -1 || None || All players. || Is used when a marker is created with [[createMarker]] and the '''channelID''' parameter was not defined. Markers in "none" channel are visible in all other channels as well.
| -1 || None || All players. |
| Is used when a marker is created with [[createMarker]] and the '''channelID''' parameter was not defined. Markers in "none" channel are visible in all other channels as well.
|-  
|-  
| 0 || Global || All players. ||
| 0 || Global || All players. ||
Line 25: Line 26:
| 5 || Direct || To players in a close distance. ||  
| 5 || Direct || To players in a close distance. ||  
|-
|-
| 6 - 15 || Custom Channels || Content will only be available for players which have been assigned to this channel. See [[radioChannelAdd]] || Custom channels can be created on the fly. See [[radioChannelCreate]].
| 6 - 15 || Custom Channels || Content will only be available for players which have been assigned to this channel. See [[radioChannelAdd]] || Custom channels can be created on the fly. See [[radioChannelCreate]].  
|-
{{Warning|The '''custom channel ID''' returned by [[radioChannelCreate]] is going to be in a range from 1 - 10 (0 if failed). Internally, these numbers are converted to the reserved custom radio '''channel IDs'''  6 - 15.
|}
{{{!}} class{{=}}"wikitable"
{{!}}-
! Custom Channel ID !! Channel ID
{{!}}-
{{!}} 1 {{!}}{{!}} 6
{{!}}-
{{!}} 2 {{!}}{{!}} 7
{{!}}-
{{!}} 3 {{!}}{{!}} 8
{{!}}-
{{!}} 4 {{!}}{{!}} 9
{{!}}-
{{!}} 5 {{!}}{{!}} 10
{{!}}-
{{!}} 6 {{!}}{{!}} 11
{{!}}-
{{!}} 7 {{!}}{{!}} 12
{{!}}-
{{!}} 8 {{!}}{{!}} 13
{{!}}-
{{!}} 9 {{!}}{{!}} 14
{{!}}-
{{!}} 10 {{!}}{{!}} 15
{{!}}} <!--- close inner table --->
}} <!--- close warning template --->
|} <!--- close outer table --->
 
== Custom Channel ID Example ==
{{cc|Create custom channel}}
_customChannelID = [[radioChannelCreate]] [[0.96, 0.34, 0.13, 0.8], "Q-dance Radio", "%UNIT_NAME", <nowiki>[</nowiki>[[player]]]]; {{cc|_customChannelID is 1}}
 
{{cc|Switch current channel of the player to the newly created channel}}.
[[setCurrentChannel]] 6; {{cc|Note the channel ID used here. Even though the ID returned by [[radioChannelCreate]] is 1, we have to use 6 as channel ID. See table above.}}
 
{{cc|Let us use this channel for a message}}
[[player]] [[customChat]] [_customChannelID, "Hi, I am a custom chat message"]; {{cc|Since this command uses the '''customChannelID''' we have to use 1 (_customChannelID) here}}


* Besides the above listed channels, there are also other channels not available through [[sqf]], with the only exception being [[systemChat]].
{{Important|Always be aware of what kind of channel ID you are currently working with and what channel ID is expected by the command you are using. See [[:Category:Command Group: Custom Radio and Chat|Command Group: Custom Radio and Chat]] for commands which expect a customChannelID!}}


<!---
{{Informative|Besides the above listed channels, there are also other channels not available through [[sqf]], with the only exception being [[systemChat]].}}
--->
= Channel Colours =  
= Channel Colours =  
[[File:xChat.jpg|right]]
[[File:xChat.jpg|right]]

Revision as of 15:02, 25 October 2020

Template:SideTOC Template:wip

Introduction

In Arma 3, chat, radio, VON and markers all use the same channel ID system.

Channel Explanation

In the following, 'content' will be used instead of marker, voice or message)

Channel ID Channel Name Visibile To Additional Information
-1 None Is used when a marker is created with createMarker and the channelID parameter was not defined. Markers in "none" channel are visible in all other channels as well.
0 Global All players.
1 Side Content is only visible to the side of the player who created it.
2 Command
3 Group Content is only visible for the players in the group of the player who created it. This channel cannot be disabled. It's the default fallback channel if all other channels are disabled.
4 Vehicle Content is only visible to the vehicle's crew.
5 Direct To players in a close distance.
6 - 15 Custom Channels Content will only be available for players which have been assigned to this channel. See radioChannelAdd Custom channels can be created on the fly. See radioChannelCreate.
⚠
The custom channel ID returned by radioChannelCreate is going to be in a range from 1 - 10 (0 if failed). Internally, these numbers are converted to the reserved custom radio channel IDs 6 - 15.
Custom Channel ID Channel ID
1 6
2 7
3 8
4 9
5 10
6 11
7 12
8 13
9 14
10 15

Custom Channel ID Example

// Create custom channel
_customChannelID = radioChannelCreate [[0.96, 0.34, 0.13, 0.8], "Q-dance Radio", "%UNIT_NAME", [player]]; // _customChannelID is 1

// Switch current channel of the player to the newly created channel.
setCurrentChannel 6; // Note the channel ID used here. Even though the ID returned by radioChannelCreate is 1, we have to use 6 as channel ID. See table above.

// Let us use this channel for a message
player customChat [_customChannelID, "Hi, I am a custom chat message"]; // Since this command uses the customChannelID we have to use 1 (_customChannelID) here
⚠
Always be aware of what kind of channel ID you are currently working with and what channel ID is expected by the command you are using. See Command Group: Custom Radio and Chat for commands which expect a customChannelID!

Channel Colours

xChat.jpg
driver vehicle player sideChat "sideChat";
driver vehicle player globalChat "globalChat";
driver vehicle player groupChat "groupChat";
vehicle player vehicleChat "vehicleChat";
driver vehicle player commandChat "commandChat";
driver vehicle player customChat [1, "customChat"];
systemChat "systemChat";

Changing Channels

Ingame Controls
',' and '.' to cycle through the channels
Scripting
setCurrentChannel

See Also

Retrieved from "https://community.bistudio.com/wiki?title=Channel_IDs&oldid=169256"