Modul obrolan sisi klien

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Anda dapat menggunakan modul obrolan berikut untuk mendukung perilaku sisi klien dari sistem obrolan Legacy.

Jendela Obrolan

Jendela Obrolan adalah modul obrolan utama sisi klien Sistem Obrolan Legacy .

Metode

Tambahkan Channel

Hapus saluran

  • Parameter: string : channelName
  • Deskripsi: Menghapus ChatChannelUI dengan channelName yang diberikan dari jendela.
  • Kembali: kosong

Dapatkan Channel

Dapatkan Channel Saat Ini

Beralih Saluran Saat Ini

  • Parameter: string : channelName
  • Deskripsi: Berganti saluran saat ini ke ChatChannelUI dengan yang diberikan channelName jika ada.
  • Kembali: kosong

Dapatkan Visible

  • Parameter:: Tidak ada
  • Deskripsi: Memberikan apakah jendela terlihat atau tidak.Catatan: ini merujuk pada UI obrolan secara umum; ketika jendela obrolan memudar menjadi transparan karena tidak aktif, jendela masih dianggap terlihat.
  • Kembalinya: bool

Atur Terlihat

  • Parameter: bool : visible
  • Deskripsi: Tetapkan visibilitas jendela obrolan.
  • Kembali: kosong

Latar Belakang Pudar

  • Parameter: mengapung : duration
  • Deskripsi: Hilangkan latar belakang selama yang diberikan duration dalam detik.Catatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

Memudar di Latar Belakang

  • Parameter: mengapung : duration
  • Deskripsi: Hilang di latar belakang selama duration beberapa detik yang diberikan.Catatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

Teks Pudar

  • Parameter: mengapung : duration
  • Deskripsi: Hilangkan teks di atas yang diberikan duration dalam beberapa detikCatatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

FadeInText

  • Parameter: mengapung : duration
  • Deskripsi: Hilang dalam teks selama yang diberikan duration dalam detik.Catatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

ObrolanBar

The ChatBar menangani entri teks sisi klien untuk sistem obrolan Lua. Ada dua komponen kunci dari ChatBar:

  • ChatBar , a TextBox , di mana pemain memasukkan pesan dan perintah (diberi sorotan oranye)
  • Mode Pesan , a TextLabel , yang dapat menampilkan informasi tentang pesan yang dikirim (ditonjolkan dalam hijau)

Metode

DapatkanTextBox

  • Parameter:: Tidak ada
  • Deskripsi: Memberikan kembali TextBox dari bilah obrolan.
  • Kembali: TextBox

DapatkanLabel Mode Pesan GetMessage

  • Parameter:: Tidak ada
  • Deskripsi: Memberikan Kode Pesan TextLabel .
  • Kembali: TextLabel

Difokuskan

  • Parameter:: Tidak ada
  • Deskripsi: Membalas apakah bilah obrolan TextBox berada dalam fokus (pemain mengetik di kotak).Setara dengan memanggil TextBox:IsFocused pada hasil GetTextBox.
  • Kembalinya: bool

Fokus Tangkapan

  • Parameter:: Tidak ada
  • Deskripsi: Memaksa klien untuk fokus pada TextBox dari bilah obrolan. Sama dengan memanggil TextBox:CaptureFocus pada hasil GetTextBox.
  • Kembali: kosong

Fokus Luncuran

  • Parameter: bool : submitted = false
  • Deskripsi: Lepaskan fokus bar obrolan TextBox .Jika submitted benar, ini akan berperilaku seolah-olah pemain menekan Enter untuk mengirimkan pesan.
  • Kembali: kosong

Setel Ulang Teks

  • Parameter:: Tidak ada
  • Deskripsi: Tetapkan Text dari bilah obrolan TextBox ke string kosong.
  • Kembali: kosong

Tetapkan Teks Kotak Teks

  • Parameter: string : text
  • Deskripsi: Tetapkan dari bilah obrolan ke yang diberikan.
  • Kembali: kosong

Dapatkan TextBoxText

  • Parameter:: Tidak ada
  • Deskripsi: Memberikan teks di bilah obrolan TextBox.Text .
  • Kembali: string

Tetapkan Label Teks SetText

  • Parameter: string : text
  • Deskripsi: Tetapkan dari Mode Pesan ke yang diberikan.
  • Kembali: kosong

Dapatkan Diaktifkan

  • Parameter:: Tidak ada
  • Deskripsi: Memberikan apakah bilah obrolan adalah Visible .
  • Kembalinya: bool

Setel Aktif

  • Parameter: bool : enabled
  • Deskripsi: Tetapkan apakah bilah obrolan adalah Visible .
  • Kembali: kosong

Tetapkan Kapasitas Teks

  • Parameter: int : textSize
  • Deskripsi: Tetapkan TextSize dari kedua bilah obrolan TextBox dan Mode Pesan TextLabel.
  • Kembali: kosong

Ukuran Reset

  • Parameter:: Tidak ada
  • Deskripsi: Reset ukuran bilah obrolan ke satu baris teks.
  • Kembali: kosong

Tetapkan Target Saluran

  • Parameter: string : channelName
  • Deskripsi: Tetapkan target ChatChannelUI yang diberikan kepadanya channelName untuk mengirim pesan obrolan.
  • Kembali: kosong

Latar Belakang Pudar

  • Parameter: mengapung : duration``duration
  • Deskripsi: Hilangkan latar belakang selama yang diberikan duration dalam detik.Catatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

Memudar di Latar Belakang

  • Parameter: mengapung : duration``duration
  • Deskripsi: Hilang di latar belakang selama duration beberapa detik yang diberikan.Catatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

Teks Pudar

  • Parameter: mengapung : duration``duration
  • Deskripsi: Hilangkan teks di atas yang diberikan duration dalam beberapa detikCatatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

FadeInText

  • Parameter: mengapung : duration``duration
  • Deskripsi: Hilang dalam teks selama yang diberikan duration dalam detik.Catatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

ChatChannelUI

The ChatChannelUI adalah versi sisi klien dari ChatChannel.Ini menerima Pesan Obrolan dari server dan mengirimkannya ke Log Obrolan Chat.terkait dengannya.

Metode

Tambahkan Pesan ke Saluran

Hapus Pesan Terakhir dari Channel

Log Pesan Bersih

Log Pesan Obrolan Tampilan

The ChatMessageLogDisplay mengelola penyajian ChatMessage di sebuah ChatChannelUI.

Metode

Tambahkan Pesan

  • Parameternya: Pesan Obrolanmessage
  • Deskripsi: Menambahkan message ke tampilan log pesan.
  • Kembali: kosong

Hapus Pesan Terakhir

  • Parameter:: Tidak ada
  • Deskripsi: Menghapus Pesan Obrolan tertua di log pesan tampilan.
  • Kembali: kosong

ReorderSemua Pesan

  • Parameter:: Tidak ada
  • Deskripsi: Mengurut ulang semua tampilan pesan dalam urutan menaik, relatif terhadap ukuran tampilan pesan.Ini harus dipanggil jika log pesan ditampilkan ulang ukurannya.
  • Kembali: kosong

Jelas

  • Parameter:: Tidak ada
  • Deskripsi: Menghapus semua Pesan Obrolan dari tampilan log pesan.
  • Kembali: kosong

Teks Pudar

  • Parameter: mengapungduration
  • Deskripsi: Hilangkan teks di atas yang diberikan duration dalam beberapa detikCatatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

FadeInText

  • Parameter: mengapungduration
  • Deskripsi: Hilang dalam teks selama yang diberikan duration dalam detik.Catatan: Panggilan kemudian untuk mengontrol pudar masuk/keluar akan menggantikan panggilan sebelumnya.
  • Kembali: kosong

Status Obrolan Kustom

The ChatCustomState adalah antarmuka dari panggilan balasan yang digunakan saat membuat status obrolan khusus di bilah obrolan.

Obrolan berbisik dan obrolan tim menggunakan ChatCustomState untuk menunjukkan kepada pemain di mana pesan mereka akan dikirim.

Panggilan Balik

Teks Diperbarui

  • Parameter:: Tidak ada
  • Deskripsi: Dipanggil ketika teks di bilah obrolan diperbarui.
  • Kembali: kosong

Dapatkan Pesan

  • Parameter:: Tidak ada
  • Deskripsi: Dipanggil untuk mengambil teks pesan seperti yang akan ditulis sebagai satu perintah.Ini digunakan dalam kasus server perlu memproses perintah sebagai teks, bukan keadaan visual dari perintah.
  • Kembali: string

Pesan Proses Selesai

  • Parameter:: Tidak ada
  • Deskripsi: Dipanggil saat pemain mengirimkan pesan yang sedang diproses oleh negara khusus.Ini harus kembali benar jika pesan tidak boleh ditampilkan atau dikirim ke server.
  • Kembalinya: bool

Hancurkan

  • Parameter:: Tidak ada
  • Deskripsi: Dipanggil sebagai ChatBar diatur ulang kembali ke keadaan aslinya sebelum modifikasi negara khusus.
  • Kembali: kosong

Pengaturan Obrolan

The Pengaturan Obrolan adalah kamus pengaturan untuk sisi klien dari sistem obrolan Lua.Mereka disimpan dalam ModuleScript bernama ChatSettings , yang dapat ditemukan di dalam layanan game Chat , di bawah Folder bernama ClientChatModules .Modul mungkin diperlukan dan propertinya dapat diubah selama masa eksekusi.

Untuk mengubah pengaturan, persyaratkan modul ini menggunakan LocalScript dalam cara berikut:

-- Memerlukan modul ChatSettings (tunggu sampai load)

local Chat = game:GetService("Chat")

local ClientChatModules = Chat:WaitForChild("ClientChatModules")

local ChatSettings = require(ClientChatModules:WaitForChild("ChatSettings"))

-- Ubah pengaturan seperti yang akan Anda lakukan dengan tabel lain.

ChatSettings.MaximumMessageLength = 100

Pengaturan perilaku obrolan

JendelaDraggable

  • Jenis: bool
  • Standar: false
  • Deskripsi: Menentukan apakah ChatWindow adalah Draggable .

Jendela Dapat diubah Ulang

  • Jenis: bool
  • Standar: false
  • Deskripsi: Menentukan apakah ChatWindow dapat diubah ukurannya oleh pemain
  • Jenis: bool
  • Standar: false
  • Deskripsi: Menentukan apakah gamepad dapat menavigasi UI obrolan.

Tampilkan Pesan Pengguna Terfilter

  • Jenis: bool
  • Standar: true
  • Deskripsi: Menentukan apakah pemain harus melihat versi filter dari pesan obrolan mereka, atau konten asli yang mereka ketik.

Obrolan dengan Topbar Mati

  • Jenis: bool
  • Standar: false
  • Deskripsi: Menentukan apakah UI obrolan diaktifkan bahkan jika bilah atas dinonaktifkan.

BubbleChatEnabled

  • Jenis: bool
  • Standar: game:GetService("Players").BubbleChat
  • Deskripsi: Menentukan apakah obrolan gelembung diaktifkan.

Chat Klasik Aktif

  • Jenis: bool
  • Standar: game:GetService("Players").ClassicChat
  • Deskripsi: Menentukan apakah obrolan klasik diaktifkan.

Pengaturan ukuran teks obrolan

Ukuran ChatWindowText

  • Jenis: int
  • Standar: 18
  • Deskripsi: Menentukan ukuran teks di ChatWindow.

Ukuran Teks ChatBar

  • Jenis: int
  • Standar: 18
  • Deskripsi: Menentukan ukuran teks di ChatBar.

Telepon Ukuran Teks Obrolan

  • Jenis: int
  • Standar: 14
  • Deskripsi: Menentukan ukuran teks di ChatWindow untuk ponsel.

Telepon Ukuran Teks Obrolan

  • Jenis: int
  • Standar: 14
  • Deskripsi: Menentukan ukuran teks di ChatBar untuk ponsel.

Pengaturan font

Font Standar

ChatBarFont

Pengaturan warna

Warna Latar Belakang

  • Jenis: Color3
  • Standar: Color3.new(0, 0, 0)
  • Deskripsi: Menentukan BackgroundColor3 dari ChatWindow.

Warna Pesan Default

Nama DefaultNameColor

Warna Latar Belakang ChatBarBackGround

  • Jenis: Color3
  • Standar: Color3.new(0, 0, 0)
  • Deskripsi: Menentukan BackgroundColor3 dari ChatBar.

Warna Kotak Obrolan

  • Jenis: Color3
  • Standar: Color3.new(1, 1, 1)
  • Deskripsi: Menentukan BackgroundColor3 dari ChatBarTextBox .

ChatBarTextColor

  • Jenis: Color3
  • Standar: Color3.new(0, 0, 0)
  • Deskripsi: Menentukan TextColor3 dari ChatBar.

Kode Kesalahan Pesan Teks

  • Jenis: Color3
  • Standar: Color3.fromRGB(245, 50, 50)
  • Deskripsi: Menentukan TextColor3 pesan kesalahan.

Pengaturan jendela

Ukuran Jendela Minimum

  • Jenis: UDim2
  • Standar: UDim2.new(0.3, 0, 0.25, 0)
  • Deskripsi: Menentukan ukuran terkecil yang mungkin dari ChatWindow (karena WindowResizable diaktifkan).

Ukuran Jendela Maksimum

  • Jenis: UDim2
  • Standar: UDim2.new(1, 0, 1, 0)
  • Deskripsi: Menentukan ukuran terbesar yang mungkin dari ChatWindow (karena WindowResizable diaktifkan).
  • Catatan: Jika ini diubah menjadi lebih besar dari ukuran layar penuh, hal-hal aneh mulai terjadi dengan pemeriksaan batas ukuran/posisi.

Posisi Jendela Default

  • Jenis: UDim2
  • Standar: UDim2.new(0, 0, 0, 0)
  • Deskripsi: Menentukan posisi default dari ChatWindow.

Ukuran Jendela DefaultPhone

  • Jenis: UDim2
  • Standar: UDim2.new(0.5, 0, 0.5, (7 * 2) + (5 * 2))
  • Deskripsi: Menentukan ukuran default dari ChatWindow di ponsel.

Tablet Ukuran Jendela Default

  • Jenis: UDim2
  • Standar: UDim2.new(0.4, 0, 0.3, (7 * 2) + (5 * 2))
  • Deskripsi: Menentukan ukuran default dari ChatWindow di tabel.

Desktop Ukuran Jendela Default

  • Jenis: UDim2
  • Standar: UDim2.new(0.3, 0, 0.25, (7 * 2) + (5 * 2))
  • Deskripsi: Menentukan ukuran default dari ChatWindow di desktop.

Hilang dan dalam pengaturan

ChatWindowBackgroundFadeOutWaktunya

  • Jenis: mengapung (detik)
  • Standar: 0.5
  • Deskripsi: Menentukan berapa lama latar belakang ChatWindow memudar harus diambil.

Waktu Terhapusnya Teks Jendela Obrolan

  • Jenis: mengapung (detik)
  • Standar: 30
  • Deskripsi: Menentukan berapa lama waktu pudar keluar dari teks ChatWindow.

Durasi Fade Obrolan Default

  • Jenis: mengapung (detik)
  • Standar: 0.8
  • Deskripsi: Menentukan berapa lama elemen UI obrolan memudar harus diambil.

ChatShouldFadeInDariInformasi Baru

  • Jenis: bool
  • Standar: false
  • Deskripsi: Menentukan apakah obrolan harus memudar saat menerima pesan baru.

Animasi Obrolan FPS

  • Jenis: mengapung
  • Standar: 20.0
  • Deskripsi: Menentukan kecepatan bingkai animasi pudar di UI obrolan.

Pengaturan saluran

Nama Saluran Umum

  • Jenis: string
  • Standar: "All"
  • Deskripsi: Menentukan nama channeldefault.

Pesan Echo di Saluran Umum

  • Jenis: bool
  • Standar: true
  • Deskripsi: Menentukan apakah pesan ke saluran lain dari saluran default harus disalin ke channeldefault.

Nama Saluran Maksimum Panjang

  • Jenis: int
  • Standar: 12
  • Deskripsi: Menentukan panjang maksimum dari nama saluran sebelum dipotong.

Panjang Histori Pesan Per Channel

  • Jenis: int
  • Standar: 50
  • Deskripsi: Menentukan jumlah maksimum Pesan Obrolan yang dapat ditampilkan di channelobrolan.

Tampilkan Join dan Leave HelpText

  • Jenis: bool
  • Standar: false
  • Deskripsi: Menentukan apakah teks bantuan untuk bergabung/meninggalkan saluran ditampilkan.

Pengaturan pesan

Panjang Pesan Maksimum

  • Jenis: int
  • Standar: 200
  • Deskripsi: Menentukan panjang maksimum dari ChatMessage .

Tidak Diizinkan WhiteSpace

  • Jenis: array< string >
  • Standar: {"\n", "\r", "\t", "\v", "\f"}
  • Deskripsi: Menentukan karakter spasi putih yang tidak diizinkan.

KlikNama Pemain ke Whisper

  • Jenis: bool
  • Standar: true
  • Deskripsi: Menentukan apakah pemain dapat mengklik nama pemain lain untuk terlibat dalam obrolan berbisik dengan mereka.

Klik di Nama Saluran untuk Menetapkan Saluran Utama

  • Jenis: bool
  • Standar: true
  • Deskripsi: Menentukan apakah pemain dapat mengklik tab channeluntuk menetapkannya sebagai channelutama mereka.

Pengaturan lain-lain

Nama Pemutar Otomatis Komando WhisperWhisperCommandAutoCompletePlayerNames

  • Jenis: bool
  • Standar: true
  • Deskripsi: Menentukan apakah perintah berbisik harus menyelesaikan nama pemain secara otomatis.

Peristiwa

Pengaturan Berubah

  • Parameter: Library.string``settingName , Variasi newValue
  • Deskripsi: Memicu ketika pengaturan dengan settingName diubah menjadi newValue.

Di halaman ini