TextChannel

Hiển Thị Bản Đã Lỗi Thời

*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

Phương Pháp

Sự Kiện

Gọi Lại

Thuộc Tính

DirectChatRequester

Chỉ Đọc
Không Sao Chép
Đọc Song Song

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ố

systemMessage: string

Tin nhắn hệ thống đã được gửi đến TextChannel .

metadata: string

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.

Giá Trị 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.

SetDirectChatRequester

void

Tham Số

requester: Player

Lợi Nhuận

void

AddUserAsync

Sinh Lợi

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ố

userId: number

ID người dùng của Player .


Lợi Nhuận

Làm trả lại TextSourcetrue nếu một Class.TextSource mới được tạo cho người dùng, TextSource và 1> false

Sinh Lợi

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ố

message: string

Tin nhắn để gửi đến TextChannel .

metadata: string

Dữ liệu mục đích để kết nối với thông tin nhắn.

Giá Trị 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.

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ố

incomingMessage: TextChatMessage

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 .

Tham Số

textSource: TextSource

Lợi Nhuận