TextChannel

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

텍스트 채팅 채널을 나타냅니다. 후손에는 TextSources가 포함됩니다.

Class.TextChannel 에 채팅 메시지 보내기를 위해서는 TextChannel:SendAsync() 를 부터 LocalScript 에서 1>Class.TextSource1> 를 수신하세요. 해당 사용자의 4>TextSource.CanSend = true4> 와 함께 있어야 하는 해당 채널의

다른 텍스트 채널의 메시지는 ChannelTabsConfiguration를 사용하여 채팅 창에 여러 개의 탭으로 나눌 수 있습니다.

자세한 내용은 경험 내 텍스트 채팅 을 참조하십시오.

요약

메서드

이벤트

콜백

속성

메서드

DisplaySystemMessage

사용자에게 시스템 메시지를 표시합니다. LocalScript 또는 Script 에 Class.Script.RunContext|RunContext 의 RunContext 만 있으면 됩니다. 메시지는 해당 사용자만 볼 수 있으며 자동으로 필터링되거나 로컬화되지는 않습니

매개 변수

systemMessage: string

시스템 메시지를 TextChannel 로 전송했습니다.

metadata: string

기본 시스템 메시지와 같은 시스템 메시지 유형을 식별하는 데 사용됩니다.

기본값: ""

반환

Class.TextChatMessage 속성을 가진 TextChatMessage.Status 메시지.

AddUserAsync

생성

사용자의 유효한 아이디(TextSource로 표시)에 대한 TextChannel 를 추가합니다(Player.UserId). 이 기능은 2>Class.Script2>에서만 사용할 수 있습니다.

사용자를 나타내는 TextSource 이 없으면 이렇게 하면 TextSource 를 추가합니다.

사용자를 나타내는 TextSource 개체가 있으면 이 개체는 TextSource 개체를 반환합니다.

사용자가 채팅을 끄거나 서버에 있지 않으면 이 메서드는 트리펫 nil , false 을 반환합니다.

매개 변수

userId: number

Class.Player 의 사용자 아이디.


반환

새로운 TextSource 가 사용자를 위해 생성된 경우 trueTextSource 를 반환합니다. 2>Class.TextSource2> 및 5>false5> 가 있는

생성

서버에 TextChatMessage를 보냅니다. 서버에서만 사용할 수 있습니다. LocalScript 또는 Script 에 1> Class.Script.RunContext|RunContext1> 의 4> Class.Script.RunContext4> 이 있습니다.

매개 변수

message: string

Class.TextChannel 에 대한 메시지 보내기.

metadata: string

메시지에 사용자 지정 메타데이터 추가.

기본값: ""

반환

Class.TextChatMessage 속성을 가진 TextChatMessage.Status 메시지.

이벤트

MessageReceived

Like TextChatService.MessageReceived , 클라이언트에서 TextChannel:DisplaySystemMessage() 가 호출되거나 서버로부터 유효한 TextChannel:SendAsync() 응답을 받을 때 발생합니다. 이 이벤트는 클라이언트에서만 발생합니다.

서버의 TextChannel.ShouldDeliverCallback 속성이 바인딩되고 반환하는 경우 false클라이언트는 발생하지 않습니다 TextChannel.MessageReceived .

Class.TextChatMessage 매개 변수를 사용하여 TextSource 및 메시지 텍스트(TextChatMessage.Text로)를 가져옵니다.

Class.TextChatMessage 매개 변수는 다음 중 하나인 TextChatService.OnIncomingMessage 또는 TextChannel.OnIncomingMessage에 바인딩된 함수의 최종 결과입니다.

매개 변수

incomingMessage: TextChatMessage

콜백

OnIncomingMessage

Class.TextChannel 이 들어오는 메시지를 받을 때 호출됩니다. 클라이언트에서만 구현할 수 있습니다.

이 메서드를 사용하여 TextChatMessages 를 장식합니다. 이 콜백이 TextChatMessageProperties 를 반환하면, 이 속성은 TextChatMessage 매개 변수와 결합되어 새로운 2>Class.TextChatMessage2> 를 생성합니다.

클라이언트에 메시지를 보내는 경우, 이 콜백은 두 번 실행됩니다. 첫 번째로 메시지가 로컬에서 처음 전송되고 받을 때, 그리고 클라이언트가 서버로부터 필터링된 메시지의 결과를 받을 때.

TextChannel.OnIncomingMessage 콜백은 항상 후에 Class.TextChatService.OnIncomingMessage 콜백을 실행합니다.

이 정의는 소스 코드에서 TextChannel 별로 정의해야 합니다. 여러 개의 채널 바인딩은 비동기적인 방식으로 서로 중첩됩니다.

Class.TextChatService:CreateDefaultTextChannels() 이 진실로 인식되면, 기본 TextChannels 는 특수 기본 동작을 표시하기 위해 내부적으로 내부적으로 할당된 내부적으로 할당된 내부적으로 할당된 내부적으로 할 수 있습니다.

매개 변수


반환

Class.TextChatMessageProps가 반환되면 이 속성은 TextChatMessage 매개 변수와 함께 병합되어 이 속성을 가진 새로운 TextChatMessage를 생성합니다.

ShouldDeliverCallback

Class.TextChannel 이 들어오는 메시지를 받았을 때 클라이언트마다 호출되어 클라이언트에 배달할지 여부를 결정합니다. 서버에서만 정의할 수 있습니다.

정의된 후 이 콜백은 true , 1 또는 "hello" 와 같은 진실한 값을 반환해야 합니다. 콜백이 다른 값을 반환하면 (즉, 1> nil1> 포함) 메시지를 해당 클라이언트에 전송하지 않지만, 발신자는

발신자는 TextChatMessage.TextSource 에 참조될 수 있습니다.

매개 변수

textSource: TextSource

반환