Bạn có thể sử dụng các mô-đun trò chuyện sau đây để hỗ trợ hành vi của phía client của Hệ thống trò chuyện thừa kế .
Cửa sổ trò chuyện
Cửa sổ trò chuyện là một trong những mô-đun trò chuyện chính của Legacy Chat System.
Phương pháp
Thêm kênh
- Trở lại: ChatChannelUI
Loại bỏ kênh
- Mô tả: Loại bỏ một ChatChannelUI với các thông tin đã được cung cấp từ cửa sổ.
- Trả về: void
Nhận kênh
- Mô tả: Nhận ChatChannelUI với channelName đã được cung cấp nếu tồn tại.
Lấy kênh hiện tại
- Mô tả: Trả lại hiện tại ChatChannelUI .
- Trở lại: ChatChannelUI
Đổi kênh hiện tại
- Trả về: void
Hiển thị
- Các biến: Không có
- Mô tả: Trả về có hay không có các cử chỉ đang xem. Ghi chú: điều này tham khảo đến UI trò chuyện phổ quát; khi cử chỉ trò chuyện biến mất do lý do nào đó, cử chỉ vẫn được xem như hiển thị.
- Trả về: ool
Hiển thị SetVisible
- Mô tả: Đặt hiển thị của cửa sổ trò chuyện.
- Trả về: void
Hình ảnh nền
- Mô tả: Mời ra nền sau khi đã đặt duration trong giây. Ghi chú: Các cuộc gọi sau đó để điều khiển mời ra / ra sẽ không bị nhận.
- Trả về: void
Hình ảnh nền
- Mô tả: Mờ dần trên nền sau khi đã đặt duration trong giây. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ dần sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Văn bản mờ dần
- Mô tả: Mờ dần chữ trên các duration giây. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ dần sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Mời chữ
- Mô tả: Mờ dần trong văn bản trên các duration trong giây lát. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ trong/thoát sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Bar trò chuyện
The ChatBar handle client-side text entry for the Lua Chat System. Có hai thành phần chính của ChatBar:
- ChatBar , a TextBox , where the player inputs messages and commands ( highlighted in orange)
- MessageMode , a TextLabel , which can display information about the message being sent (được Highlight bằng màu xanh lá cây)
Phương pháp
Nhận zm
- Các biến: Không có
- Mô tả: Trả lại Texture của thanh chat.
- Trả về: TextBox
Nhận Thẻ Tên Tin Nhắn
- Các biến: Không có
- Mô tả: Trả lại MessageMode TextLabel .
- Trả về: TextLabel
Đang tập trung
- Các biến: Không có
- Mô tả: Trả về whether the chat bar's TextBox is in focus (player is typing in box). Equivalent to calling TextBox:IsFocused on the result of GetExecutor.
- Trả về: ool
Tập trung
- Các biến: Không có
- Mô tả: Bắt buộc khách hàng tập trung vào TextBox của thanh trình duyệt. Tương đương với việc gọi TextBox:CaptureFocus trên kết quả của Get:`Get`, tương đương với việc gọi 0> Texture:CaptureFocus0> trên kết quả của Get:`Get`, tương đương với việc gọi 3> Texture:CaptureFocus
- Trả về: void
Tập trung phát hành
- Mô tả: Thảo luận trên trang chat TextBox . If submitted is true, this will behave as if the player pressed Enter to submit the tin nhắn.
- Trả về: void
Đặt lại Văn bản
- Các biến: Không có
- Mô tả: Đặt Text của thanh trò chuyện TextBox đến dòng chuỗi.
- Trả về: void
Settxt
- Mô tả: Đặt Text của thanh trò chuyện TextBox đến thanh trò chuyện được cung cấp 0> text0> .
- Trả về: void
Nhận TexasText
- Các biến: Không có
- Mô tả: Trả lại text trong các dòng trò chuyện TextBox.Text .
- Trả về: string
SetTextLabelText
- Mô tả: Đặt Text của MessageMode TextLabel lên 0> text0> đã được cho.
- Trả về: void
Được kích hoạt
- Các biến: Không có
- Mô tả: Trả lại có phải thanh chat là Visible .
- Trả về: ool
Đã bật
- Mô tả: Đặt whether chat bar is Visible .
- Trả về: void
ĐặtKíchThướcChữ
- Mô tả: Đặt TextSize của cả hai thanh trình chat bar's TextBox và MessageMode 0> TextLabel0> .
- Trả về: void
Đổi kích thước
- Các biến: Không có
- Mô tả: Đặt lại kích thước thanh trò chuyện lên một dòng chữ.
- Trả về: void
Đặt mục tiêu kênh
- Mô tả: Đặt mục tiêu ChatChannelUI đã được cấp cho nó channelName mà thanh dòng trò chuyện nên gửi tin nhắn.
- Trả về: void
Hình ảnh nền
- Mô tả: Mời ra nền sau khi đã đặt duration trong giây. Ghi chú: Các cuộc gọi sau đó để điều khiển mời ra / ra sẽ không bị nhận.
- Trả về: void
Hình ảnh nền
- Mô tả: Mờ dần trên nền sau khi đã đặt duration trong giây. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ dần sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Văn bản mờ dần
- Mô tả: Mờ dần chữ trên các duration giây. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ dần sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Mời chữ
- Mô tả: Mờ dần trong văn bản trên các duration trong giây lát. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ trong/thoát sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Giao diện trò chuyện
ChatChannelUI là phiên bản client của ChatChannel . Nó nhận Tin nhắn trò chuyện từ máy chủ và truyền chúng cho 1>Màn hình hiển thị tin nhắn1> liên kết với nó.
Phương pháp
Thêm thông điệp đến kênh
Cài đặt: Tin nhắn trò chuyện
Mô tả: Thêm một tin nhắn trò chuyện nhận được từ máy chủ vào ChatMessageLogDisplay .
Trả về: void
Loại bỏ LastMessageFromChannel
- Các biến: Không có
- Mô tả: Loại bỏ các thông điệp trò chuyện lâu đời nhất được tìm thấy trong Hiển thị ChatMessageLog .
- Trả về: void
Xóa tin nhắn
- Các biến: Không có
- Trả về: void
Hiển thị tin nhắn trò chuyện
The ChatMessageLogDisplay manages the rendering of ChatMessages in a ChatChannelUI .
Phương pháp
Thêm Tin Nhắn
- Mô tả:: Thêm một message vào trình phát tin nhắn.
- Trả về: void
Loại bỏ Tin nhắn Cuối cùng
- Các biến: Không có
- Mô tả:: Loại bỏ thông điệp ChatMessage lâu đời nhất trong hiển thị nhật ký.
- Trả về: void
Đổi tất cả các tin nhắn
- Các biến: Không có
- Mô tả: Lọ lại tất cả các màn hình hiển thị tin nhắn theo thứ tự, tương ứng với kích thước của màn hình hiển thị tin nhắn. Điều này nên được gọi nếu màn hình hiển thị tin nhắn được thay đổi kích thước.
- Trả về: void
Rõ ràng
- Các biến: Không có
- Mô tả:: Loại bỏ tất cả ChatMessages khỏi hiển thị lịch sử tin nhắn.
- Trả về: void
Văn bản mờ dần
- Mô tả: Mờ dần chữ trên các duration giây. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ dần sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Mời chữ
- Mô tả: Mờ dần trong văn bản trên các duration trong giây lát. Ghi chú: Các cuộc gọi sau đó để điều khiển mờ trong/thoát sẽ khắc phục các cuộc gọi trước đó.
- Trả về: void
Trạng thái Tùy chỉnh trò chuyện
The ChatCustomState is an 界面 of callbacks used when creating a custom chat state in the chat bar.
Cúi xuống trò chuyện và trò chuyện nhóm sử dụng ChatCustomState để cho người chơi biết nơi mà tin nhắn của họ sẽ được khoản
Các hàm gọi
Cập nhật văn bản
- Các biến: Không có
- Mô tả: Gọi khi văn bản trong thanh trò chuyện được cập nhật.
- Trả về: void
Nhận tin nhắn
- Các biến: Không có
- Mô tả: Gọi để lấy văn bản của thông điệp như nó sẽ được viết như một mệnh lệnh duy nhất. Điều này được sử dụng trong trường hợp máy chủ cần xử lý mệnh lệnh như một tập lệnh, chứ không phải trạng thái hiển thị của mệnh lệnh.
- Trả về: string
Tin nhắn đã xử lý
- Các biến: Không có
- Mô tả: Gọi khi người chơi gửi thông điệp đang được xử lý bởi trạng thái tùy chỉnh. Điều này nên trả lại true nếu thông điệp không được hiển thị hoặc gửi đến máy chủ.
- Trả về: ool
Phá hủy
- Các biến: Không có
- Mô tả: Gọi là ChatBar đang được đặt lại trạng thái gốc của nó trước khi điều chỉnh trạng thái tùy chỉnh.
- Trả về: void
Cài đặt trò chuyện
The ChatSettings is a dictionary of settings for the client-side of the Lua Chat System. They are stored in a ModuleScript named ChatSettings, which can be found inside of the 1> Trò chuyện1> game service, under the 4> Folder4> named 7> ClientChatModule7> . The module may be required and
Để thay đổi cài đặt, yêu cầu module này bằng cách sử dụng một LocalScript trong các cách sau đây:
-- Yêu cầu module ChatSettings (chờ đợi nó tải)local Chat = game:GetService("Chat")local ClientChatModules = Chat:WaitForChild("ClientChatModules")local ChatSettings = require(ClientChatModules:WaitForChild("ChatSettings"))-- Đổi cài đặt như bạn sẽ với bất kỳ bảng khác.ChatSettings.MaximumMessageLength = 100
Cài đặt hành vi trò chuyện
WindowDraggable
- Loại: Boolean
- Mặc định: false
Thay đổi kích thước cửa sổ
- Loại: Boolean
- Mặc định: false
- Mô tả: Xác định có thể thay đổi kích thước Cửa sổ trò chuyện bằng cách người chơi có thể thay đổi kích thước Cửa sổ trò chuyện
GamepadĐã bật
- Loại: Boolean
- Mặc định: false
- Mô tả: Xác định xem gamepad có thể duyệt UI trò chuyện.
Hiển thị tin nhắn bị lọc của người dùng
- Loại: Boolean
- Mặc định: true
- Mô tả: Xác định whether players should see the filtered version of their chat messages, or the original content they typed in.
Chat với Top Bar Off
- Loại: Boolean
- Mặc định: false
- Mô tả: Xác định whether the chat UI is enabled even if the topbar is disabled.
BubbleChatĐã bật
- Loại: Boolean
- Mặc định: game:GetService("Players").BubbleChat
- Mô tả: Xác định có phải bạn chủ động trò chuyện bong bóng được kích hoạt không.
ClassicChatĐã bật
- Loại: Boolean
- Mặc định: game:GetService("Players").ClassicChat
- Mô tả: Xác định có phải chat cổ điển được bật.
Cài đặt kích thước chữ
Kích thước ChatWindow
- Loại: int
- Mặc định: 18
- Mô tả: Xác định kích thước văn bản trong Cửa sổ trò chuyện .
Kích thước ChatBarText
Kích thước màn hình trò chuyện
- Loại: int
- Mặc định: 14
- Mô tả: Xác định kích thước của văn bản trong Cửa sổ trò chuyện cho điện thoại.
Kích thước màn hình chat
Cài đặt chữ
Bảng mặc định
- Loại: Enum.Font
- Mặc định: Enum.Font.SourceSansBold
Font trò chuyện
- Loại: Enum.Font
- Mặc định: Enum.Font.SourceSansBold
Cài đặt màu
Màu chủ đề
- Loại: Color3
- Mặc định: Color3.new(0, 0, 0)
Màu thông điệp mặc định
- Loại: Color3
- Mặc định: Color3.new(1, 1, 1)
Màu mặc định
- Loại: Color3
- Mặc định: Color3.new(1, 1, 1)
Màu chủ đề trò chuyện
- Loại: Color3
- Mặc định: Color3.new(0, 0, 0)
Màu ChatBar
- Loại: Color3
- Mặc định: Color3.new(1, 1, 1)
Màu ChatBar
- Loại: Color3
- Mặc định: Color3.new(0, 0, 0)
Màu thông điệp lỗi
- Loại: Color3
- Mặc định: Color3.fromRGB(245, 50, 50)
- Mô tả: Định nghĩa lỗi.
Cài đặt Màn hình
Kích thước Cửa sổ Tối thiểu
- Loại: UDim2
- Mặc định:: UDim2.new(0.3, 0, 0.25, 0)
Kích thước màn hình tối đa
- Loại: UDim2
- Mặc định:: UDim2.new(1, 0, 1, 0)
- Mô tả: Xác định kích thước lớn nhất có thể của Cửa sổ trò chuyện (đã bật Cửa sổ thay đổi kích thước ).
- Ghi chú: Nếu điều này được thay đổi để lớn hơn kích thước màn hình đầy đủ, những điều kỳ lạ bắt đầu xảy ra với giới hạn kích thước / vị trí kiểm tra.
Vị trí Cửa sổ mặc định
- Loại: UDim2
- Mặc định:: UDim2.new(0, 0, 0, 0)
- Mô tả: Xác định vị trí mặc định của Cửa sổ trò chuyện .
Màn hình cảm ứng
- Loại: UDim2
- Mặc định:: UDim2.new(0.5, 0, 0.5, (7 * 2) + (5 * 2))>
- Mô tả: Xác định kích thước mặc định của Cửa sổ trò chuyện trên điện thoại.
Bảng kích thước cửa sổ mặc định
- Loại: UDim2
- Mặc định:: UDim2.new(0.4, 0, 0.3, (7 * 2) + (5 * 2))>
- Mô tả: Xác định kích thước mặc định của Cửa sổ trò chuyện trên bảng.
Màn hình mặc định
- Loại: UDim2
- Mặc định:: UDim2.new(0.3, 0, 0.25, (7 * 2) + (5 * 2))
- Mô tả: Xác định kích thước mặc định của Cửa sổ trò chuyện trên máy tính xách tay.
Tắt và bật trong cài đặt
Thời gian mờ dần của cửa sổ trò chuyện
Thời gian mờ dần ChatWindowTextFadeOutTime
Thời gian biểu tượng trò chuyện
- Loại: float (giây)
- Mặc định: 0.8
- Mô tả: Xác định thời gian mà các thành phần trên màn hình trò chuyện biến mất dài nhất.
Chat nên biến mất khi nhận thông tin mới
- Loại: Boolean
- Mặc định: false
- Mô tả: Xác định có nên đổi màu chat khi nhận những tin nhắn mới.
Tốc độ hoạt ảnh sống động trong trò chuyện
- Loại: float
- Mặc định: 20.0
- Mô tả: Xác định tỷ lệ khung hình của hoạt họa mờ dần trong UI chat.
Cài đặt Kênh
Tên kênh chung
- Loại: string
- Mặc định:: "All"
- Mô tả: Định danh kênh mặc định.
EchoMessagesInGeneralKênh
- Loại: Boolean
- Mặc định: true
- Mô tả: Xác định có nên sao chép những thông điệp đến các kênh khác như kênh mặc định không.
Độ dài tối đa của MaxChannelName
- Loại: int
- Mặc định: 12
- Mô tả: Xác định chiều dài tối đa của tên kênh trước khi nó bị cắt.
Độ dài của thông điệp
- Loại: int
- Mặc định: 50
- Mô tả: Xác định số lượng tối đa ChatMessage có thể được hiển thị trong một kênh trò chuyện.
Hiển thịJoinAndLeaveHelpText
- Loại: Boolean
- Mặc định: false
- Mô tả: Xác định có phải hiển thị mô tả cho văn bản trợ giúp khi tham gia/rời kênh.
Cài đặt tin nhắn
Độ dài tối đa của thông điệp
- Loại: int
- Mặc định: 200
- Mô tả: Xác định chiều dài tối đa của ChatMessages .
Không được phép không gian trắng
- Loại: array< string >
- Mặc định:: {"\n", "\r", "\t", "\v", "\f"}
- Mô tả: Xác định các kí tự trắng cấm.
Nhấp vào tên người chơi để
- Loại: Boolean
- Mặc định: true
- Mô tả: Xác định whether người chơi có thể nhấp vào tên của một người chơi khác để tham gia vào một cuộc trò chuyện im lặng với họ.
Nhấp vào tên kênh để cài đặt kênh chính
- Loại: Boolean
- Mặc định: true
- Mô tả: Xác định whether the player can click on a kênh's tab to set it as their main kênh.
Cài đặt khác
Tên người chơi
- Loại: Boolean
- Mặc định: true
- Mô tả: Xác định whether the whisper command should auto-complete player names.
Sự kiện
Đã thay đổi cài đặt
- Các biến: Library.string``settingName , Biến thể 0> newValue0>
- Mô tả: Lửa khi một cài đặt với các tham số được cho đã thay đổi thành settingName .