View source for RU/setAccountData

{{RU/Server function}}
__NOTOC__
{{RU/Note_box|Настоятельно рекомендуется использовать формат ''module.key'' в названиях ключей, как показано в примере ниже. Это помогает избегать противоречий между разными скриптами.}}
Эта функция сохраняет строку, которая будет храниться в аккаунте. Данные, хранящиеся как данные аккаунта, сохраняются в игре, если это не аккаунт ''guest'' (гость). Даже если войти в аккаунт ''guest'' (гость), данные аккаунта могут быть полезны как способ хранения ссылки на вашу собственную систему аккаунта, хотя сохранение эквивалентно использованию [[RU/setElementData|setElementData]] в элементе [[RU/Element/Player|player]].

==Синтаксис== 
<syntaxhighlight lang="lua">
bool setAccountData(account theAccount, string key, string value)
</syntaxhighlight> 
{{RU/OOP||[[RU/Account|account]]:setData||[[RU/getAccountData|getAccountData]]}}
===Обязательные аргументы=== 
*'''theAccount:''' [[RU/Account|Аккаунт]], в который Вы хотите записать данные
*'''key:''' Ключ, под которым Вы хотите сохранить данные
*'''value:''' Значение, которое Вы хотите установить. Установите значение ''false'', чтобы удалить данные. Вы не можете сохранять таблицы, но вы можете использовать строки [[toJSON]].

===Возвращаемые значения===
Возвращает ''true'', если данные для аккаунта были установлены, или ''false'', если указан недопустимый аргумент.

==Пример использования== 
<section name="Сервер" class="server" show="false">
'''Пример 1.''' Для пиратского ролевого игрового режима сумма денег, которую имеет игрок, постоянно сохраняется, сохраняя её в своем аккаунте. Обратите внимание, что код использует ''piraterpg.money'' как ключ, а не просто ''money'', так как игрок может участвовать в других игровых режимах, которые также сохраняют его денежную сумму на его счёт. Если оба типа игровых режимов будут использовать ''money'' в качестве ключа аккаунта, они перепишут данные друг друга.
<syntaxhighlight lang="lua">
function onPlayerQuit()
      // заносим в переменную playeraccount текущий аккаунт который вызвал событие
      local playeraccount = getPlayerAccount(source)
      // проверяем if(playeraccount) существует ли аккаунт and not isGuestAccount(playeraccount) then и не является аккант гостевым
      if(playeraccount) and not isGuestAccount(playeraccount) then
            // заносим в переменную playermoney текущее кол-во денег игрока
            local playermoney = getPlayerMoney(source)
            // теперь меняем ключ "piraterpg.money" аккаунта playeraccount и устанавливаем последнее нам известное кол-во денег
            setAccountData(playeraccount, "piraterpg.money", playermoney)
      end
end

function onPlayerLogin(_, playeraccount)
      if(playeraccount) then
            local playermoney = getAccountData(playeraccount, "piraterpg.money")
            if(playermoney) then
                  setPlayerMoney(source, playermoney)
            end
      end
end
 
addEventHandler("onPlayerQuit", getRootElement(), onPlayerQuit)
addEventHandler ("onPlayerLogin", getRootElement(), onPlayerLogin)
</syntaxhighlight>
</section>

==Проблемы==
{{RU/Issues|
{{RU/Issue|7757|[Исправлено в 1.3.4-7757] setAccountData зажимает цифры после десятичной точки}}
}}
<section name="Обход проблемы 7757" class="server" show="false">
Преобразуйте число с плавающей точкой в строку.
<syntaxhighlight lang="lua">
setAccountData(account, "myKey", tostring(0.123))
</syntaxhighlight>
</section>

==Смотрите также==
{{RU/Account_functions}}

[[ar:setAccountData]]
[[en:setAccountData]]
[[es:setAccountData]]