TextChannel
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Đại diện một kênh trò chuyện văn bản. Đứng thứ nhất trong danh sách là TextSources như là những con cháu.
Để gửi một tin nhắn trò chuyện đến TextChannel , gọi TextChannel:SendAsync() từ một LocalScript . Tương ứng được 1> Class.TextSource1> của người dùng với 4> TextSource.CanSend = true4>
Các tin nhắn từ các kênh Text khác nhau có thể được phân chia thành các thẻ khác nhau trong cửa sổ trò chuyện bằng cách sử dụng ChannelTabsConfiguration .
Để biết thêm, xem Trò chuyện văn bản trong kinh nghiệm.
Tóm Tắt
Thuộc Tính
Phương Pháp
Hiển thị một thông điệp hệ thống cho người dùng.
Thêm một TextSource vào TextChannel đã được cấp id cho một Player .
Gửi một TextChatMessage đến máy chủ.
Sự Kiện
Làm nổ khi TextChannel:DisplaySystemMessage() được gọi trên client, hoặc khi client nhận được một câu trả lời TextChannel:SendAsync() hợp lệ từ máy chủ.
Gọi Lại
Gọi khi TextChannel đang nhận được một tin nhắn đang đến.
Gọi cho mỗi khách hàng khi TextChannel nhận được một tin nhắn đang đến để xác định có nên gửi tin nhắn đó cho khách hàng đó hay không.
Thuộc Tính
DirectChatRequester
Phương Pháp
DisplaySystemMessage
Hiển thị một thông điệp hệ thống cho người dùng. Chỉ có thể được sử dụng trong một LocalScript , hoặc trong một Script với RunContext của 2>Enum.RunContext.Client2>. Thông điệp chỉ
Tham Số
Tin nhắn hệ thống đã được gửi đến TextChannel .
Sử dụng để xác định các loại tin nhắn hệ thống, chẳng hạn như các tin nhắn hệ thống mặc định.
Lợi Nhuận
Một TextChatMessage với TextChatMessage.Status tính năng cho phép thể hiện tình trạng của thông tin nhắn.
AddUserAsync
Thêm một TextSource vào TextChannel đã được cấp userid của người dùng (với Player.UserId). Chỉ có thể được sử dụng trong một 2>Class.Script2> .
Nếu một TextSource đại diện cho người dùng không tồn tại, điều này thêm một TextSource .
Nếu một TextSource đại diện cho người dùng tồn tại, điều này trả lại TextSource .
Nếu người dùng có chat off hoặc không ở trong máy chủ, điều này trả lại một tuần nil , false .
Tham Số
Lợi Nhuận
Làm trả lại TextSource và true nếu một Class.TextSource mới được tạo cho người dùng, TextSource và 1> false
SendAsync
Gửi một TextChatMessage đến máy chủ. Chỉ có thể được sử dụng trong một LocalScript , hoặc trong một Script với 1> Class.Script.RunContext|RunContext1> của 4> Enums.RunContext.Client4> .
Tham Số
Tin nhắn để gửi đến TextChannel .
Dữ liệu mục đích để kết nối với thông tin nhắn.
Lợi Nhuận
Một TextChatMessage với TextChatMessage.Status tính năng cho phép thể hiện tình trạng của thông tin nhắn.
Sự Kiện
MessageReceived
Giống như TextChatService.MessageReceived , bắt đầu khi TextChannel:DisplaySystemMessage() được gọi trên client, hoặc khi client nhận được một phản hồi đúng thời gian TextChannel:SendAsync() từ máy chủ. Sự kiện này chỉ được thực hiện trên client.
Nếu đặt tính TextChannel.ShouldDeliverCallback của máy chủ và trả lại false , client sẽ không bắn TextChannel.MessageReceived .
Sử dụng tham số TextChatMessage để lấy TextSource và văn bản của tin nhắn (với TextChatMessage.Text).
Tham số TextChatMessage là kết quả cuối cùng của bất kỳ hàm được liên kết với TextChatService.OnIncomingMessage hoặc TextChannel.OnIncomingMessage .
Tham Số
Nhận được TextChatMessage .
Gọi Lại
OnIncomingMessage
Gọi khi TextChannel đang nhận được một tin nhắn đang đến. Chỉ có thể được thực hiện trên client.
Sử dụng này để trang trí TextChatMessages . Nếu tiếp tục này kết thúc bằng một TextChatMessageProperties , những thuộc tính này được hợp nhất với thuộc tính TextChatMessage để tạo thành một cái gì đó
Khi kết nối với client để gửi một tin nhắn, hành động này được thực hiện hai lần; lần đầu tiên khi thông điệp được gửi và nhận từ máy chủ, và lần thứ hai khi máy chủ nhận kết quả của thông điệp lọc từ máy chủ.
TextChannel.OnIncomingMessage các hàm luôn được gọi sau khi các hàm trong TextChatService.OnIncomingMessage được gọi.
Điều này nên được định nghĩa chỉ một lần mỗi TextChannel trong mã nguồn. Nhiều kết nối đến cùng một kênh sẽ bị vượt qua nhau theo cách nondeterministic.
Khi TextChatService:CreateDefaultTextChannels() đúng, những kênh TextChannels mặc định này có các TextChannel.OnIncomingMessage hồi gọi được giao dịch bên trong để hiển thị hành vi đặt biệt.
Tham Số
Lời nói TextChatMessage đang đến.
Lợi Nhuận
Nếu một TextChatMessageProperties được trả lại, những thuộc tính này được hợp nhất với thuộc tính TextChatMessage để tạo ra một TextChatMessage mới với những thuộc tính đó.
ShouldDeliverCallback
Gọi cho mỗi khách hàng khi TextChannel nhận được một tin nhắn đang đến để xác định có nên gửi tin nhắn đó cho khách hàng đó hay không. Chỉ có thể được định nghĩa trên máy chủ.
Một khi đã định nghĩa, hàm này cần phải trả một giá trị đúng như true , 1 hoặc "hello" để gửi thông điệp đến khách hàng nói. Nếu hàm này trả một giá trị khác (bao gồ
Người gửi có thể được tham chiếu bởi TextChatMessage.TextSource .