클라이언트 사이드 채팅 모듈 | 설명서

이 가이드는 레거시 채팅 시스템의 클라이언트 사이드 채팅 모듈을 설명합니다, 이는 더 이상 TextChatService 를 사용하는 대신 더 쉬운 및 현대적인 채팅 설정으로 새로운 사용자를 보다 쉽게 통합하는 데 사용됩니다. 기본 채팅 시스템을

다음 채팅 모듈을 사용하여 전통 채팅 시스템의 클라이언트 사이드 동작을 지원할 수 있습니다.

채팅 창

채팅 창은 전통 채팅 시스템의 클라이언트 측의 주요 채팅 모듈입니다.

메서드

채널 추가

매개 변수: string : channelName
설명: 은 지정된 channelName 과 함께 창에 채팅 채널 UI를 추가합니다.
반환: ChatChannelUI

채널 제거

매개 변수: string : channelName
설명: 은 창에서 지정한 채팅채널UI 를 제거합니다.
반환: 무효

채널 가져오기

매개 변수: string : channelName
설명: 채팅 채널 유이를 가져오려면 지정된 channelName 이 있는지 확인하십시오.
반환: ChatChannelUI 또는 nil

현재 채널 가져오기

매개 변수: string : channelName
설명: 현재 ChatChannelUI를 반환합니다.
반환: ChatChannelUI

현재 채널 전환

매개 변수: string : channelName
설명: 현재 채널을 ChatChannelUI로 전환하며, 제공된 channelName 이 있는 경우.
반환: 무효

보이게 하기

매개 변수: 없음
설명: 창이 표시되는지 여부를 반환합니다. 참고: 이 경우 채팅 창이 비활동적으로 투명하게 변경되면 창이 여전히 표시됩니다.
반환: 부울

시각적 개체 설정

매개 변수: bool : visible
설명: 채팅 창의 가시성을 설정합니다.
반환: 무효

페이드아웃 배경

매개 변수: 떠 있는 부동 소수점 수준:duration
설명: 지정된 duration 초 내에 배경을 켜서 나가세요. 참고: 나중에 흐림 컨트롤을 제어하는 지정된 duration 초 이후의 호출은 이전 호출을 덮어씁니다.
반환: 무효

페이드인 배경

매개 변수: 떠 있는 부동 소수점 수준:duration
설명: 지정된 duration 초 내에 배경에서 사라지는 섀도우를 줍니다. 참고: 나중에 섀도우 컨트롤을 위해 호출하는 것은 이전 호출을 재정의합니다.
반환: 무효

페이드아웃텍스트

매개 변수: 떠 있는 부동 소수점 수준:duration
설명: 지정된 duration 초 내에 텍스트가 사라지고 나면 텍스트를 지우기 시작합니다. 참고: 나중에 텍스트 지우기/출력을 제어하려면 이전 호출을 덮어씁니다.
반환: 무효

페이드인 텍스트

매개 변수: 떠 있는 부동 소수점 수준:duration
설명: 지정된 duration 초 내에 텍스트에 슬라이드합니다. 참고: 나중에 슬라이드 컨트롤을 제어하는 지정된 duration 초 내의 호출은 이전 호출을 덮어씁니다.
반환: 무효

채팅 바

Lua 채팅 시스템에 대한 클라이언트 측 텍스트 입력 처리기인 채팅 바 . 채팅 바에는 두 가지 키 구성 요소가 있습니다.

ChatBar , 플레이어가 메시지 및 명령(오렌지로 하이라이트)을 입력하는 TextBox
MessageMode , 메시지 전송 중에 표시되는 정보를 표시하는 TextLabel, 그리고 녹색으로 하이라이트된 메시지 전송에 대한 정보를 표시합니다(메시지 모드 참조)

메서드

GetTimer

매개 변수: 없음
설명: 채팅 바의 TextBox를 반환합니다.
반환: TextBox

메시지 모드 텍스트 레이블 가져오기

매개 변수: 없음
설명: 메시지 모드 TextLabel 를 반환합니다.
반환: TextLabel

초점이 맞춰져 있습니다.

매개 변수: 없음
설명: 채팅 바의 TextBox 가 포커스(플레이어가 상자에 입력하고 있음)인지 여부를 반환합니다(결과에 대해 결과에 대해 Executor:IsFocused)). 결과에 대한 전역 변수 가져오기의 적용.
반환: 부울

캡처 포커스

매개 변수: 없음
설명: 클라이언트가 채팅 바의 TextBox에 집중하도록 합니다. 결과에 대해 TextBox:CaptureFocus를 호출하는 것과 동일합니다.
반환: 무효

릴리스 포커스

매개 변수: bool : submitted = false
설명: 채팅 바의 초점을 해제합니다. TextBox . 만약 submitted 이 진실이라면, 플레이어가 Enter를 누른 것처럼 행동합니다.
반환: 무효

텍스트 재설정

매개 변수: 없음
설명: 채팅 바의 채팅 텍스트 Text 를 빈 문자열로 설정합니다.
반환: 무효

SettxtText

매개 변수: string : text
설명: 채팅 바의 Text를 지정된 TextBox로 설정합니다.
반환: 무효

Gettxt텍스트

매개 변수: 없음
설명: 채팅 바에 텍스트 반환 TextBox.Text .
반환: string

텍스트 레이블 텍스트 설정

매개 변수: string : text
설명: 메시지 모드의 Text를 지정된 TextLabel 로 설정합니다.
반환: 무효

가능 하게 만들기

매개 변수: 없음
설명: 채팅 바가 Visible인지 여부를 반환합니다.
반환: 부울

설정 활성화

매개 변수: bool : enabled
설명: 채팅 바가 Visible인지 여부를 설정합니다.
반환: 무효

텍스트 크기 설정

매개 변수: int : textSize
설명: 채팅 바의 TextSize 와 메시지 모드의 TextBox 를 모두 설정합니다.
반환: 무효

초기화 크기

매개 변수: 없음
설명: 채팅 바의 크기를 하나의 텍스트 줄로 재설정합니다.
반환: 무효

채널 대상 설정

매개 변수: string : channelName
설명: 은 채팅 채널에 대해 메시지를 제출할 채팅 채널 channelName 에 지정된 목표를 설정합니다.
반환: 무효

페이드아웃 배경

매개 변수: 떠 있는 부동 소수점 수준:duration 0> duration0>
설명: 지정된 duration 초 내에 배경을 켜서 나가세요. 참고: 나중에 흐림 컨트롤을 제어하는 지정된 duration 초 이후의 호출은 이전 호출을 덮어씁니다.
반환: 무효

페이드인 배경

매개 변수: 떠 있는 부동 소수점 수준:duration 0> duration0>
설명: 지정된 duration 초 내에 배경에서 사라지는 섀도우를 줍니다. 참고: 나중에 섀도우 컨트롤을 위해 호출하는 것은 이전 호출을 재정의합니다.
반환: 무효

페이드아웃텍스트

매개 변수: 떠 있는 부동 소수점 수준:duration 0> duration0>
설명: 지정된 duration 초 내에 텍스트가 사라지고 나면 텍스트를 지우기 시작합니다. 참고: 나중에 텍스트 지우기/출력을 제어하려면 이전 호출을 덮어씁니다.
반환: 무효

페이드인 텍스트

매개 변수: 떠 있는 부동 소수점 수준:duration 0> duration0>
설명: 지정된 duration 초 내에 텍스트에 슬라이드합니다. 참고: 나중에 슬라이드 컨트롤을 제어하는 지정된 duration 초 내의 호출은 이전 호출을 덮어씁니다.
반환: 무효

채팅 채널 UI

ChatChannelUI 는 서버로부터 받은 채팅메시지를 클라이언트 측에서 처리하고 채팅메시지 로그 디스플레이 와 연결된 채팅메시지를 전송합니다.

메서드

채널에 메시지 추가

매개 변수: ChatMessage
설명: 서버로부터 받은 채팅 메시지를 ChatMessageLogDisplay에 표시합니다.
반환: 무효

채널에서 마지막 메시지 제거

매개 변수: 없음
설명: 은 채팅 메시지 로그 디스플레이에서 가장 오래된 ChatMessage를 제거합니다.
반환: 무효

클리어 메시지 로그

매개 변수: 없음
설명: 은 채팅 메시지 로그 디스플레이에 있는 모든 ChatMessages를 제거합니다.
반환: 무효

채팅 메시지 로그 디스플레이

채팅 메시지 로그 디스플레이 는 채팅 메시지를 채팅채널 UI 에 표시합니다.

메서드

메시지 추가

매개 변수: 채팅 메시지message
설명: 메시지 로그 표시에 메시지 message 를 추가합니다.
반환: 무효

마지막 메시지 제거

매개 변수: 없음
설명: 메시지 로그 표시에서 가장 오래된 ChatMessage를 제거합니다.
반환: 무효

모든 메시지 다시 정렬

매개 변수: 없음
설명: 메시지 표시의 크기에 대해 메시지 표시의 순서를 재정렬합니다. 메시지 로그 표시가 재정렬된 경우 이 이름을 호출해야 합니다.
반환: 무효

지우기

매개 변수: 없음
설명: 메시지 로그 디스플레이에서 모든 채팅 메시지를 제거합니다.
반환: 무효

페이드아웃텍스트

매개 변수: 떠 있는duration
설명: 지정된 duration 초 내에 텍스트가 사라지고 나면 텍스트를 지우기 시작합니다. 참고: 나중에 텍스트 지우기/출력을 제어하려면 이전 호출을 덮어씁니다.
반환: 무효

페이드인 텍스트

매개 변수: 떠 있는duration
설명: 지정된 duration 초 내에 텍스트에 슬라이드합니다. 참고: 나중에 슬라이드 컨트롤을 제어하는 지정된 duration 초 내의 호출은 이전 호출을 덮어씁니다.
반환: 무효

채팅 사용자 상태

ChatCustomState는 채팅 바에서 사용자 정의 채팅 상태를 생성할 때 사용되는 콜백의 인터페이스입니다.

팀 채팅 및 개인 채팅에서 채팅 상태를 사용하여 플레이어에게 메시지가 전송될 위치를 나타냅니다.

콜백

텍스트 업데이트됨

매개 변수: 없음
설명: 채팅 바에 텍스트가 업데이트될 때 호출됩니다.
반환: 무효

메시지 받기

매개 변수: 없음
설명: 메시지가 단일 명령으로 기록되도록 호출됩니다. 이는 서버가 명령을 텍스트로 처리해야 하기 때문에 시작됩니다. 이는 서버가 명령을 텍스트로 처리해야 하기 때문에 시작됩니다.
반환: string

처리 완료 메시지

매개 변수: 없음
설명: 플레이어가 사용자 상태에서 처리하는 메시지를 제출할 때 호출됩니다. 메시지가 표시되거나 서버에 전송되지 않아야 하는 경우 이 메시지에 대해 true를 반환해야 합니다.
반환: 부울

파괴

매개 변수: 없음
설명: 수정된 상태 전에 채팅 바로 원래 상태로 재설정되고 있습니다.
반환: 무효

채팅 설정

ChatSettings 는 Lua 채팅 시스템의 클라이언트 측 설정 사전입니다. 이 모듈은 ModuleScript 라는 이름의 ChatSettings 에 저장되며, 1>Chat1> 게임 서비스의 내부에 있는 <

설정을 변경하려면 다음과 같은 방법으로 LocalScript 를 사용하세요:


-- ChatSettings 모듈 필요 (불러오다때까지 대기)
local Chat = game:GetService("Chat")
local ClientChatModules = Chat:WaitForChild("ClientChatModules")
local ChatSettings = require(ClientChatModules:WaitForChild("ChatSettings"))
-- 다른 테이블과 마찬가지로 설정을 변경할 수 있습니다.
ChatSettings.MaximumMessageLength = 100

채팅 동작 설정

뷰포트 드래그 가능

형식: boo로
기본: false
설명: Chat창 이 Draggable 인지 여부를 결정합니다.

창 재설정 가능

형식: boo로
기본: false
설명: 플레이어가 채팅 창 을 조정할 수 있는지 여부를 결정합니다.

게임패드 탐색 활성화

형식: boo로
기본: false
설명: 게임 패드가 채팅 UI를 탐색할 수 있는지 여부를 결정합니다.

사용자 소유 필터링 메시지 표시

형식: boo로
기본: true
설명: 플레이어가 필터된 채팅 메시지의 원본 콘텐츠를 볼지 여부를 결정합니다.

상단 표시 줄 없음과 채팅

형식: boo로
기본: false
설명: 상단 표시줄이 비활성화된 상태에서도 채팅 UI가 활성화되는지 여부를 결정합니다.

버블 채팅 활성화

형식: boo로
기본:: game:GetService("Players").BubbleChat
설명: 버블 채팅이 활성화되어 있는지 여부를 결정합니다.

클래식 채팅 활성화

형식: boo로
기본:: game:GetService("Players").ClassicChat
설명: 클래식 채팅이 활성화되어 있는지 여부를 결정합니다.

채팅 텍스트 크기 설정

채팅 창 텍스트 크기

유형: int
기본: 18
설명: 채팅 창에 텍스트의 크기를 결정합니다.

채팅 바 텍스트 크기

유형: int
기본: 18
설명: 채팅 바에 텍스트의 크기를 결정합니다.

채팅 창 텍스트 크기 전화

유형: int
기본: 14
설명: 휴대 전화의 채팅 창에 텍스트 크기를 결정합니다.

채팅 바 텍스트 크기 전화

유형: int
기본: 14
설명: 휴대 전화의 ChatBar에 텍스트 크기를 결정합니다.

글꼴 설정

기본 글꼴

유형: Enum.Font
기본: Enum.Font.SourceSansBold
설명: 채팅 창의 기본 크기 Font 를 결정합니다.

채팅 바 폰트

유형: Enum.Font
기본: Enum.Font.SourceSansBold
설명: 채팅 바의 기본 크기 Font 를 결정합니다.

색상 설정

배경색

유형: Color3
기본: Color3.new(0, 0, 0)
설명: 채팅 창의 BackgroundColor3 을 결정합니다.

기본 메시지 색상

유형: Color3
기본: Color3.new(1, 1, 1)
설명: 채팅 창에서 TextColor3 의 기본값을 결정합니다.

기본 이름 색상

유형: Color3
기본: Color3.new(1, 1, 1)
설명: 은 TextColor3 의 스피커 이름의 ChatMessages 에서 기본 0> TextColor30> 를 결정합니다.

채팅 바 배경 색

유형: Color3
기본: Color3.new(0, 0, 0)
설명: 채팅 바의 BackgroundColor3 을 결정합니다.

채팅 상자 색상

유형: Color3
기본: Color3.new(1, 1, 1)
설명: 채팅 바의 BackgroundColor3 을 결정합니다.

채팅 상자 텍스트 색상

유형: Color3
기본: Color3.new(0, 0, 0)
설명: 채팅 바의 TextColor3 을 결정합니다.

오류 메시지 텍스트 색상

유형: Color3
기본: Color3.fromRGB(245, 50, 50)
설명: 오류 메시지의 TextColor3 을 결정합니다.

창 설정

최소 창 크기

유형: UDim2
기본:: UDim2.new(0.3, 0, 0.25, 0)
설명: 채팅 창 (given that WindowResizable 이 활성화됨)의 가장 작은 크기를 결정합니다(0> 창 재설정 을 사용하면 크기를 조정할 수 있음).

최대 창 크기

유형: UDim2
기본: UDim2.new(1, 0, 1, 0)
설명: 채팅 창 (given that WindowResizable 이 활성화됨)의 가장 큰 크기를 결정합니다(0>WindowResizable0> 이 활성화됨).
노트: 이 크기를 전체 화면 크기보다 큰 경우 크기/위치 제한 검사로 이상한 일이 발생합니다.