TextChannel
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Mengambil channelchat teks. Berisi TextSources sebagai nenek moyang.
Untuk mengirim pesan chat ke TextChannel , panggil TextChannel:SendAsync() dari LocalScript . Sumber 1> Class.TextSource1> pengguna dengan 4> TextSource.CanSend = true4> harus ada di channelitu.
Pesan dari berbagai TextChannels dapat dibagi menjadi berbagai tab di jendela chat menggunakan ChannelTabsConfiguration .
Untuk belajar lebih lanjut, lihat Chat Teks dalam Pengalaman.
Rangkuman
Properti
Metode
Menampilkan pesan sistem kepada pengguna.
Menambahkan TextSource ke TextChannel yang diberikan ID pengguna dari Player .
Mengirim TextChatMessage ke server.
Acara
Diaktifkan ketika TextChannel:DisplaySystemMessage() dinyatakan di klien, atau ketika klien menerima jawaban TextChannel:SendAsync() yang valid dari server.
Callback
Panggil dengan ketika TextChannel menerima pesan yang masuk.
Dipanggil untuk setiap klien ketika TextChannel menerima pesan yang masuk untuk menentukan apakah atau tidak harus dikirim ke klien itu.
Properti
DirectChatRequester
Metode
DisplaySystemMessage
Menampilkan pesan sistem kepada pengguna. Hanya dapat digunakan dalam LocalScript , atau dalam Script dengan RunContext dari 2>Class.Script2> . Pesan hanya terlihat oleh pengguna itu dan tidak secara otomatis disaring atau diterjemahkan.
Parameter
Pesan sistem dikirim ke TextChannel .
Gunakan untuk mengidentifikasi jenis pesan sistem, seperti pesan sistem default.
Memberikan nilai
A TextChatMessage dengan TextChatMessage.Status property yang menunjukkan kondisi pesan.
AddUserAsync
Menambahkan TextSource ke TextChannel yang diberikan ID pengguna (dengan Player.UserId). Hanya dapat digunakan dalam 2>Class.Script2> .
Jika TextSource mewakili pengguna tidak ada, ini menambahkan TextSource .
Jika TextSource mewakili pengguna, ini mengembalikan TextSource .
Jika pengguna memiliki obrolan mati atau bukan di server, ini mengembalikan tuple nil , false .
Parameter
Memberikan nilai
Mengembalikan TextSource dan true jika pengguna baru dibuat untuk pengguna, TextSource dan 1> false1> jika ada pengguna lama yang ada di server
SendAsync
Mengirim TextChatMessage ke server. Hanya dapat digunakan dalam LocalScript , atau dalam Script dengan 1> Class.Script.RunContext|RunContext1> dari 4> Enum.RunContext.Client4> .
Parameter
Pesan untuk dikirim ke TextChannel .
Metadaten khusus untuk ditempatkan pada pesan.
Memberikan nilai
A TextChatMessage dengan TextChatMessage.Status property yang menunjukkan kondisi pesan.
Acara
MessageReceived
Seperti TextChatService.MessageReceived, menyala ketika TextChannel:DisplaySystemMessage() dianggap di klien, atau ketika klien menerima jawaban TextChannel:SendAsync() yang valid dari server. Acara ini hanya diaktifkan di klien.
Jika properti server TextChannel.ShouldDeliverCallback terikat dan mengembalikan false, klien tidak akan mengeksekuskan TextChannel.MessageReceived .
Gunakan parameter TextChatMessage untuk mendapatkan TextSource dan teks pesan (dengan TextChatMessage.Text).
Parameter TextChatMessage adalah hasil akhir dari fungsi apa pun yang terikat dengan TextChatService.OnIncomingMessage atau TextChannel.OnIncomingMessage .
Parameter
Class.TextChatMessage diterima.
Callback
OnIncomingMessage
Panggil dengan ketika TextChannel menerima pesan yang masuk. Hanya dapat dilaksanakan di klien.
Gunakan ini untuk menghias TextChatMessages . Jika panggilan ini mengembalikan TextChatMessageProperties , property ini di gabung dengan parameter TextChatMessage untuk menciptakan kumpulan baru 1> Class.TextChatMessage1> .
Ketika terikat pada klien mengirim pesan, panggilan kembali ini dijalankan dua kali; pertama ketika pesan awalnya dikirim dan diterima lokalmente, dan lagi ketika klien menerima hasil pesan yang disaring dari server.
TextChannel.OnIncomingMessage panggilan selalu berjalan setelah setelah panggilan Class.TextChatService.OnIncomingMessage.
Ini harus di definisikan hanya sekali per TextChannel dalam kode sumber. Beberapa binding ke saluran yang sama akan bertentangan satu sama lain dalam cara non-deterministik.
Ketika TextChatService:CreateDefaultTextChannels() benar, maka TextChannels yang bersifat default memiliki TextChannel.OnIncomingMessage panggilan kembali yang ditetapkan secara internal untuk mengekspresikan perilaku default khusus.
Parameter
Class.TextChatMessage yang masuk.
Memberikan nilai
Jika TextChatMessageProperties dikembalikan, kode-kode ini di gabung dengan parameter TextChatMessage untuk membuat TextChatMessage baru dengan kode-kode ini.
ShouldDeliverCallback
Dipanggil untuk setiap klien ketika TextChannel menerima pesan yang masuk untuk menentukan apakah atau tidak harus dikirim ke klien itu. Hanya dapat didefinisikan di server.
Setelah di definisikan, panggilan kembali ini harus mengembalikan nilai yang benar seperti true , 1 , atau "hello" untuk mengirimkan pesan ke klien yang ditentukan. Jika panggilan kembali mengembalikan nilai lain (termasuk 1> nil1>), pesan tidak akan dikirim ke kli
Pengirim dapat diacak oleh TextChatMessage.TextSource .