getPlayerUID: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "<tt>([a-zA-Z0-9\. _"']+)<\/tt>" to "{{hl|$1}}") |
Lou Montana (talk | contribs) m (Text replacement - "\{\{Feature *\| *Informative *\| ([^↵]+) *\}\}" to "{{Feature|informative|$1}}") |
||
| (13 intermediate revisions by 2 users not shown) | |||
| Line 18: | Line 18: | ||
|descr= Return a UniqueID of the given unit (player). | |descr= Return a UniqueID of the given unit (player). | ||
{{Feature|arma3|The returned string is the player's steamID64: <sqf inline>private _steamProfileUrl = "http://steamcommunity.com/profiles/" + (getPlayerUID player);</sqf>}} | |||
{{Feature|important|Prior to [[{{arma2oa}}]] v1.60, the result always consisted of a [[str|stringified]] number (see [[getPlayerUIDOld]]), but always had to be considered and processed as a [[String]].<!-- | {{Feature|important|Prior to [[{{arma2oa}}]] v1.60, the result always consisted of a [[str|stringified]] number (see [[getPlayerUIDOld]]), but always had to be considered and processed as a [[String]].<!-- | ||
| Line 23: | Line 25: | ||
--> Moreover, games since [[{{arma2oa}}]] v1.61 provide a value that is not all-numeric.}} | --> Moreover, games since [[{{arma2oa}}]] v1.61 provide a value that is not all-numeric.}} | ||
{{Feature| | {{Feature|informative|Prior to [[Arma 3]] v2.02, in some cases the identity of certain player units could fail to propagate to other clients and the server, which caused [[isPlayer]] and [[getPlayerUID]] to incorrectly return {{hl|[[false]]}} and {{hl|""}} respectively, where the affected units were [[not]] [[local]]. See {{Link|https://github.com/michail-nikolaev/task-force-arma-3-radio/issues/1096|this bug report (GitHub)}} for more info. This was supposedly fixed, but you should remain vigilant toward false negatives nonetheless. }} | ||
which | |||
where the affected units | |||
|s1= [[getPlayerUID]] unit | |s1= [[getPlayerUID]] unit | ||
| Line 34: | Line 31: | ||
|p1= unit: [[Object]] | |p1= unit: [[Object]] | ||
|r1= [[String]] - | |r1= [[String]] - can be "_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 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. | * The value can be used to construct a valid variable name by appending to another valid variable name, e.g <sqf inline>missionNamespace setVariable ["TAG_player" + _uid, _unit];</sqf> | ||
|x1= < | |x1= <sqf>private _uid = getPlayerUID player;</sqf> | ||
|seealso= [[BIS_fnc_getUnitByUID]] | |seealso= [[BIS_fnc_getUnitByUID]] [[getPlayerUIDOld]] [[getClientState]] [[getClientStateNumber]] | ||
}} | }} | ||
Latest revision as of 18:11, 15 March 2024
Description
- Description:
- Return a UniqueID of the given unit (player).
- Groups:
- Multiplayer
Syntax
- Syntax:
- getPlayerUID unit
- Parameters:
- unit: Object
- Return Value:
- String - can be "_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.g missionNamespace setVariable ["TAG_player" + _uid, _unit];
Examples
- Example 1:
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