TextChannel
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Representa um canal de chat de texto. Contém TextSources como descendentes.
Para enviar uma mensagem de chat para o TextChannel , chame TextChannel:SendAsync() a partir de um LocalScript . O correspondente 1> Class.TextSource1> do usuário com 4> TextSource.CanSend = true4> deve estar nesse canal.
Mensagens de diferentes canais de texto podem ser separadas em diferentes abas na janela de chat usando ChannelTabsConfiguration.
Para saber mais, see Chat de Texto Na Experiência .
Resumo
Métodos
Exibe uma mensagem do sistema para o usuário.
Adiciona um TextSource ao TextChannel dado pelo usuário de um Player.
Envia uma TextChatMessage para o servidor.
Eventos
Fires when TextChannel:DisplaySystemMessage() is invoked on the client, or when the client receives a valid TextChannel:SendAsync() response from the servidor.
Callbacks
Propriedades
Métodos
DisplaySystemMessage
Exibe uma mensagem do sistema para o usuário. Só pode ser usado em um LocalScript , ou em um Script com RunContext de 2>Class.Script2>. Mensagens só são visíveis para aquele usuário e não são filtradas automaticamente ou localizadas.
Parâmetros
A mensagem do sistema enviada para o TextChannel .
Use para identificar tipos de mensagens do sistema, como as mensagens padrão do sistema.
Devolução
Um TextChatMessage com TextChatMessage.Status propriedade que indica a condição da mensagem.
AddUserAsync
Adiciona um TextSource ao TextChannel dado pelo usuário (com Player.UserId). Somente pode ser usado em um 2>Class.Script2> .
Se um TextSource representando o usuário não existe, isso adiciona um TextSource.
Se um TextSource representando o usuário existir, isso retorna o TextSource.
Se o usuário tiver o chat desligado ou não estiver no servidor, isso retorna um tuple nil , false .
Parâmetros
Devolução
Retorna TextSource e true se um novo TextSource for criado para o usuário, 1> Class.TextSource1> e 4> false4> se houver um 7> Class.TextSource
SendAsync
Envia uma TextChatMessage para o servidor. Somente pode ser usado em um LocalScript ou em um Script com 2>Class.Script.RunContext|RunContext2> de 5>Class.Script5> .
Parâmetros
A mensagem para enviar para o TextChannel.
Metadados personalizados para anexar à mensagem.
Devolução
Um TextChatMessage com TextChatMessage.Status propriedade que indica a condição da mensagem.
Eventos
MessageReceived
Como TextChatService.MessageReceived , dispara quando TextChannel:DisplaySystemMessage() é invocado no cliente, ou quando o cliente recebe uma resposta válida de TextChannel:SendAsync() do servidor. Este evento só é invocado no cliente.
Se a propriedade TextChannel.ShouldDeliverCallback do servidor estiver vinculada e retornar false, o cliente não irá executar TextChannel.MessageReceived.
Use o parâmetro TextChatMessage para obter o TextSource e o texto da mensagem (com TextChatMessage.Text).
O parâmetro TextChatMessage é o resultado final de qualquer função vinculada a TextChatService.OnIncomingMessage ou TextChannel.OnIncomingMessage.
Parâmetros
O recebido TextChatMessage .