TextChatService
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
บริการที่จัดการในการแชทข้อความในประสบการณ์ รวมถึงการจัดการช่อง การตกแต่งข้อความ การกรองข้อความ การสร้างคำสั่ง และการพัฒนาระเบียงการแชท
เพื่อเรียนรู้เพิ่มเติม ดู ใน-เอ็กซ์เพรสเซส เท็กซ์ชาท
สรุป
คุณสมบัติ
กำหนดว่าจะเปิดใช้งาน TextChatService หรือไม่ก็จะย้อนกลับไปใช้ระบบการแชทในอดีต
กำหนดว่า TextChatService ควรสร้างค่าเริ่มต้น TextChatCommands หรือไม่
กำหนดว่า TextChatService ควรสร้างค่าเริ่มต้น TextChannels
วิธีการ
แสดงฟองบับการแชทเหนือส่วนหนึ่งหรือตัวละครผู้เล่นที่ให้
กำหนดว่าผู้ใช้มีอนุญาตให้แชทกับผู้ใช้อื่นในประสบการณ์ตามการตั้งค่าการควบคุมของผู้ปกครองของพวกเขา
อีเวนต์
เกิดขึ้นเมื่อ TextChatService:DisplayBubble() ถูกเรียก
เกิดขึ้นเมื่อ TextChannel:DisplaySystemMessage() ถูกเรียกในตัวเครื่องกลางหรือเมื่อตัวเครื่องกลางได้รับการตอบกลับที่ถูกต้องจากเซิร์ฟเวอร์
เปิดให้บริการเมื่อ TextChannel:SendAsync() ถูกเรียกโดยลูกค้าส่ง
Callbacks
คุณสมบัติ
ChatTranslationEnabled
ChatVersion
กำหนดว่าจะเปิดใช้งาน TextChatService หรือไม่ หรือย้อนกลับไปใช้ระบบการแชทในอดีต การตั้งค่าค่านี้ให้เป็น Enum.ChatVersion.LegacyChatService จะปิดการใช้งาน TextChatService อย่างมีประสิทธ
CreateDefaultCommands
กำหนดว่า TextChatService ควรสร้างค่าเริ่มต้น TextChatCommands หรือไม่
หากเป็นเช่นนั้น, ต่อไปนี้ TextChatCommands ได้รับการสร้างและวางใน Folder ที่มีชื่อว่า TextChatCommands ภายใน 2>Class.TextChatService2> :
<tbody><tr><td><b>RBXล้างคำสั่ง</b></td><td>ล้างข้อมูล</td><td>คลาส</td><td>ล้างบันทึกการแชทสำหรับผู้ใช้ท้องถิ่น</td><td><code>/cls</code></td></tr><tr><td><b>RBXConsoleCommand</b></td><td>คอนโซล</td><td /><td>เปิดหน้าจอของนักพัฒนา</td><td><code>/คอนโซล</code></td></tr><tr><td><b>RBXEmoteCommand</b></td><td>ท่าทาง</td><td>เ</td><td>ท่าทาง</td><td><code>/e เต้นรํา</code></td></tr><tr><td><b>RBXHelpCommand</b></td><td>ช่วยเหลือ</td><td>?</td><td>แสดงรายการของคําสั่งแชท</td><td><code>/ช่วยเหลือ</code></td></tr><tr><td><b>RBXMuteCommand ในการแก้ไขปัญหาเสียงรบกวน</b></td><td>ปิดเสียง</td><td>ม.</td><td>ปิดใช้งานผู้ใช้โดย Class.Player.Name|Name หรือ Class.Player.DisplayName|DisplayName ในทุก Class.TextChannel|TextChannels</td><td><code>/m ชื่อผู้ใช้</code></td></tr><tr><td><b>RBXTeamCommand</b></td><td>ทีม</td><td>ท</td><td>เข้าสู่โหมดแชททีมที่คำส่งเฉพาะสามารถมองเห็นได้โดยเพื่อนร่วมทีมเท่านั้น</td><td><code>/t</code></td></tr><tr><td><b>RBXUnmuteCommand</b></td><td>ปิดเสียง</td><td>อืม</td><td>ปลดเสียงผู้ใช้โดย Class.Player.Name|Name หรือ Class.Player.DisplayName|DisplayName ในทุก Class.TextChannel|TextChannels</td><td><code>/um ชื่อผู้ใช้</code></td></tr><tr><td><b>RBXVersionCommand</b></td><td>เวอร์ชัน</td><td>v</td><td>แสดงเวอร์ชันของการแชท</td><td><code>/เวอร์ชัน</code></td></tr><tr><td><b>RBXWhisperCommand</b></td><td>แชทส่วนตัว</td><td>ว</td><td>เข้าสู่โหมดเงียบกับ <code>Class.Player</code> อื่น</td><td><code>/w DisplayName</code> หรือ <code>/w @Username</code></td></tr></tbody>
ชื่อ | เอเลี่ยนหลัก | อัลเฟียร์รี่ | คำอธิบาย | ตัวอย่างการใช้งาน |
---|
หมุดหมายว่าคุณสามารถแก้ไข สร้าง และลบ TextChatCommands แม้ว่า CreateDefaultCommands จะเป็นจริง โปรดทราบว่าคำสั่งเหล่านี้ใช้ได้กับทุก Class.TextChannel|TextChannels
CreateDefaultTextChannels
กำหนดว
<tbody><tr><td><b>RBXGeneral ได้</b></td><td><code>Class.TextChannel</code> สำหรับข้อควาสำหรับข้อควาผู้เล่น ในหนตาหนหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหนตาหน</td></tr><tr><td><b>RBXSystem</b></td><td><code>Class.TextChannel</code> สำหรับข้อความระบบ ในหน้าต่างชาท ข้อความจะถูกปรับแต่งให้เป็นสีเบจโดยค่าเริ่มต้น หรือสีแดงถ้า <code>Class.TextChatMessage.Text</code> มีคำว่า <code>Error</code> ในหน้าวิกิสนี</td></tr><tr><td><b>RBXTeam\[BrickColor]</b></td><td><code>Class.TextChannel</code> สำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความสำหรับข้อความส</td></tr><tr><td><b>RBXWhisper:\[ฉุกเฉิน1]\_\[ฉุกเฉิน2]</b></td><td><code>Class.TextChannel</code> สำหรับข้อความระหว่างระหว่างระหว่างระหว่างระหว่างระหว่างระหว่างระหว่างระหว่างระหว่างระหว่</td></tr></tbody>
ช่อง | คำอธิบาย |
---|
หมายเหตุว่าค่าเริ่มต้น TextChannel.OnIncomingMessage สามารถเขียนข้อมูลกลับได้ หมายเหตุเพิ่มเติมคือคุณสามารถแก้ไข สร้าง และลบ TextChannels ได้แม้ว่า
ข้อความจากแท็งก์ข้อความที่แตกต่างกันสามารถแยกออกเป็นแท็งก์ต่างๆในหน้าต่างของการแชทโดยใช้ ChannelTabsConfiguration
วิธีการ
DisplayBubble
แสดงฟองบับในแชทบนด้านบนของชิ้นส่วนหรือตัวละครที่ให้ไว้ และยิงเหตุการณ์ BubbleDisplayed ด้วยพารามิเตอร์ที่ระบุในวิธีนี้ สามารถแสดงฟองบับสำหรับตัวล
หมายเหตุว่าวิธีนี้ใช้ได้เฉพาะใน LocalScript หรือใน Script ที่มี RunContext ของ 2>Ennum.RunContext.Client2>
พารามิเตอร์
ส่วนหรือตัวละครที่ฟองอากาศจะปรากฏด้านบน
ข้อความที่จะปรากฏในฟองบับชาต
ส่งค่ากลับ
CanUsersDirectChatAsync
กำหนดว่าผู้ใช้มีอนุญาตให้แชทกับผู้ใช้อื่นในประสบการณ์ตามการตั้งค่าการควบคุมของพ่อแม่ของพวกเขา เพื่อใช้เมื่อ:
- เส้นสื่อสารเป็นของผู้ใช้ (ไม่ใช่ของผู้พัฒนาหรือเกมส์พลาย)
- การเข้าถึงการสื่อสารถูกปิดและจำกัด
พารามิเตอร์
ส่งค่ากลับ
ตัวอย่างโค้ด
local TextChatService = game:GetService("TextChatService")
local directChatParticipants = TextChatService:CanUsersDirectChatAsync(userId1, { userId2 })
-- Check for eligible participants
if #directChatParticipants > 0 then
local directChannel = Instance.new("TextChannel")
directChannel.Parent = TextChatService
for _, participant in directChatParticipants do
directChannel:AddUserAsync(participant)
end
return directChannel
end
warn("Could not create TextChannel. Not enough eligible users.")
return nil
อีเวนต์
MessageReceived
เช่น TextChannel.MessageReceived เกิดขึ้นเมื่อ TextChannel:DisplaySystemMessage() ถูกเรียกในตัวเครื่องหมายของลูกค้า หรือเมื่อลูกค้าได้รับการตอบกลับที่ถูกต้องจากเซิร์ฟเวอร์ เหตุการ
หากค่า TextChannel.ShouldDeliverCallback ของเซิร์ฟเวอร์ถูกผูกและกลับมาที่ false คลิอุตจะไม่ไฟ TextChatService.MessageReceived
ใช้ตัวแปร TextChatMessage เพื่อรับ TextSource และข้อความของข้อความ (ด้วย TextChatMessage.Text )
ตัวแปร TextChatMessage คือผลสรุปที่สุดของฟังก์ชันใด ๆ ที่ผูกกับ TextChatService.OnIncomingMessage หรือ TextChannel.OnIncomingMessage
พารามิเตอร์
ได้รับ TextChatMessage .
SendingMessage
เปิดให้ใช้เมื่อ TextChannel:SendAsync() ถูกเรียกโดยลูกค้าส่ง ใช้สิ่งนี้เพื่อให้ข้อความเทมเพลตแสดงให้กับผู้ใช้ในขณะที่รอการตอบกลับจากเซิร์ฟเวอร์ TextChannel:SendAsync()
พารามิเตอร์
Class.TextChatMessage จาก TextChannel:SendAsync() โทร