getPlayerUID: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "_{10,} " to "") |
Lou Montana (talk | contribs) m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...) |
||
| Line 1: | Line 1: | ||
{{Command | {{Command | ||
| arma2 | | arma2 | ||
|1.02 | |1.02 | ||
|gr1 = Multiplayer | |gr1 = Multiplayer | ||
|arg= global | |arg= global | ||
| Return a UniqueID of the given unit (player). | | Return a UniqueID of the given unit (player). | ||
| Line 18: | Line 18: | ||
{{Feature|arma3|The returned string is the player's steamID64: | {{Feature|arma3|The returned string is the player's steamID64: | ||
<code>[[private]] _steamProfileUrl {{=}} "http://<nowiki/>steamcommunity.com/profiles/" + ([[getPlayerUID]] [[player]]);</code>}} | <code>[[private]] _steamProfileUrl {{=}} "http://<nowiki/>steamcommunity.com/profiles/" + ([[getPlayerUID]] [[player]]);</code>}} | ||
|pr= In some cases, the identity of certain player units might fail to propagate to other clients and the server, | |pr= 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, | which causes [[isPlayer]] and [[getPlayerUID]] to incorrectly return <tt>[[false]]</tt> and <tt>""</tt> respectively, | ||
where the affected units are [[not]] [[local]] - see [https://github.com/michail-nikolaev/task-force-arma-3-radio/issues/1096 this bug report (GitHub)]. | where the affected units are [[not]] [[local]] - see [https://github.com/michail-nikolaev/task-force-arma-3-radio/issues/1096 this bug report (GitHub)]. | ||
Therefore, beware of false negatives. | Therefore, beware of false negatives. | ||
| [[getPlayerUID]] unit | | [[getPlayerUID]] unit | ||
|p1= unit: [[Object]] | |p1= unit: [[Object]] | ||
| [[String]] "_SP_AI_" or "_SP_PLAYER_" in SP, "" or UID in MP.<br> | | [[String]] "_SP_AI_" or "_SP_PLAYER_" in SP, "" or UID in MP.<br> | ||
The unique ID may be up to 100 characters long and may contain numbers, uppercase letters and underscores.<br> | The unique ID may be up to 100 characters long and may contain numbers, uppercase letters and underscores.<br> | ||
The value can be used to construct a valid variable name by appending to another valid variable name,<br> | The value can be used to construct a valid variable name by appending to another valid variable name,<br> | ||
e.g {{Inline code|[[missionNamespace]] [[setVariable]] ["TAG_player" + _uid, _unit];}} | e.g {{Inline code|[[missionNamespace]] [[setVariable]] ["TAG_player" + _uid, _unit];}} | ||
|x1= <code>[[private]] _uid = [[getPlayerUID]] [[player]];</code> | |x1= <code>[[private]] _uid = [[getPlayerUID]] [[player]];</code> | ||
| [[BIS_fnc_getUnitByUID]], [[getPlayerUIDOld]], [[getClientState]], [[getClientStateNumber]] | | [[BIS_fnc_getUnitByUID]], [[getPlayerUIDOld]], [[getClientState]], [[getClientStateNumber]] | ||
}} | }} | ||
Revision as of 00:40, 18 January 2021
Description
- Description:
- Return a UniqueID of the given unit (player).
The returned string is the player's steamID64:private _steamProfileUrl = "http://steamcommunity.com/profiles/" + (getPlayerUID player); - Problems:
- 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 false and "" respectively, where the affected units are not local - see this bug report (GitHub). Therefore, beware of false negatives.
- Groups:
- Multiplayer
Syntax
- Syntax:
- getPlayerUID unit
- Parameters:
- unit: Object
- Return Value:
- String "_SP_AI_" or "_SP_PLAYER_" in SP, "" or UID in MP.
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,
e.gmissionNamespace setVariable ["TAG_player" + _uid, _unit];
Examples
- Example 1:
private _uid = getPlayerUID player;
Additional Information
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