ZH-CN/getAccountData - Revision history

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

2021-04-11T20:05:32Z

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

← Older revision		Revision as of 20:05, 11 April 2021
Line 41:		Line 41:
	{{Account_functions}}		{{Account_functions}}

			[[en:getAccountData]]
	[[ru:getAccountData]]		[[ru:getAccountData]]
	[[ar:getAccountData]]		[[ar:getAccountData]]
	[[pl:getAccountData]]		[[pl:getAccountData]]
	[[en:getAccountData]]		[[zh-cn:getAccountData]]

Qwe7769611 at 07:55, 5 February 2021

2021-02-05T07:55:36Z

← Older revision		Revision as of 07:55, 5 February 2021
Line 12:		Line 12:
	*'''key:''' 存储数据的密钥(key)		*'''key:''' 存储数据的密钥(key)

	===~~Returns~~===		===返回值===
	返回包含存储数据的[[string]]，如果该键下未存储数据，则返回“false”。		返回包含存储数据的[[string]]，如果该键下未存储数据，则返回“false”。

	==~~Example~~==		==示例==
	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.		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.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 44:		Line 44:
	[[ar:getAccountData]]		[[ar:getAccountData]]
	[[pl:getAccountData]]		[[pl:getAccountData]]
	[[~~zh-cn~~:getAccountData]]		[[en:getAccountData]]

Qwe7769611 at 03:46, 4 February 2021

2021-02-04T03:46:58Z

← Older revision		Revision as of 03:46, 4 February 2021
Line 19:		Line 19:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function onPlayerQuit()		function onPlayerQuit()
	local playerAccount = getPlayerAccount(source) -- ~~get his account~~		local playerAccount = getPlayerAccount(source) -- 获取他的账户
	if (playerAccount) then -- ~~if we got the account then~~		if (playerAccount) then -- 如果确认账户存在
	local playerMoney = getPlayerMoney(source) -- ~~get his money amount~~		local playerMoney = getPlayerMoney(source) -- 获取他的金钱
	setAccountData(playerAccount, "piraterpg.money", playerMoney) -- ~~store his current money amount in his account data~~		setAccountData(playerAccount, "piraterpg.money", playerMoney) -- 把他现在的钱存到他的账户里
	end		end
	end		end
	addEventHandler("onPlayerQuit", root, onPlayerQuit) -- ~~add an event handler~~		addEventHandler("onPlayerQuit", root, onPlayerQuit) -- 添加事件处理程序

	function onPlayerLogin(_,account)		function onPlayerLogin(_,account)
Line 35:		Line 35:
	end		end
	end		end
	addEventHandler("onPlayerLogin", root, onPlayerLogin) -- ~~add an event handler~~		addEventHandler("onPlayerLogin", root, onPlayerLogin) -- 添加事件处理程序
	</syntaxhighlight>		</syntaxhighlight>

Qwe7769611 at 02:06, 4 February 2021

2021-02-04T02:06:31Z

← Older revision		Revision as of 02:06, 4 February 2021
Line 3:		Line 3:
	此函数用于检索使用[[setAccountData]]存储的字符串. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.		此函数用于检索使用[[setAccountData]]存储的字符串. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.

	==~~Syntax~~==		==语法==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	string getAccountData ( account theAccount, string key )		string getAccountData ( account theAccount, string key )
	</syntaxhighlight>		</syntaxhighlight>
	{{~~OOP~~\|\|[[account]]:getData\|\|setAccountData}}		{{OOP_ZH-CN\|\|[[account]]:getData\|\|setAccountData}}
	===~~Required Arguments~~===		===必填参数===
	*'''theAccount:''' ~~The account you wish to retrieve the data from~~.		*'''theAccount:''' 要从中检索数据的帐户.
	*'''key:''' ~~The~~ key ~~under which the data is stored~~		*'''key:''' 存储数据的密钥(key)

	===Returns===		===Returns===
	~~Returns a~~ [[string]] ~~containing the stored data or ''false'' if no data was stored under that key.~~		返回包含存储数据的[[string]]，如果该键下未存储数据，则返回“false”。

	==Example==		==Example==

Qwe7769611 at 02:04, 4 February 2021

2021-02-04T02:04:02Z

← Older revision		Revision as of 02:04, 4 February 2021
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__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.}}		__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.}}
	~~T此函数用于检索使用~~[[setAccountData]]存储的字符串. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.		此函数用于检索使用[[setAccountData]]存储的字符串. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.

	==Syntax==		==Syntax==

Qwe7769611 at 02:03, 4 February 2021

2021-02-04T02:03:55Z

← Older revision		Revision as of 02:03, 4 February 2021
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	__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.}}		__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.}}
	~~This function retrieves a string that has been stored using~~ [[setAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.		T此函数用于检索使用[[setAccountData]]存储的字符串. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.

	==Syntax==		==Syntax==

Qwe7769611: Created page with "{{Server function}} NOTOC{{Important Note|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions betw..."

2021-02-04T02:02:14Z

Created page with "{{Server function}} __NOTOC__{{Important Note|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions betw..."

New page

{{Server function}}
__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.}}
This function retrieves a string that has been stored using [[setAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.

==Syntax==
<syntaxhighlight lang="lua">
string getAccountData ( account theAccount, string key )
</syntaxhighlight>
{{OOP||[[account]]:getData||setAccountData}}
===Required Arguments===
*'''theAccount:''' The account you wish to retrieve the data from.
*'''key:''' The key under which the data is stored

===Returns===
Returns a [[string]] containing the stored data or ''false'' if no data was stored under that key.

==Example==
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.
<syntaxhighlight lang="lua">
function onPlayerQuit()
local playerAccount = getPlayerAccount(source) -- get his account
if (playerAccount) then -- if we got the account then
local playerMoney = getPlayerMoney(source) -- get his money amount
setAccountData(playerAccount, "piraterpg.money", playerMoney) -- store his current money amount in his account data
end
end
addEventHandler("onPlayerQuit", root, onPlayerQuit) -- add an event handler

function onPlayerLogin(_,account)
local playerMoney = getAccountData(account, "piraterpg.money") -- get the money amount was store in his account data
-- 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
addEventHandler("onPlayerLogin", root, onPlayerLogin) -- add an event handler
</syntaxhighlight>

==See Also==
{{Account_functions}}

[[ru:getAccountData]]
[[ar:getAccountData]]
[[pl:getAccountData]]
[[zh-cn:getAccountData]]