SetAccountData - Revision history

Zangomangu: Removed fixed issue

2022-01-30T10:41:49Z

Removed fixed issue

@@ Line 42: / Line 42: @@
 addEventHandler ( "onPlayerQuit", root, onPlayerQuit )
 addEventHandler ( "onPlayerLogin", root, onPlayerLogin )
 </syntaxhighlight>

EOFIK: Добавление языков

2021-04-12T15:46:46Z

Добавление языков

← Older revision		Revision as of 15:46, 12 April 2021
Line 61:		Line 61:
	[[ar:setAccountData]]		[[ar:setAccountData]]
	[[es:setAccountData]]		[[es:setAccountData]]
	~~[[zh-cn:setAccountData]]~~

EOFIK: Добавление языков

2021-04-12T15:45:26Z

Добавление языков

← Older revision		Revision as of 15:45, 12 April 2021
Line 57:		Line 57:
	{{Account_functions}}		{{Account_functions}}

			[[en:setAccountData]]
			[[ru:setAccountData]]
	[[ar:setAccountData]]		[[ar:setAccountData]]
	[[es:setAccountData]]		[[es:setAccountData]]
	~~[[ru:setAccountData]]~~
	[[zh-cn:setAccountData]]		[[zh-cn:setAccountData]]

Qwe7769611 at 05:12, 4 February 2021

2021-02-04T05:12:27Z

← Older revision		Revision as of 05:12, 4 February 2021
Line 60:		Line 60:
	[[es:setAccountData]]		[[es:setAccountData]]
	[[ru:setAccountData]]		[[ru:setAccountData]]
			[[zh-cn:setAccountData]]

XLive at 09:18, 4 November 2020

2020-11-04T09:18:32Z

← Older revision		Revision as of 09:18, 4 November 2020
Line 40:		Line 40:
	end		end

	addEventHandler ( "onPlayerQuit", ~~getRootElement ( )~~, onPlayerQuit )		addEventHandler ( "onPlayerQuit", root, onPlayerQuit )
	addEventHandler ( "onPlayerLogin", ~~getRootElement ( )~~, onPlayerLogin )		addEventHandler ( "onPlayerLogin", root, onPlayerLogin )
	</syntaxhighlight>		</syntaxhighlight>

Danilo: /* Syntax */

2020-08-15T05:27:34Z

Syntax

← Older revision		Revision as of 05:27, 15 August 2020
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool setAccountData ( account theAccount, string key, ~~string~~ value )		bool setAccountData ( account theAccount, string key, var value )
	</syntaxhighlight>		</syntaxhighlight>
	{{OOP\|\|[[account]]:setData\|\|getAccountData}}		{{OOP\|\|[[account]]:setData\|\|getAccountData}}

Qaisjp: prefer normal note

2019-09-07T08:35:03Z

prefer normal note

← Older revision		Revision as of 08:35, 7 September 2019
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__{{Important Note\|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	{{~~Note_box~~\|~~It is strongly recommended that you~~ use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	This function sets a string to be stored in an [[account]]. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.		This function sets a string to be stored in an [[account]]. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.

Thisdp: Undo revision 59038 by Lizzalka (talk)

2018-09-09T06:00:00Z

Undo revision 59038 by Lizzalka (talk)

← Older revision		Revision as of 06:00, 9 September 2018
Line 1:		Line 1:
	<~~font face~~="~~sans-serif~~">		{{Server function}}
	<~~div style~~=~~"background~~:~~#333;">~~		__NOTOC__
	~~<div style="height~~:~~4px;background~~:~~#AAA;"></div>~~		{{Note_box\|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	~~<font color~~=~~"#FFF" size~~=~~"5">~~		This function sets a string to be stored in an [[account]]. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.
	~~<p> Ваша версия Adobe Flash Player устарела</p>~~
	~~</font>~~		==Syntax==
	~~<div style~~="~~background:#FFF;~~">		<syntaxhighlight lang="lua">
	<~~font color~~="~~#F00" size="2~~">		bool setAccountData ( account theAccount, string key, string value )
	~~<p>Требуется срочное обновление до текущей версии!</p>~~		</syntaxhighlight>
	~~</font>~~		{{OOP\|\|[[account]]:setData\|\|getAccountData}}
	~~<font color~~="~~#000~~" ~~size~~="4">		===Required Arguments===
	~~<p>Adobe Flash Player 30~~.~~0.0.164 <font color=~~"~~#888~~" ~~size=~~"2">(~~~18 kB~~)</~~font></p~~>		*'''theAccount:''' The account you wish to retrieve the data from.
	~~</font>~~		*'''key:''' The key under which you wish to store the data
	<~~font color~~="~~#444~~" ~~size=~~"2">		*'''value:''' The value you wish to store. Set to false to remove the data. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.
	~~<p><b>Операционная система:~~</~~b> Windows<br><b>Язык:</b> Выбирает пользователь</p~~>
	~~</font>~~		===Returns===
	~~<font color~~=~~"#000" size~~=~~"4">~~		Returns a ''true'' if the account data was set, ''false'' if an invalid argument was specified.
	~~<p>Скачать обновление с Яндекс.Диска: yadi.sk/d/AfbiMAr1PkGdww</p>~~
	~~</font>~~		==Example==
	~~</div>~~		For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
	~~</div>~~		<syntaxhighlight lang="lua">
	~~</font>~~		function onPlayerQuit ( )
			-- when a player leaves, store his current money amount in his account data
			local playeraccount = getPlayerAccount ( source )
			if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- if the player is logged in
			local playermoney = getPlayerMoney ( source ) -- get the player money
			setAccountData ( playeraccount, "piraterpg.money", playermoney ) -- save it in his account
			end
			end

			function onPlayerLogin (_, playeraccount )
			-- when a player logins, retrieve his money amount from his account data and set it
			if ( playeraccount ) then
			local playermoney = getAccountData ( playeraccount, "piraterpg.money" )
			-- make sure there was actually a value saved under this key (check if playermoney is not false).
			-- this will for example not be the case when a player plays the gametype for the first time
			if ( playermoney ) then
			setPlayerMoney ( source, playermoney )
			end
			end
			end

			addEventHandler ( "onPlayerQuit", getRootElement ( ), onPlayerQuit )
			addEventHandler ( "onPlayerLogin", getRootElement ( ), onPlayerLogin )
			</syntaxhighlight>

			==Issues==
			{{Issues\|
			{{Issue\|7757\|[Fixed in 1.3.4-7757] setAccountData clips the digits after the decimal point}}
			}}
			===Workaround for issue 7757===
			Convert your floating point number to a string.
			<syntaxhighlight lang="lua">
			setAccountData(account, "myKey", tostring(0.123))
			</syntaxhighlight>

			==See Also==
			{{Account_functions}}

			[[ar:setAccountData]]
			[[es:setAccountData]]
			[[ru:setAccountData]]

Lizzalka at 05:56, 9 September 2018

2018-09-09T05:56:41Z

← Older revision		Revision as of 05:56, 9 September 2018
Line 1:		Line 1:
	~~{{Server function}}~~		<font face="sans-serif">
	~~__NOTOC__~~		<div style="background:#333;">
	~~{{Note_box\|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}~~		<div style="height:4px;background:#AAA;"></div>
	This function sets a string to be stored in an [[account]]. This can then be retrieved using [[getAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account. Even if logged into a guest account, account data can be useful as a way to store a reference to your own account system, though it's persistence is equivalent to that of using [[setElementData]] on the player's element.		<font color="#FFF" size="5">
			<p> Ваша версия Adobe Flash Player устарела</p>
	~~==Syntax=~~=		</font>
	<~~syntaxhighlight lang~~="~~lua~~">		<div style="background:#FFF;">
	~~bool setAccountData ( account theAccount, string key, string value )~~		<font color="#F00" size="2">
	<~~/syntaxhighlight>~~		<p>Требуется срочное обновление до текущей версии!</p>
	~~{{OOP\|\|[[account]]:setData\|\|getAccountData}}~~		</font>
	=~~==Required Arguments===~~		<font color="#000" size="4">
	*'''theAccount:~~''' The account you wish to retrieve the data from.~~		<p>Adobe Flash Player 30.0.0.164 <font color="#888" size="2">(~18 kB)</font></p>
	*'''key:~~''' The key under which you wish to store the data~~		</font>
	*'''value:''' The value you wish to store. Set to false to remove the data. '''NOTE:''' you cannot store tables as values, but you can use [[toJSON]] strings.		<font color="#444" size="2">
			<p><b>Операционная система:</b> Windows<br><b>Язык:</b> Выбирает пользователь</p>
	==~~=Returns===~~		</font>
	~~Returns a ''true'' if the account data was set, ''false'' if an invalid argument was specified.~~		<font color="#000" size="4">
			<p>Скачать обновление с Яндекс.Диска: yadi.sk/d/AfbiMAr1PkGdww</p>
	=~~=Example==~~		</font>
	~~For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses~~ "~~piraterpg.money~~" ~~as key instead of just~~ "~~money~~"~~, as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use~~ "~~money~~" ~~as the account key, they'd overwrite each other's data.~~		</div>
	<~~syntaxhighlight lang="lua"~~>		</div>
	~~function onPlayerQuit ( )~~		</font>
	~~-- when a player leaves, store his current money amount in his account data~~
	~~local playeraccount~~ = ~~getPlayerAccount ( source )~~
	~~if ( playeraccount ) and not isGuestAccount ( playeraccount ) then -- if the player is logged in~~
	~~local playermoney = getPlayerMoney ( source ) -- get the player money~~
	~~setAccountData ( playeraccount,~~ "~~piraterpg.money~~"~~, playermoney ) -- save it in his account~~
	~~end~~
	~~end~~

	~~function onPlayerLogin (_, playeraccount )~~
	~~-- when a player logins, retrieve his money amount from his account data and set it~~
	~~if ( playeraccount ) then~~
	~~local playermoney~~ = ~~getAccountData ( playeraccount,~~ "~~piraterpg.money~~" )
	~~-- make sure there was actually a value saved under this key (check if playermoney is not false)~~.
	~~-- this will for example not be the case when a player plays the gametype for the first time~~
	~~if ( playermoney ) then~~
	~~setPlayerMoney ( source, playermoney )~~
	~~end~~
	~~end~~
	~~end~~

	~~addEventHandler (~~ "~~onPlayerQuit~~"~~, getRootElement ( ), onPlayerQuit )~~
	~~addEventHandler (~~ "~~onPlayerLogin~~"~~, getRootElement~~ ( )~~, onPlayerLogin )~~
	</~~syntaxhighlight~~>

	~~==Issues~~==
	~~{{Issues\|~~
	~~{{Issue\|7757\|[Fixed in 1.3.4-7757] setAccountData clips the digits after the decimal point}}~~
	}}
	=~~==Workaround for issue 7757===~~
	~~Convert your floating point number to a string.~~
	~~<syntaxhighlight lang~~="~~lua~~">
	~~setAccountData(account, "myKey", tostring(0~~.~~123))~~
	</~~syntaxhighlight~~>

	~~==See Also==~~
	~~{{Account_functions}}~~

	~~[[ar:setAccountData]]~~
	~~[[es:setAccountData]]~~
	~~[[ru:setAccountData]]~~

ReitremX at 11:02, 30 September 2017

2017-09-30T11:02:58Z

← Older revision		Revision as of 11:02, 30 September 2017
Line 60:		Line 60:
	[[ar:setAccountData]]		[[ar:setAccountData]]
	[[es:setAccountData]]		[[es:setAccountData]]
			[[ru:setAccountData]]