代表一个文字聊天频道。包含 TextSources 作为后代。
要向 TextChannel 发送聊天消息,请从 TextChannel:SendAsync() 调用 LocalScript 。该用户的相应 1>Class.TextSource1> 必须位于该频道。
不同的文字频道消息可以在聊天窗口中使用 ChannelTabsConfiguration 来分为不同的选项卡。
了解更多信息,请参阅体验内嵌文字聊天。
概要
方法
显示系统向用户显示。
将 TextSource 添加到 TextChannel 的给予用户 id 的 Player 。
向服务器发送一个 TextChatMessage 。
活动
客户端调用 TextChannel:DisplaySystemMessage() 或从服务器收到有效的 TextChannel:SendAsync() 回应时触发。
回调
属性
DirectChatRequester
方法
DisplaySystemMessage
显示系统消息给用户。仅能在 LocalScript 或 Script 中使用,并且在 RunContext 的 1>Class.Script.RunContext|RunContext1> 中使用 4>Class.Script.Run4> 的 7>Class.Script7> 。 消息只对该用户可见,并且不会自动过滤或本
参数
系统向 TextChannel 发送系统消息。
用于识别系统消息类型,例如默认系统消息。
返回
一个 TextChatMessage ,其中 TextChatMessage.Status 属性,表示消信息的状态。
AddUserAsync
添加一个 TextSource 到 TextChannel 给予用户的用户 id(Player.UserId )。只能在 2>Class.Script2> 中使用。
如果代表用户存在的 TextSource 不存在,这将添加一个 TextSource 。
如果代表用户存在的 TextSource,这将返回 TextSource 。
如果用户关闭聊天或不在服务器上,这将返回一个树型nil,false。
参数
Class.Player 的用户ID。
返回
如果用户创建了一个新的 TextSource ,返回 true 和 TextSource ,如果 2>Class.TextSource2> 已经存在,或 5>Class.TextSource5> 已经
SendAsync
向服务器发送一个 TextChatMessage 。仅能在 LocalScript 或 Script 中使用,或在 1> Class.Script.RunContext|RunContext1> 中使用 4> Class.Script.RunContext4> 的 7> Class.Script.Run7>。
参数
发送到 TextChannel 的消息。
自定义数据添加到消信息。
返回
一个 TextChatMessage ,其中 TextChatMessage.Status 属性,表示消信息的状态。
活动
MessageReceived
喜欢 TextChatService.MessageReceived , 发生在客户端调用 TextChannel:DisplaySystemMessage() 或服务器收到有效的 TextChannel:SendAsync() 回应时。 此事件仅在客户端发生。
如果服务器的 TextChannel.ShouldDeliverCallback 属性是可以绑定的,并且返回 false ,客户端将不会发射 TextChannel.MessageReceived。
使用 TextChatMessage 参数获取 TextSource 和消息的文本(含 TextChatMessage.Text)。
Class.TextChatMessage 参数是指定 TextChatService.OnIncomingMessage 或 TextChannel.OnIncomingMessage 的所有函数的最终结果。
参数
收到 TextChatMessage 。