PT-BR/SetElementData

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.
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 tables para armazenar dados.

[[{{{image}}}|link=|]]	Dica: Uma maneira simples e eficiente de tornar uma variável conhecida pelo servidor e pelos jogadores é usar setElementData no elemento root.

	Nota: Leia Script security para ver dicas de como evitar trapaceiros ao usar element data e eventos

	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 tables ou variáveis é recomendado para substituir o element data).

ADDED/UPDATED IN VERSION 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

bool setElementData ( element theElement, string key, var value [, bool synchronize = true ] )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: element:setData(...)

Oposto: 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.

ADDED/UPDATED IN VERSION 1.5.7-9.20477 :

Sintaxe

Click to collapse [-]

Server

bool setElementData ( element theElement, string key, var value [, var syncMode="broadcast"] )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: element:setData(...)

Oposto: 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.

Click to collapse [-]

Client

bool setElementData ( element theElement, string key, var value [, bool synchronize = true ] )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: element:setData(...)

Oposto: 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.

Retorna

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

Problemas

Issue ID	Description
#7389	[Fixed in 1.3.5-7389] Problema com números decimais

Exemplos

Click to expand [+]

Server

Este exemplo permite que um jogador adicione uma tag personalizada ao apelido e também a reverte ao normal, se desejar.

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 )

Veja também

• attachElements
• createElement
• destroyElement
• detachElements
• getAttachedElements
• getElementAlpha
• getElementAttachedOffsets
• getElementAttachedTo
• getElementByIndex
• getElementByID
• getElementChild
• getElementChildren
• getElementChildrenCount
• getElementCollisionsEnabled
• getElementColShape
• getElementData
• getAllElementData
• hasElementData
• getElementDimension
• getElementHealth
• getElementID
• getElementInterior
• getElementMatrix
• getElementModel
• getElementParent
• getElementPosition
• getElementRotation
• getElementsByType
• getElementsWithinColShape
• getElementsWithinRange
• getElementType
• getElementVelocity
• getLowLODElement
• getRootElement
• isElement
• isElementAttached
• isElementCallPropagationEnabled
• isElementDoubleSided
• isElementFrozen
• isElementInWater
• isElementLowLOD
ADDED/UPDATED IN VERSION 1.6.0 r22864:
isElementOnFire
• isElementWithinColShape
• isElementWithinMarker
• setElementAlpha
• setElementAngularVelocity
• getElementAngularVelocity
• setElementAttachedOffsets
• setElementCallPropagationEnabled
• setElementCollisionsEnabled
• setElementData
• setElementDimension
• setElementDoubleSided
• setElementFrozen
• setElementHealth
• setElementID
• setElementInterior
• setElementModel
ADDED/UPDATED IN VERSION 1.6.0 r22864:
setElementOnFire
• setElementParent
• setElementPosition
• setElementRotation
• setElementVelocity
• setLowLODElement
• getPedContactElement
• getResourceDynamicElementRoot
• getResourceRootElement