Filtragem de texto

Aplicada a várias fontes e entradas, a filtragem de texto impede que os usuários vejam linguagem inadequada e informações pessoalmente identificáveis, como números de telefone. O Roblox filtra automaticamente saídas de texto comuns, como mensagens que passaram pelo chat de texto em-experiência, mas você é responsável por filtrar qualquer texto exibido que você não tenha controle explícito.

Cenários de filtragem

O texto pode ser coletado e/ou exibido aos usuários em uma variedade de cenários, incluindo:

• Uma experiência que coleta a entrada de texto dos usuários através de entradas TextBox, uma GUI personalizada com botões, como uma interface de teclado/teclado numérico, ou um modelo de teclado interativo no espaço 3D.

• Uma experiência que gera palavras a partir de caracteres aleatórios e as exibe para os usuários, pois há uma chance de que isso crie palavras inadequadas.

• Uma experiência que se conecta a um servidor web externo para buscar conteúdo que é exibido na experiência. Frequentemente, você não terá controle sobre o conteúdo do site externo e um terceiro pode editar as informações.

• Uma experiência que armazena texto, como nomes de animais de estimação dos usuários, usando data stores, onde o texto armazenado pode incluir palavras inadequadas que devem ser filtradas ao recuperá-las.

Processo de filtragem

TextService:FilterStringAsync() filtra texto em-experiência, recebendo uma string de texto e o UserId do usuário que criou o texto como entrada. Ele retorna um objeto TextFilterResult que possui dois métodos adicionais que você pode chamar em diferentes cenários:

• TextFilterResult:GetNonChatStringForBroadcastAsync() para filtrar texto visível para todos os usuários em uma experiência, como para um diálogo que permite que um usuário escreva uma mensagem em um sinal que é visível para todos os usuários no servidor.
• TextFilterResult:GetNonChatStringForUserAsync() para exibir texto filtrado para um usuário específico, com base na idade e outros detalhes.

No contexto da entrada TextBox, o seguinte exemplo coleta a entrada no evento FocusLost e a envia para o servidor através de um RemoteEvent. No servidor, ele é filtrado primeiro através de FilterStringAsync() e depois GetNonChatStringForBroadcastAsync(), com a intenção de que o texto seja exibido para todos os usuários em um objeto do lado do servidor, como um SurfaceGui no mundo 3D.

Filtrando Entrada de Texto - Script do Cliente
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local textBox = script.Parent
textBox.ClearTextOnFocus = false
textBox.PlaceholderText = "..."
textBox.TextXAlignment = Enum.TextXAlignment.Left
textBox.TextScaled = true

-- RemoteEvent para enviar a entrada de texto para o servidor para filtragem
local inputRemoteEvent = ReplicatedStorage:FindFirstChild("InputRemoteEvent")

-- Manipulador de eventos para foco perdido e tecla enter pressionada
local function onFocusLost(enterPressed, inputObject)
	if enterPressed then
		print("ENVIADO:", textBox.Text)
		if inputRemoteEvent then
			inputRemoteEvent:FireServer(textBox.Text)
		end
	end
end

textBox.FocusLost:Connect(onFocusLost)

Filtrando Entrada de Texto - Script do Servidor
local TextService = game:GetService("TextService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- RemoteEvent para receber a entrada de texto do cliente para filtragem
local inputRemoteEvent = ReplicatedStorage:FindFirstChild("InputRemoteEvent")

local function getFilterResult(text, fromUserId)
	local filterResult
	local success, errorMessage = pcall(function()
		filterResult = TextService:FilterStringAsync(text, fromUserId)
	end)

	if success then
		return filterResult
	else
		warn("Erro ao gerar TextFilterResult:", errorMessage)
	end
end

-- Disparado quando o cliente envia a entrada do TextBox
local function onInputReceived(player, text)
	if text ~= "" then
		local filterResult = getFilterResult(text, player.UserId)
		if filterResult then
			local success, filteredText = pcall(function()
				return filterResult:GetNonChatStringForBroadcastAsync()
			end)

			if success then
				print("FILTRADO:", filteredText)
			else
				warn("Erro ao filtrar texto!")
			end
		end
	end
end

inputRemoteEvent.OnServerEvent:Connect(onInputReceived)