TextChannel

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

เป็นตัวแทนของช่องแชทข้อความ มี TextSources เป็นลูกหลาน

เพื่อส่งข้อความในการแชทไปยัง TextChannel โทร TextChannel:SendAsync() จาก a LocalScript ที่ตรงกัน 1> Class.TextSource1> ของผู้ใช้ด้วย 4> TextSource.CanSend = true

ข้อความจากแท็งก์ข้อความที่แตกต่างกันสามารถแยกออกเป็นแท็งก์ต่างๆในหน้าต่างของการแชทโดยใช้ ChannelTabsConfiguration

เพื่อเรียนรู้เพิ่มเติม ดู ใน-เอ็กซ์เพรสเซส เท็กซ์ชาท

สรุป

คุณสมบัติ

  • อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

วิธีการ

อีเวนต์

  • เกิดขึ้นเมื่อ TextChannel:DisplaySystemMessage() ถูกเรียกในตัวเครื่องกลางหรือเมื่อตัวเครื่องกลางได้รับการตอบกลับที่ถูกต้องจากเซิร์ฟเวอร์

Callbacks

คุณสมบัติ

DirectChatRequester

อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน

วิธีการ

DisplaySystemMessage

แสดงข้อความระบบให้กับผู้ใช้ สามารถใช้ได้ใน LocalScript หรือใน Script ที่มี RunContext ของ 2>Ennum.RunContext2> เท่านั้น ข้อความจะปราก

พารามิเตอร์

systemMessage: string

ข้อความระบบส่งไปยัง TextChannel

metadata: string

ใช้เพื่อระบุประเภทข้อความของระบบ เช่น ข้อความระบบปกติ

ค่าเริ่มต้น: ""

ส่งค่ากลับ

A TextChatMessage ด้วย TextChatMessage.Status สมบัติที่ระบุสถานะของข้อความ

SetDirectChatRequester

void

พารามิเตอร์

requester: Player

ส่งค่ากลับ

void

AddUserAsync

ผลตอบแทน

เพิ่ม TextSource ให้กับ TextChannel ที่ได้รับ userid ของผู้ใช้ (มี Player.UserId ) สามารถใช้ได้ใน 2>Class.Script2> เท่านั้น

หาก TextSource ที่แทนที่ผู้ใช้ไม่มีอยู่จริง นี่จะเพิ่ม TextSource

หาก TextSource ที่แทนที่ผู้ใช้มีอยู่จริง นี่จะส่งคืน TextSource

หากผู้ใช้มีการแชทออกหรือไม่ได้อยู่ในเซิร์ฟเวอร์นี้จะกลับมาเป็นตัวอักษร nil``false

พารามิเตอร์

userId: number

รหัสผู้ใช้ของ Player


ส่งค่ากลับ

กลับ TextSource และ true หากมี TextSource ใหม่สำหรับผู้ใช้ 1> Class.TextSource1> และ 4> false

ผลตอบแทน

ส่ง TextChatMessage ไปยังเซิร์ฟเวอร์ สามารถใช้ได้เฉพาะใน LocalScript หรือใน Script ที่มี 1> Class.Script.RunContext|RunContext1> ของ 4> Ennum.RunContext.Client4>

พารามิเตอร์

message: string

ข้อความที่จะส่งไปยัง TextChannel

metadata: string

เมทาดาตาที่กำหนดเองเพื่อแนบมากับข้อความ

ค่าเริ่มต้น: ""

ส่งค่ากลับ

A TextChatMessage ด้วย TextChatMessage.Status สมบัติที่ระบุสถานะของข้อความ

อีเวนต์

MessageReceived

เหมือน TextChatService.MessageReceived เมื่อ TextChannel:DisplaySystemMessage() ถูกเรียกในเครื่องคอมพิวเตอร์หรือเมื่อเครื่องคอมพิวเตอร์ได้รับการตอบกลับที่ถูกต้องจากเซิร์ฟเวอร์ เหตุการ

หากค่า TextChannel.ShouldDeliverCallback ของเซิร์ฟเวอร์ถูกผูกและกลับมาที่ false คลิอุตจะไม่ไฟ TextChannel.MessageReceived

ใช้ตัวแปร TextChatMessage เพื่อรับ TextSource และข้อความของข้อความ (ด้วย TextChatMessage.Text )

ตัวแปร TextChatMessage คือผลสรุปที่สุดของฟังก์ชันใด ๆ ที่ผูกกับ TextChatService.OnIncomingMessage หรือ TextChannel.OnIncomingMessage

พารามิเตอร์

incomingMessage: TextChatMessage

ได้รับ TextChatMessage .


Callbacks

OnIncomingMessage

เรียกเมื่อ TextChannel ได้รับข้อความที่เข้ามา สามารถใช้ได้เฉพาะในลูกค้าเท่านั้น

ใช้สิ่งนี้เพื่อตกแต่ง TextChatMessages หากคืนค่านี้กลับมาเป็น TextChatMessageProperties พันธะสมบูรณ์กับตัวประกาย TextChatMessage เพื่อสร้างเป็น 2>Class.TextChatMessage2> ใหม่

เมื่อผูกกับลูกค้าส่งข้อความ โค้ดนี้จะประมาณเวลาสองครั้ง; ครั้งแรกเมื่อข้อความถูกส่งและได้รับการรับทราบในท้องถิ่นแล้ว และอีกครั้งเมื่อลูกค้าได้รับผลการกรองจากเซิร์ฟเวอร์

TextChannel.OnIncomingMessage คอลแล็คชันส์จะดำเนินการเสมอ หลัง คอลแล็คชันส์ TextChatService.OnIncomingMessage

ควรจะกำหนดได้เเค่ครั้งเดียวต่อ TextChannel รหัสการผูกติดตั้งหลายช่องจะทำงานร่วมกันในวิธีที่ไม่สามารถระบุได้

เมื่อ TextChatService:CreateDefaultTextChannels() เป็นความจริง ไม่เพียง แต่ ผู้ให้บริการ TextChannels เหล่านี้จะมี TextChannel.OnIncomingMessage คืนของโคลงการที่กำหนดเองเพื่อแสดงพฤติกร

พารามิเตอร์

ข้อความ TextChatMessage ที่กําลังมาถึง


ส่งค่ากลับ

หาก TextChatMessageProperties ถูกส่งกลับมาให้คุณลักษณะเหล่านี้จะผสานกับตัวแปร TextChatMessage เพื่อสร้าง TextChatMessage ด้วยคุณลักษณะเหล่านี้

ShouldDeliverCallback

เรียกสำหรับลูกค้าแต่ละรายเมื่อ TextChannel ได้รับข้อความที่เข้ามาเพื่อกำหนดว่าควรจัดส่งไปยังลูกค้าหรือไม่ สามารถตั้งค่าได้เฉพาะในเซิร์ฟเวอร์เท่านั้น

เมื่อกำหนดไว้แล้วตัวแปรนี้ต้องการกลับค่าที่เป็นความจริงเช่น true หรือ 1 หรือ "hello" เพื่อส่งข้อความไปยังลูกค้าที่กล่าวถึ

ผู้ส่งสามารถอ้างถึงได้โดย TextChatMessage.TextSource

พารามิเตอร์

textSource: TextSource

ส่งค่ากลับ