Page tree
Skip to end of metadata
Go to start of metadata



Introduced in

Version:3.4

Description

Description:

Returns AAR contact information for a specific unit or side.

A "contact" is an event, where one unit fires at another unit.

Contact data is similar to AARgetStat, but contains more details.

As long as a unit fires at the same target, and with the same ammunition, the data is added into the same contact collection.

A new contact collection starts in the following situations:

  • The shooter engages a different target (if a vehicle with multiple occupants is destroyed with a single shot, separate contact events are created - one for each occupant, and one for the vehicle itself).
  • The shooter fires with a different ammo type.
  • There was a delay of at least 1 second since the last shot.
  • A new selection / compartment is hit.

Syntax

Syntax:AARGetContacts element
Parameters:
  • element: Object or Side-2 - Unit or side for which to return statistics (only infantry units can be specified, vehicle crew actions must be determined using the Side-2 collection).
Return Value:Array of Number - Index numbers identifying the individual contacts.

Alternative Syntax

Syntax:AARGetContacts [element, start, end]
Parameters:
  • element: Object or Side-2 - Unit or side for which to return statistics (only infantry units can be specified).
  • start: Number - Earliest timestamp in recording to consider (as long as a contact ends after this timestamp - even if it starts before - it is included).
  • end: Number - Latest timestamp in recording to consider (as long as a contact started before this timestamp - even if it ends afterwards - it is included).
Return Value:Array of Number - Index numbers identifying the individual contacts.

Examples

Examples:Gets all contacts for BLUFOR units:
AARGetContacts west

Gets all contacts for OPFOR units which happened within the first 60 seconds:
AARGetContacts [east,0,60]

Additional Information

See also: AARGetContactData, AARgetStat
Multiplayer: 
Problems: 

Notes