TextChatService

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

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

ไม่สามารถสร้าง
บริการ

บริการที่จัดการในการแชทข้อความในประสบการณ์ รวมถึงการจัดการช่อง การตกแต่งข้อความ การกรองข้อความ การสร้างคำสั่ง และการพัฒนาระเบียงการแชท

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

สรุป

คุณสมบัติ

  • ChatTranslationEnabled:bool
    ไม่ซ้ำ
    การรักษาความปลอดภัยของสคริปต์ Roblox
    อ่านพร้อมๆ กัน
  • ChatVersion:Enum.ChatVersion
    การรักษาความปลอดภัยที่เข้าถึงไม่ได้
    อ่านพร้อมๆ กัน

    กำหนดว่าจะเปิดใช้งาน TextChatService หรือไม่ก็จะย้อนกลับไปใช้ระบบการแชทในอดีต

  • CreateDefaultCommands:bool
    การรักษาความปลอดภัยของปลั๊กอิน
    อ่านพร้อมๆ กัน

    กำหนดว่า TextChatService ควรสร้างค่าเริ่มต้น TextChatCommands หรือไม่

  • CreateDefaultTextChannels:bool
    การรักษาความปลอดภัยของปลั๊กอิน
    อ่านพร้อมๆ กัน

    กำหนดว่า TextChatService ควรสร้างค่าเริ่มต้น TextChannels

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

  • DisplayBubble(partOrCharacter : Instance,message : string):void

    แสดงฟองบับการแชทเหนือส่วนหนึ่งหรือตัวละครผู้เล่นที่ให้

  • CanUserChatAsync(userId : number):bool
    ผลตอบแทน
  • CanUsersChatAsync(userIdFrom : number,userIdTo : number):bool
    ผลตอบแทน
  • CanUsersDirectChatAsync(requesterUserId : number,userIds : Array):Array
    ผลตอบแทน

    กำหนดว่าผู้ใช้มีอนุญาตให้แชทกับผู้ใช้อื่นในประสบการณ์ตามการตั้งค่าการควบคุมของผู้ปกครองของพวกเขา

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

Callbacks

  • OnBubbleAdded(message : TextChatMessage,adornee : Instance):Tuple

    เรียกเมื่อฟองกระทู้กำลังจะปรากฏขึ้น

  • OnChatWindowAdded(message : TextChatMessage):Tuple

    เรียกใช้เมื่อข้อความใหม่กำลังจะปรากฏขึ้นในหน้าต่างชุมชน นี่สามารถดำเนินการได้เฉพาะในตัวเครื่อง

  • OnIncomingMessage(message : TextChatMessage):Tuple

    เรียกเมื่อ TextChatService ได้รับข้อความที่เข้ามา

คุณสมบัติ

ChatTranslationEnabled

bool
ไม่ซ้ำ
การรักษาความปลอดภัยของสคริปต์ Roblox
อ่านพร้อมๆ กัน

ChatVersion

Enum.ChatVersion
การรักษาความปลอดภัยที่เข้าถึงไม่ได้
อ่านพร้อมๆ กัน

กำหนดว่าจะเปิดใช้งาน TextChatService หรือไม่ หรือย้อนกลับไปใช้ระบบการแชทในอดีต การตั้งค่าค่านี้ให้เป็น Enum.ChatVersion.LegacyChatService จะปิดการใช้งาน TextChatService อย่างมีประสิทธ

CreateDefaultCommands

bool
การรักษาความปลอดภัยของปลั๊กอิน
อ่านพร้อมๆ กัน

กำหนดว่า 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

bool
การรักษาความปลอดภัยของปลั๊กอิน
อ่านพร้อมๆ กัน

กำหนดว

<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

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

DisplayBubble

void

แสดงฟองบับในแชทบนด้านบนของชิ้นส่วนหรือตัวละครที่ให้ไว้ และยิงเหตุการณ์ BubbleDisplayed ด้วยพารามิเตอร์ที่ระบุในวิธีนี้ สามารถแสดงฟองบับสำหรับตัวล

หมายเหตุว่าวิธีนี้ใช้ได้เฉพาะใน LocalScript หรือใน Script ที่มี RunContext ของ 2>Ennum.RunContext.Client2>

พารามิเตอร์

partOrCharacter: Instance

ส่วนหรือตัวละครที่ฟองอากาศจะปรากฏด้านบน

message: string

ข้อความที่จะปรากฏในฟองบับชาต


ส่งค่ากลับ

void

CanUserChatAsync

bool
ผลตอบแทน

พารามิเตอร์

userId: number

ส่งค่ากลับ

bool

CanUsersChatAsync

bool
ผลตอบแทน

พารามิเตอร์

userIdFrom: number
userIdTo: number

ส่งค่ากลับ

bool

CanUsersDirectChatAsync

Array
ผลตอบแทน

กำหนดว่าผู้ใช้มีอนุญาตให้แชทกับผู้ใช้อื่นในประสบการณ์ตามการตั้งค่าการควบคุมของพ่อแม่ของพวกเขา เพื่อใช้เมื่อ:

  • เส้นสื่อสารเป็นของผู้ใช้ (ไม่ใช่ของผู้พัฒนาหรือเกมส์พลาย)
  • การเข้าถึงการสื่อสารถูกปิดและจำกัด

พารามิเตอร์

requesterUserId: number
userIds: Array

ส่งค่ากลับ

Array

ตัวอย่างโค้ด

This example checks if two users can chat, creates a new TextChannel, and adds them to it.

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
ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

BubbleDisplayed

เกิดขึ้นเมื่อ TextChatService:DisplayBubble() ถูกเรียก

พารามิเตอร์

partOrCharacter: Instance
textChatMessage: TextChatMessage

MessageReceived

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

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

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

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

พารามิเตอร์

textChatMessage: TextChatMessage

ได้รับ TextChatMessage .


SendingMessage

เปิดให้ใช้เมื่อ TextChannel:SendAsync() ถูกเรียกโดยลูกค้าส่ง ใช้สิ่งนี้เพื่อให้ข้อความเทมเพลตแสดงให้กับผู้ใช้ในขณะที่รอการตอบกลับจากเซิร์ฟเวอร์ TextChannel:SendAsync()

พารามิเตอร์

textChatMessage: TextChatMessage

Class.TextChatMessage จาก TextChannel:SendAsync() โทร


ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

Callbacks

OnBubbleAdded

Tuple

เรียกเมื่อกำลังจะแสดงบับเบิลชาท

ใช้สิ่งนี้เพื่อปรับแต่งข้อความแชทฟองบังเหียวเฉพาะ หากคืนนี้กลับม

หากข้อความในแชทถูกส่งโดยผู้เล่น message.TextSource จะตรงกับผู้เล่นนั้น และ adornee จะเป็น nil

หากข้อความในการแชทถูกส่งผ่าน Class.TextChatService:DisplayBubble``adornee จะเป็น partOrCharacter ที่จัดหาและ 1> message.TextSource1> จะเป็น 4> nil4>

พารามิเตอร์

message: TextChatMessage

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

adornee: Instance

ส่วนหรือตัวละครที่ปรากฏในข้อความแชทฟองอากาศ


ส่งค่ากลับ

Tuple

หาก TextChatMessage ถูกส่งกลับมา, คุณสมบัติเหล่านี้จะถูกประยุกต์ให้กับฟองที่เกี่ยวข้องโดยทับที่คุณสมบัติ BubbleChatConfiguration

OnChatWindowAdded

Tuple

เรียกใช้เมื่อข้อความใหม่กำลังจะปรากฏขึ้นในหน้าต่างชุมชน นี่สามารถดำเนินการได้เฉพาะในตัวเครื่อง

ใช้สิ่งนี้เพื่อปรับแต่งข้อความแต่ละรายการที่ปรากฏในหน้าต่างแชท หากค่าตัวนี

พารามิเตอร์

message: TextChatMessage

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


ส่งค่ากลับ

Tuple

หาก TextChatMessage ถูกส่งกลับมา, คุณสมบัติเหล่านี้จะถูกประยุกต์ให้กับข้อความที่เกี่ยวข้อง, การเปลี่ยนแปลง ChatWindowConfiguration คุณสมบัติ

OnIncomingMessage

Tuple

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

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

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

หมายเหตุว่าคอล백นี้ TextChatService.OnIncomingMessage จะดำเนินการก่อนที่จะมีคอลแบ็ค Class.TextChannel.OnIncomingMessage ใด ๆ

นี้ควรจะได้รับการกำหนดเฉพาะครั้งเดียวในโค้ดที่หลัก การผูกต่อผูกหลายจะทำงานร่วมกันในวิธีที่ไม่เป็นระเบียบาล

พารามิเตอร์

message: TextChatMessage

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


ส่งค่ากลับ

Tuple

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