TextChannel

사용되지 않는 항목 표시

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

텍스트 채팅 채널을 나타냅니다. 후손으로 TextSources를 포함합니다.

채팅 메시지를 TextChannel 보내려면 Class.TextChannel:SendAsync()``Class.LocalScript를 호출하십시오.사용자의 해당 1> 와 4> 가 해당 채널에 있어야 합니다.

다른 텍스트 채널의 메시지는 ChannelTabsConfiguration를 사용하여 채팅 창의 다른 탭으로 분리할 수 있습니다.

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

요약

속성

  • 읽기 전용
    복제되지 않음
    병렬 읽기

    The TextChannel 는 직접 메시지를 보낼 수 있는 사용자에게만 메시지를 전달합니다.The DirectChatRequester .

메서드

이벤트

콜백

속성

DirectChatRequester

읽기 전용
복제되지 않음
병렬 읽기

The 는 직접 메시지를 보낼 수 있는 사용자에게만 메시지를 전달합니다. 이 속성은 을 사용하여만 설정할 수 있습니다.

메서드

DisplaySystemMessage

사용자에게 시스템 메시지를 표시합니다.오직 LocalScript 또는 Class.Script``Class.Script.RunContext|RunContext``Enum.RunContext.Client 와 함께 사용할 수 있습니다.메시지는 해당 사용자에게만 표시되며 자동으로 필터링되거나 지역화되지 않습니다.

매개 변수

systemMessage: string

시스템 메시지가 TextChannel 보내졌습니다.

기본값: ""
metadata: string

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

기본값: ""

반환

메시지의 상태를 나타내는 TextChatMessage 속성이 있는 A TextChatMessage.Status 메시지 조건을 나타내는 속성.

SetDirectChatRequester

()

설정 DirectChatRequester 에 대한 TextChannel. 이 메서드는 서버 스크립트에서만 사용할 수 있습니다.

TextChatService와 함께 작업하고 기본 텍스트 채널 외부에 사용자 지정 직접 채팅 구현이 있는 경우 이 API를 사용하십시오.

부모인 에 호출되고 기존의 가 없는 경우, 요청된 사용자를 채널로 추가하고 채널 속성을 설정합니다.

DirectChatRequester가 설정되면 채팅을 지시할 수 있는 사용자 간 메시지만 전달됩니다.When is set, only messages between users that can direct chat with the DirectChatRequester are delivered.


local function createWhisperChannel(fromPlayer, toPlayer)
local whisperChannel = Instance.new("TextChannel")
whisperChannel:SetDirectChatRequester(fromPlayer)
whisperChannel:AddUserAsync(toPlayer.UserId)
-- TextChannel 인스턴스에는 이제 2개의 TextSource 인스턴스가 있습니다.
return whisperChannel
end

매개 변수

requester: Player
기본값: ""

반환

()

AddUserAsync

생성

사용자의 지정 ID TextSourceTextChannel 를 추가하여 사용자에게 제공됩니다(Player.UserId 사용). 오직 Script 에서만 사용할 수 있습니다.

사용자를 나타내는 TextSource 가 존재하지 않으면 이에 TextSource 가 추가됩니다.

사용자를 나타내는 TextSource 가 존재하면 이는 TextSource 를 반환합니다.

사용자가 채팅을 끄거나 서버에 없으면 이 함수는 tuple nil , false 를 반환합니다.

매개 변수

userId: number

Player의 사용자 ID.

기본값: ""

반환

사용자에게 새로운 TextSource 가 생성되면 trueTextSource 또는 TextSourcefalse 가 있으면 기존의 TextSource 또는 nilfalse 가 있으면 사용자가 채팅을 끄거나 이 서버에 없습니다.

생성

서버에 TextChatMessage 를 보냅니다. 오직 LocalScript 또는 Script 에서 RunContextEnum.RunContext.Client 와 함께 사용할 수 있습니다.

매개 변수

message: string

TextChannel 에 보낼 메시지.

기본값: ""
metadata: string

메시지에 연결할 사용자 지정 메타데이터.

기본값: ""

반환

메시지의 상태를 나타내는 TextChatMessage 속성이 있는 A TextChatMessage.Status 메시지 조건을 나타내는 속성.

이벤트

MessageReceived

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

서버의 속성이 바인딩되어 반환되면 클라이언트가 발사되지 않습니다.

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

TextChatMessage 매개 변수는 TextChatService.OnIncomingMessage 또는 TextChannel.OnIncomingMessage에 바인딩된 모든 함수의 최종 결과입니다.

매개 변수

incomingMessage: TextChatMessage

받은 TextChatMessage입니다.


콜백

OnIncomingMessage

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

이것을 사용하여 TextChatMessages를 장식하십시오.이 콜백이 TextChatMessageProperties를 반환하면 해당 속성이 TextChatMessage 매개 변수와 병합되어 새로운 TextChatMessage를 생성합니다.

클라이언트에서 메시지를 보낼 때 바인딩되면 이 콜백은 메시지가 처음 로컬에서 전송되고 받을 때와 클라이언트가 서버에서 필터링된 메시지의 결과를 받을 때 두 번 실행됩니다.

TextChannel.OnIncomingMessage 콜백은 항상 후에 콜백 TextChatService.OnIncomingMessage 실행됩니다.

이는 소스 코드에서 한 번만 정의되어야 합니다(TextChannel).동일한 채널에 대한 여러 바인딩이 결정적이지 않은 방식으로 서로 무시됩니다.

가 true이면, 기본 는 특별한 기본 동작을 표시하기 위해 내부적으로 할당된 콜백을 가지게 됩니다.

매개 변수


반환

TextChatMessageProperties가 반환되면 해당 속성이 TextChatMessage 매개 변수와 병합되어 해당 속성을 가진 새로운 TextChatMessage를 생성합니다.

ShouldDeliverCallback

TextChannel 받을 때 각 클라이언트에 대해 호출되어 해당 클라이언트에 메시지가 전달되어야 하는지 여부를 결정합니다.서버에서만 정의할 수 있습니다.

정의되면 이 콜백은 트루 값인 true , 1 또는 "hello" 을 반환하여 해당 클라이언트에 메시지를 전달해야 합니다.콜백이 다른 것을 반환하면(포함 nil ), 메시지는 클라이언트에 전달되지 않지만 발신자는 메시지를 보게 됩니다.

발신자는 TextChatMessage.TextSource 에 참조될 수 있고, 수신자는 textSource 인수입니다.콜백이 모든 가능한 수신자를 통해 반복하기 때문에 발신자와 수신자가 동일할 수 있습니다.Roblox Studio에서 솔로 플레이 모드에 있는 동안 메시지의 전송자와 수신자가 유일할 것입니다.

매개 변수

메시지를 보내는 메시지의 발신자도 포함된 메시지.

textSource: TextSource

메시지를 받을 사용자의 TextSource입니다.


반환