PT-BR/SetElementData - Revision history

LordHenry at 04:25, 7 August 2020

2020-08-07T04:25:19Z

← Older revision		Revision as of 04:25, 7 August 2020
Line 11:		Line 11:


	{{New items\|5.0157\|1.5.7-9.20477\|Um modo de assinatura foi introduzido para o [[setElementData]] no lado server. Quando definida a data no modo de assinatura, somente os clientes que forem adicionados através de [[addElementDataSubscriber]] receberão essa data, isso é bom para a performance.		{{New items\|5.0157\|1.5.7-9.20477\|Um modo de assinatura foi introduzido para o '''setElementData''' no lado server. Quando definida a data no modo de assinatura, somente os clientes que forem adicionados através de [[addElementDataSubscriber]] receberão essa data, isso é bom para a performance.
	Note que este modo só funciona quando o [[PT-BR/Element_data\|dado de elemento]] é definido no lado server. Definir a data no lado cliente ainda enviará a atualização para todos os clientes se 'synchronize' estiver definido como ''true''.		Note que este modo só funciona quando o [[PT-BR/Element_data\|dado de elemento]] é definido no lado server. Definir a data no lado cliente ainda enviará a atualização para todos os clientes se 'synchronize' estiver definido como ''true''.
	}}		}}

LordHenry at 04:24, 7 August 2020

2020-08-07T04:24:29Z

← Older revision		Revision as of 04:24, 7 August 2020
Line 11:		Line 11:


	{{New items\|5.0157\|1.5.7-9.20477\|~~A subscription mode has been introduced for~~ [[setElementData]] ~~serverside~~. ~~When setting~~ data ~~in subscription mode~~, ~~only clients that are added through~~ [[addElementDataSubscriber]] ~~will receive the~~ data, ~~which is good for~~ performance.		{{New items\|5.0157\|1.5.7-9.20477\|Um modo de assinatura foi introduzido para o [[setElementData]] no lado server. Quando definida a data no modo de assinatura, somente os clientes que forem adicionados através de [[addElementDataSubscriber]] receberão essa data, isso é bom para a performance.
	Note ~~this mode only works when setting element data serverside~~. ~~Setting~~ data ~~clientside still sends the update to all clients if~~ 'synchronize' ~~is set to~~ true.		Note que este modo só funciona quando o [[PT-BR/Element_data\|dado de elemento]] é definido no lado server. Definir a data no lado cliente ainda enviará a atualização para todos os clientes se 'synchronize' estiver definido como ''true''.
	}}		}}

Line 129:		Line 129:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
	~~[[tr:setElementData]]~~

	==Veja também==		==Veja também==
			{{Element_functions}}
	[[en:setElementData]]		[[en:setElementData]]
	~~{{Element_functions}}~~		[[tr:setElementData]]

LordHenry at 22:43, 6 August 2020

2020-08-06T22:43:10Z

← Older revision		Revision as of 22:43, 6 August 2020
Line 1:		Line 1:
	{{BR/Funcao compartilhada}}		{{BR/Funcao compartilhada}}
	__NOTOC__		__NOTOC__
	Esta função armazena [[~~element data~~]] sob uma determinada chave anexada a um elemento. A [[~~element data~~]] é ~~sincronizada~~ com todos os jogadores e com servidor. Os dados podem conter elementos criados pelo servidor, mas evite transmitir qualquer dado que não possa ser sincronizado como xmlnodes, acls, aclgroups etc.		Esta função armazena [[PT-BR/Element_data\|dado de elemento]] sob uma determinada chave anexada a um elemento. O [[PT-BR/Element_data\|dado de elemento]] é sincronizado com todos os jogadores e com servidor. Os dados podem conter elementos criados pelo servidor, mas evite transmitir qualquer dado que não possa ser sincronizado como xmlnodes, acls, aclgroups etc.

	Como os dados do elemento são sincronizados com todos os jogadores, eles podem gerar muito tráfego de rede e prejudicar o desempenho. Os eventos são muito mais eficientes para enviar dados de um jogador para o servidor ou do servidor para um jogador específico.<br/>		Como os dados do elemento são sincronizados com todos os jogadores, eles podem gerar muito tráfego de rede e prejudicar o desempenho. Os eventos são muito mais eficientes para enviar dados de um jogador para o servidor ou do servidor para um jogador específico.<br/>
	O uso de [[~~element data~~]] não é recomendado em casos onde ~~sua meta~~ pode ser ~~alcançada~~ com os eventos citados acima, variáveis ou [[table\|tables]] para armazenar dados.		O uso de [[PT-BR/Element_data\|dado de elemento]] não é recomendado em casos onde seu objetivo pode ser alcançado com os eventos citados acima, variáveis ou [[table\|tables]] para armazenar dados.

	{{Dica\|Uma maneira simples e eficiente de tornar uma variável conhecida pelo servidor e pelos jogadores é usar setElementData no elemento [[root]].}}		{{Dica\|Uma maneira simples e eficiente de tornar uma variável conhecida pelo servidor e pelos jogadores é usar setElementData no elemento [[root]].}}
	{{BR/Nota\|Leia [[Script security]] para ver dicas de como evitar trapaceiros ao usar [[~~element data~~]] e eventos}}		{{BR/Nota\|Leia [[Script security]] para ver dicas de como evitar trapaceiros ao usar [[PT-BR/Element_data\|dado de elemento]] e eventos}}
	{{BR/Nota\|Por motivos de desempenho nunca utilize setElementData em eventos que são acionados com frequência como [[onClientRender]]. O uso de [[~~element data~~]] em geral pode afetar o desempenho, por isso é recomendado que seja usado somente em casos de extrema necessidade (o uso de [[table\|tables]] ou variáveis é recomendado para substituir o [[~~element data~~]]).}}		{{BR/Nota\|Por motivos de desempenho nunca utilize setElementData em eventos que são acionados com frequência como [[onClientRender]]. O uso de [[PT-BR/Element_data\|dado de elemento]] em geral pode afetar o desempenho, por isso é recomendado que seja usado somente em casos de extrema necessidade (o uso de [[table\|tables]] ou variáveis é recomendado para substituir o [[PT-BR/Element_data\|dado de elemento]]).}}


Line 25:		Line 25:
	*'''theElement:''' o [[elemento]] que você deseja armazenar dados.		*'''theElement:''' o [[elemento]] que você deseja armazenar dados.
	*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)		*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
	*'''value:''' O valor que você deseja armazenar. Leia [[~~element data~~]] para saber quais são os tipos de dados aceitáveis.		*'''value:''' O valor que você deseja armazenar. Leia [[PT-BR/Element_data\|dado de elemento]] para saber quais são os tipos de dados aceitáveis.

	===Argumentos Opcionais===		===Argumentos Opcionais===
Line 44:		Line 44:
	*'''theElement:''' o [[elemento]] que você deseja armazenar dados.		*'''theElement:''' o [[elemento]] que você deseja armazenar dados.
	*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)		*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
	*'''value:''' O valor que você deseja armazenar. Leia [[~~element data~~]] para saber quais são os tipos de dados aceitáveis.		*'''value:''' O valor que você deseja armazenar. Leia [[PT-BR/Element_data\|dado de elemento]] para saber quais são os tipos de dados aceitáveis.

	===Argumentos Opcionais===		===Argumentos Opcionais===
Line 60:		Line 60:

	===Argumentos necessários===		===Argumentos necessários===
	*'''theElement:''' o [[~~element~~]] que você deseja armazenar dados.		*'''theElement:''' o [[elemento]] que você deseja armazenar dados.
	*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)		*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
	*'''value:''' O valor que você deseja armazenar. Leia [[~~element data~~]] para saber quais são os tipos de dados aceitáveis.		*'''value:''' O valor que você deseja armazenar. Leia [[PT-BR/Element_data\|dado de elemento]] para saber quais são os tipos de dados aceitáveis.

	===Argumentos Opcionais===		===Argumentos Opcionais===

LordHenry at 22:36, 6 August 2020

2020-08-06T22:36:23Z

← Older revision		Revision as of 22:36, 6 August 2020
Line 23:		Line 23:

	===Argumentos necessários===		===Argumentos necessários===
	*'''theElement:''' o [[~~element~~]] que você deseja armazenar dados.		*'''theElement:''' o [[elemento]] que você deseja armazenar dados.
	*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)		*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
	*'''value:''' O valor que você deseja armazenar. Leia [[element data]] para saber quais são os tipos de dados aceitáveis.		*'''value:''' O valor que você deseja armazenar. Leia [[element data]] para saber quais são os tipos de dados aceitáveis.
Line 42:		Line 42:

	===Argumentos necessários===		===Argumentos necessários===
	*'''theElement:''' o [[~~element~~]] que você deseja armazenar dados.		*'''theElement:''' o [[elemento]] que você deseja armazenar dados.
	*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)		*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
	*'''value:''' O valor que você deseja armazenar. Leia [[element data]] para saber quais são os tipos de dados aceitáveis.		*'''value:''' O valor que você deseja armazenar. Leia [[element data]] para saber quais são os tipos de dados aceitáveis.

Eficiencia: Created page with "{{BR/Funcao compartilhada}} NOTOC Esta função armazena element data sob uma determinada chave anexada a um elemento. A element data é sincronizada com todos os..."

2020-08-06T22:27:22Z

Created page with "{{BR/Funcao compartilhada}} __NOTOC__ Esta função armazena element data sob uma determinada chave anexada a um elemento. A element data é sincronizada com todos os..."

New page

{{BR/Funcao compartilhada}}
__NOTOC__
Esta função armazena [[element data]] sob uma determinada chave anexada a um elemento. A [[element data]] é sincronizada com todos os jogadores e com servidor. Os dados podem conter elementos criados pelo servidor, mas evite transmitir qualquer dado que não possa ser sincronizado como xmlnodes, acls, aclgroups etc.

Como os dados do elemento são sincronizados com todos os jogadores, eles podem gerar muito tráfego de rede e prejudicar o desempenho. Os eventos são muito mais eficientes para enviar dados de um jogador para o servidor ou do servidor para um jogador específico.<br/>
O uso de [[element data]] não é recomendado em casos onde sua meta pode ser alcançada com os eventos citados acima, variáveis ou [[table|tables]] para armazenar dados.

{{Dica|Uma maneira simples e eficiente de tornar uma variável conhecida pelo servidor e pelos jogadores é usar setElementData no elemento [[root]].}}
{{BR/Nota|Leia [[Script security]] para ver dicas de como evitar trapaceiros ao usar [[element data]] e eventos}}
{{BR/Nota|Por motivos de desempenho nunca utilize setElementData em eventos que são acionados com frequência como [[onClientRender]]. O uso de [[element data]] em geral pode afetar o desempenho, por isso é recomendado que seja usado somente em casos de extrema necessidade (o uso de [[table|tables]] ou variáveis é recomendado para substituir o [[element data]]).}}

{{New items|5.0157|1.5.7-9.20477|A subscription mode has been introduced for [[setElementData]] serverside. When setting data in subscription mode, only clients that are added through [[addElementDataSubscriber]] will receive the data, which is good for performance.
Note this mode only works when setting element data serverside. Setting data clientside still sends the update to all clients if 'synchronize' is set to true.
}}

==Sintaxe==

<syntaxhighlight lang="lua">
bool setElementData ( element theElement, string key, var value [, bool synchronize = true ] )
</syntaxhighlight>
{{PT-BR/POO||[[element]]:setData||getElementData}}

===Argumentos necessários===
*'''theElement:''' o [[element]] que você deseja armazenar dados.
*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
*'''value:''' O valor que você deseja armazenar. Leia [[element data]] para saber quais são os tipos de dados aceitáveis.

===Argumentos Opcionais===
*'''synchronize:''' Determina se os dados serão ou não sincronizados com os jogadores ou com o servidor.

===Retorna===
Retorna ''true'' se a element data foi armazenada com sucesso e ''false'' se não for armazenada.

{{New items|5.0157|1.5.7-9.20477|
==Sintaxe==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool setElementData ( element theElement, string key, var value [, var syncMode="broadcast"] )
</syntaxhighlight>
{{PT-BR/POO||[[element]]:setData||getElementData}}

===Argumentos necessários===
*'''theElement:''' o [[element]] que você deseja armazenar dados.
*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
*'''value:''' O valor que você deseja armazenar. Leia [[element data]] para saber quais são os tipos de dados aceitáveis.

===Argumentos Opcionais===
*'''syncMode:''' Modo de sincronização.
**''"broadcast"'' - Sincroniza com todos os jogadores.
**''"local"'' - Não sincroniza os dados.
**''"subscribe"'' - Sincroniza apenas com jogadores específicos. Leia [[addElementDataSubscriber]] e [[removeElementDataSubscriber]].
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool setElementData ( element theElement, string key, var value [, bool synchronize = true ] )
</syntaxhighlight>
{{PT-BR/POO||[[element]]:setData||getElementData}}

===Argumentos necessários===
*'''theElement:''' o [[element]] que você deseja armazenar dados.
*'''key:''' A chave que você deseja armazenar os dados. (Máximo de 31 caracteres.)
*'''value:''' O valor que você deseja armazenar. Leia [[element data]] para saber quais são os tipos de dados aceitáveis.

===Argumentos Opcionais===
*'''synchronize:''' Determina se os dados serão ou não sincronizados com o servidor.
</section>

===Retorna===
Retorna ''true'' se a element data foi armazenada com sucesso e ''false'' se não for armazenada.
}}

===Problemas===
{{Issues|
{{Issue|7389|[Fixed in 1.3.5-7389] Problema com números decimais}}
}}

==Exemplos==
<section name="Server" class="server" show="false">
Este exemplo permite que um jogador adicione uma tag personalizada ao apelido e também a reverte ao normal, se desejar.
<syntaxhighlight lang="lua">
function addPlayerCustomTag ( thePlayer, command, newTag )
--Let's make sure the newTag param has been entered...
if ( newTag ) then
--Grab their current playername for saving.
local sPlayerNickname = getPlayerName ( thePlayer )
--Create their new nickname with their tag
local sNewPlayerNickname = newTag .. " " .. sPlayerNickname

--Let's first load the element data, see if it's there already
--The reason for this is that if a player were to do /addtag twice,
--the tag would be prepended a second time
local sOldNick = getElementData( thePlayer, "tempdata.originalnick" )
if ( sOldNick == false ) then
--Save their orignal nickname in their element data
setElementData ( thePlayer, "tempdata.originalnick", sPlayerNickname )
end

--Set their new nickname globally
setPlayerName ( thePlayer, sNewPlayerNickname )

--Tell them it's done
outputChatBox ( "Your new nickname has been set, to put it back to its original state you can use /deltag", thePlayer )
else
--The newTag param was not entered, give an error message
outputChatBox ( "/addtag - Incorrect syntax, Correct: /addtag <newtag>", thePlayer )
end
end
addCommandHandler ( "addtag", addPlayerCustomTag )

function removePlayerCustomTag ( thePlayer, command )
--We first need to check that they have already used /addtag, let's do that now
local sOldNick = getElementData( thePlayer, "tempdata.originalnick" )
if ( sOldNick ) then
--Great, they have a tag added, let's reset them

--First we will want to reset the element data back to its default (that being false)
setElementData ( thePlayer, "tempdata.originalnick", false )

--Now set the client name back
setPlayerName( thePlayer, sOldNick )

--Notify them
outputChatBox ( "Your old nickname has been set", thePlayer )
end
end
addCommandHandler ( "deltag", removePlayerCustomTag )
</syntaxhighlight>
</section>
[[tr:setElementData]]

==Veja também==
[[en:setElementData]]
{{Element_functions}}

PT-BR/SetElementData - Revision history

LordHenry at 04:25, 7 August 2020

LordHenry at 04:24, 7 August 2020

LordHenry at 22:43, 6 August 2020

LordHenry at 22:36, 6 August 2020

Eficiencia: Created page with "{{BR/Funcao compartilhada}} __NOTOC__ Esta função armazena element data sob uma determinada chave anexada a um elemento. A element data é sincronizada com todos os..."

Eficiencia: Created page with "{{BR/Funcao compartilhada}} NOTOC Esta função armazena element data sob uma determinada chave anexada a um elemento. A element data é sincronizada com todos os..."