Difference between revisions of "getPlayerUID"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:ArmA 2: New Scripting Commands List\|{{uc:{{PAGENAME}}}}\]\]\s*" to "")
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
+
{{Command|Comments=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| arma2 |= Game name
+
| arma2 |Game name=
  
|1.02|= Game version
+
|1.02|Game version=
 +
 
 +
|arg= global |Multiplayer Arguments=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
|  Return an uniqueID of the given unit as string if it's player and empty value if it's AI. The uniqueID may be up to 100 characters long and may contain numbers, uppercase letters and underscores (the value can be used to construct a valid variable name by appending to another valid variable name).
+
|  Return an uniqueID of the given unit as string if it's player and empty value if it's AI. The unique ID may be up to 100 characters long and may contain numbers, uppercase letters and underscores (the value can be used to construct a valid variable name by appending to another valid variable name).
 
+
<br><br>
Note: while for [[ArmA 2]] or [[ArmA 2: Operation Arrowhead]] until version 1.60 the result always contains a number, it should be always handled as an opaque string. Converting it to a [[Number]] can cause precision problems, as Number cannot accurately represent integers above 16777216 (2^24). Moreover, game versions since [[ArmA 2: Operation Arrowhead]] 1.61 provide a non-numeric value as a result.|= Description
+
Note: while for [[ArmA 2]] or [[ArmA 2: Operation Arrowhead]] until version 1.60 the result always contains a number, it should be always handled as an opaque string. Converting it to a [[Number]] can cause precision problems, as Number cannot accurately represent integers above 16777216 (2^24). Moreover, game versions since [[ArmA 2: Operation Arrowhead]] 1.61 provide a non-numeric value as a result.<br/>
 +
<br/>
 +
{{warning | In some cases, the identity of certain player units might fail to propagate to other clients and the server, which causes [[isPlayer]] and [[getPlayerUID]] to incorrectly return <tt>[[false]]</tt> and <tt>""</tt>, respectively, where the affected units are [[not]] [[local]].<ref>https://github.com/michail-nikolaev/task-force-arma-3-radio/issues/1096</ref> Therefore, beware of false negatives.}} |DESCRIPTION=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| '''getPlayerUID''' unit |= Syntax
+
| '''getPlayerUID''' unit |SYNTAX=
 
 
|p1= unit: [[Object]] |= PARAMETER1
 
  
|p2= |= PARAMETER2
+
|p1= unit: [[Object]] |PARAMETER1=  
  
|p3= |= PARAMETER3
+
|p2= |PARAMETER2=  
  
| [[String]] |= RETURNVALUE
+
|p3= |PARAMETER3=  
  
 +
| [[String]] ("_SP_AI_", "_SP_PLAYER_" in SP, "" or UID number string in MP)
 +
|RETURNVALUE=
  
|x1= <code>_uid <nowiki>=</nowiki> '''getPlayerUID''' [[player]];</code> |= Example 1
+
|x1= <code>_uid <nowiki>=</nowiki> '''getPlayerUID''' [[player]];</code> |EXAMPLE1=
  
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| [[getplayeruidold]] |= SEEALSO
+
| [[getPlayerUIDOld]], [[getClientState]], [[getClientStateNumber]] |SEEALSO=  
  
|mp= UID string is returned only in multiplayer.  |= MPBEHAVIOUR
+
|mp=   |MPBEHAVIOUR=  
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
 
}}
 
}}
Line 42: Line 46:
  
 
<h3 style='display:none'>Bottom Section</h3>
 
<h3 style='display:none'>Bottom Section</h3>
[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
+
 
 
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]

Revision as of 18:08, 19 September 2019

Template:Command

Notes

Posted on April 17, 2014 - 22:29
Master85 (talk)
In Arma 3 the returned string is the steamID64 of the player. _steamProfileUrl = "http://steamcommunity.com/profiles/" + (getPlayerUID player);

Bottom Section