TextChatMessage
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Objeto de dados imutável que representa uma mensagem de bate-papo de texto.
Para saber mais sobre o uso de TextChatMessages, veja Chat de Texto na Experiência.
Resumo
Propriedades
Um identificador exclusivo para o TextChatMessage.
Um campo de propósito geral para armazenar dados diversos sobre o TextChatMessage .
Um prefixo para adicionar à mensagem de um usuário.
Indica o status do TextChatMessage.
A mensagem de texto filtrada para o usuário.
Uma referência à origem TextChannel .
Uma referência à origem TextSource .
Um timestamp de quando a mensagem foi originalmente sentença / frase
mensagemde texto traduzida e filtrada.
Propriedades
BubbleChatMessageProperties
ChatWindowMessageProperties
Metadata
Um campo de propósito geral para armazenar dados diversos sobre o TextChatMessage .O segundo argumento de TextChannel:SendAsync() e TextChannel:DisplaySystemMessage() é usado para preencher este campo.
Use este campo para aplicar formatação adicional para mensagens especiais dentro de TextChatService.OnIncomingMessage e TextChannel.OnIncomingMessage chamadas de retorno.
local TextChatService = game:GetService("TextChatService")
local generalChannel: TextChannel = TextChatService:WaitForChild("TextChannels").RBXGeneral
generalChannel:DisplaySystemMessage("This is an error!", "Game.Error.Generic")
generalChannel:DisplaySystemMessage("Could not find save data!", "Game.Error.SaveDataNotFound")
generalChannel:DisplaySystemMessage("You won the game!", "Game.Info.Win")
generalChannel:DisplaySystemMessage("You lost the game!", "Game.Info.Lose")
generalChannel.OnIncomingMessage = function(message: TextChatMessage)
if string.find(message.Metadata, "Error") then
local overrideProperties = Instance.new("TextChatMessageProperties")
overrideProperties.TextColor = Color3.fromRGB(255, 0, 0)
return overrideProperties
elseif string.find(message.Metadata, "Info") then
local overrideProperties = Instance.new("TextChatMessageProperties")
overrideProperties.TextColor = Color3.fromRGB(0, 255, 150)
return overrideProperties
end
return nil
end
A seguir é uma referência das mensagens do sistema padrão emitidas pelo sistema de chat:
<th>Descrição</th></tr></thead><tbody><tr><td><code>Roblox.ChatTranslation.ChatWindow.Sistema de Mensagem</code></td><td>Indica que o sistema pode traduzir mensagens de bate-papo para o jogador.</td></tr><tr><td><code>Roblox.Notification.Friend.Juntou-se</code></td><td>Exibido quando um amigo do jogador se juntar à experiência.</td></tr><tr><td><code>Roblox.MessageStatus.Aviso/advertência.Floodchecked</code></td><td>Exibido quando a mensagem enviada pelo jogador foi limitada em taxa pelo servidor.</td></tr><tr><td><code>Roblox.MessageStatus.Aviso/advertência.TextFilterFailed</code></td><td>Exibido quando a mensagem enviada pelo jogador não pôde ser exibida devido a um problema de filtragem de texto.</td></tr><tr><td><code>Roblox.MessageStatus.Aviso/advertência.Configurações de Privacidade Inválidas</code></td><td>Exibido quando as configurações de privacidade do jogador os impedem de enviar uma mensagem.</td></tr><tr><td><code>Roblox.MessageStatus.Aviso/advertência.Mensagem Muito Longa</code></td><td>Exibido quando o jogador envia uma mensagem com conteúdo que é muito longo.</td></tr><tr><td><code>Roblox.MessageStatus.Aviso/advertência.Desconhecido</code></td><td>Exibe quando o sistema falha em enviar a mensagem do jogador por uma razão desconhecida.</td></tr><tr><td><code>Roblox.Ajuda.Info</code></td><td>Mostra a resposta da classe <code>RBXHelpCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Versão.Info</code></td><td>Mostra a resposta da classe <code>RBXVersionCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Team.Success.Agora na equipe</code></td><td>Exibido quando a equipe do jogador muda.</td></tr><tr><td><code>Roblox.Team.Error.Não é possível conversar em equipe se não estiver na equipe</code></td><td>Exibido quando o jogador ativa o <code>Comando de Equipe RBX</code><code>Class.TextChatCommand</code> sem estar em uma <code>Classe.Team</code>.</td></tr><tr><td><code>Roblox.Whisper.Info.성공</code></td><td>Exibido quando o jogador inicia com sucesso uma conversa sussurrada.</td></tr><tr><td><code>Roblox.Whisper.Welcome.Sent</code></td><td>Exibido ao entrar em uma classe sussurrada <code>Class.TextChannel</code>.</td></tr><tr><td><code>Roblox.Whisper.Error.Não pode sussurrar para si mesmo</code></td><td>Uma resposta de erro do <code>RBXWhisperCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Whisper.Error.TargetNão existe</code></td><td>Uma resposta de erro do <code>RBXWhisperCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Whisper.Erro.MuitosEncontros</code></td><td>Uma resposta de erro do <code>RBXWhisperCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Whisper.Error.Desconhecido</code></td><td>Uma resposta de erro do <code>RBXWhisperCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Emote.Error.Não existe</code></td><td>Uma resposta de erro do <code>RBXEmoteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Emote.Error.UserEmotesNão habilitados</code></td><td>Uma resposta de erro do <code>RBXEmoteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Emote.Error.Temporariamente Indisponível</code></td><td>Uma resposta de erro do <code>RBXEmoteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Emote.Error.Não Suportado</code></td><td>Uma resposta de erro do <code>RBXEmoteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Emote.Erro.Mudar para R15</code></td><td>Uma resposta de erro do <code>RBXEmoteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Emote.Error.Animação Jogando</code></td><td>Uma resposta de erro do <code>RBXEmoteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Mute.Error.JogadorDesconhecido</code></td><td>Uma resposta de erro do <code>RBXMuteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Mute.Error.MultipleMatches</code></td><td>Uma resposta de erro do <code>RBXMuteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Mute.Error.Não é possível silenciar a si mesmo</code></td><td>Uma resposta de erro do <code>RBXMuteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Mute.Info.Success</code></td><td>Uma resposta de sucesso do <code>RBXMuteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Unmute.Error.JogadorDesconhecido</code></td><td>Uma resposta de erro do <code>RBXUnmuteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Unmute.Error.MultipleMatches</code></td><td>Uma resposta de erro do <code>RBXUnmuteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Unmute.Error.Não é possível silenciar a si mesmo</code></td><td>Uma resposta de erro do <code>RBXUnmuteCommand</code><code>Class.TextChatCommand</code>.</td></tr><tr><td><code>Roblox.Unmute.Info.Success</code></td><td>Uma resposta de sucesso do <code>RBXUnmuteCommand</code><code>Class.TextChatCommand</code>.</td></tr></tbody>
Metadados |
---|
PrefixText
Um prefixo para adicionar à mensagem de um usuário. Isso suporta Texto Rico, para que os desenvolvedores possam definir propriedades personalizadas para esse texto para suportar tags de bate-papo.
Por padrão, TextChatMessage.PrefixText é o nome do TextSource , que é o Player.DisplayName do usuário associado ao TextSource via TextSource.UserId .
Text
A mensagem de texto filtrada para o usuário.Usuários diferentes podem receber diferentes strings desta propriedade com base em regras de filtragem.Pode ser uma string / cadeia / textovazia.
Translation
Representa mensagens de texto traduzidas e filtradas com base nas configurações de localização dos usuários.O sistema não traduz mensagens entre usuários com as mesmas configurações de localização ou usando idiomas sem o Suporteao filtro de texto, então essa propriedade pode ser uma string vazia se nenhuma tradução ocorrer.Para personalização, veja Personalizando Mensagens Traduzidas.