UAVControl

Description

Returns array with current operator of UAV and his vehicle role in UAV. If nobody is controlling the UAV, the command tries to find if player has terminal connected to this UAV. If nobody is connected, objNull is used as returned operator (see #Example 2). The possible outputs are:

[objNull, ""] - nobody is controlling UAV but there maybe an abandoned terminal connected to the UAV, which will auto-disconnect when a new connection to the UAV is made
[somePlayer1, "DRIVER"] - some player (could be remote) is a pilot, the gunner seat is empty
[somePlayer2, "GUNNER"] - some player (could be remote) is a gunner, the pilot seat is empty
[somePlayer1, "DRIVER", somePlayer2, "GUNNER"] - some players (could be remote) control both the pilot and the gunner seats
[player, ""] - local player has terminal connected to this UAV

The UAV terminals are local to the players so only local terminal connections are returned.

Note
This command works only for vehicles, to get a unit remote-controlling a unit, see remoteControlled and remoteControl#Example 4.

While main syntax can only return remote players when they are controlling either pilot or gunner, the alternative syntax can also return all remote players connected with terminals to given UAV.

Syntax

Syntax 1

UAVControl uav

Parameters:

uav: Object

Returns: - Array with [unit, vehicleRole]

unit: Object - UAV operator
vehicleRole: String - vehicle role of the operator in UAV. Can be "DRIVER", "GUNNER" or "" (not in control)
Arma 3 v1.96 Array with [unit, vehicleRole, unit2, vehicleRole2] (see #Example 2)
- unit: Object - UAV operator
- vehicleRole: String - vehicle role of the operator in UAV. Can be "DRIVER", "GUNNER" or "" (not in control)
- unit2: Object - see #Example 2
- vehicleRole2: Can be "DRIVER", "GUNNER", or "". (see #Example 2)

Syntax 2

since arma3 2.22

UAVControl [uav, option]

Parameters:

uav: Object - uav vehicle
option: String - output option, could be one of the following:
- "driver" - player controlling UAV pilot
- "gunner" - player controlling UAV gunner
- "crew" - both driver and gunner in that order
- "all" - all the players currently connected to the UAV with their terminals (dead players will show up until they are completely braindead (respawned for example))
- "allbutcrew" - same as "all" but excluding driver and pilot
- "allbutdead" - same as "all" but excluding dead players

Returns: Array - [player1], [player1, player2] or [player1, player2,...playerN]

Examples

Example 1

private _result = UAVControl _myUAV;

Example 2

Since Arma 3 v1.96 this command returns both driver and gunner units if the UAV is controlled by 2 players. Here is the list of all expected outputs:

[player1, "DRIVER"]; // player1 is controlling the UAV and is the pilot
[player2, "GUNNER"]; // player2 is controlling the UAV and is the gunner
[player1, "DRIVER", player2, "GUNNER"]; // player1 is controlling the UAV as the pilot, player2 is controlling the UAV as the gunner
[player3, ""]; // no one is controlling the UAV, player3 is connected to the UAV via terminal, but not controlling it yet
[objNull, ""]; // nobody is controlling but there maybe an abandoned terminal connected to the UAV, 
               // which will auto-disconnect when a new connection to the UAV is made