Sesuaikan jendela obrolan

Sistem obrolan teks dalam pengalaman yang didukung oleh TextChatService, memungkinkan pemain untuk dengan mudah berkomunikasi dan berinteraksi satu sama lain dalam pengalaman langsungSelain mendukung obrolan teks default, Anda dapat kustomisasi antarmuka pengguna depan.

Konfigurasi jendela obrolan

Jendela obrolan keseluruhan terdiri dari:

• Jendela obrolan
• Bar masuk
• Tab saluran (opsional)

Tab saluran dinonaktifkan secara default dan setiap komponen dapat diaktifkan dan dimatikan di Studio atau melalui scripting:

Di jendela Explorer, perluas cabang TextChatService dan pilih ChatWindowConfiguration , ChatInputBarConfiguration , atau ChannelTabsConfiguration .Kemudian aktifkan atau nonaktifkan komponen di jendela Properti.

Ketika ChannelTabsConfiguration diaktifkan, masing-masing default TextChannel muncul di tab seperti yang dijelaskan dalam tabel berikut.Selain itu, setiap kustom TextChannel membuat tab yang sesuai dengan properti channelName.

Tampilan penampilan

Penampilan jendela obrolan keseluruhan dapat disesuaikan melalui ChatWindowConfiguration .

Tampilan bilah penampilan

Tampilan bilah input obrolan dapat disesuaikan melalui ChatInputBarConfiguration.

Tampilan tab penampilan

Penampilan tab saluran adalah dapat disesuaikan melalui .

Sesuaikan pesan

Anda dapat menyesuaikan penampilan tubuh pesan obrolan dan pr prefik menggunakan ChatWindowMessageProperties dan TextChatService.OnChatWindowAdded panggilan balik tanpa menggantikan UI yang ada.Opsi kustomisasi memungkinkan Anda untuk memodifikasi tampilan pesan obrolan untuk sesuai dengan tema pengalaman Anda, dan Anda juga dapat mengurutkan atau menyoroti pesan dari berbagai kelompok pengguna dengan memberikan prefiks warna atau menambahkan tag obrolan.

Nama pengguna warna

Ketika pengguna mengirim pesan obrolan, bagian prefiks dari pesan ditampilkan sebagai DisplayName .Secara default, nama setiap pengguna diwarnai sesuai dengan Player.TeamColor tetapi Anda dapat mengubah warna nama obrolan menggunakan ChatWindowMessageProperties dan OnChatWindowAdded .Berikut adalah LocalScript di StarterPlayerScripts menugaskan warna yang telah ditentukan kepada setiap pengguna, memilih secara acak dari tabel warna RGB.

Skrip Lokal - Nama Pengguna Acak
local TextChatService = game:GetService("TextChatService")

local chatWindowConfiguration = TextChatService.ChatWindowConfiguration

local nameColors = {
	Color3.fromRGB(255, 0, 0),
	Color3.fromRGB(0, 255, 0),
	Color3.fromRGB(0, 0, 255),
	Color3.fromRGB(255, 255, 0),
}

TextChatService.OnChatWindowAdded = function(message: TextChatMessage)
	local properties = chatWindowConfiguration:DeriveNewMessageProperties()

	local textSource = message.TextSource
	if textSource then
		local index: number = (textSource.UserId % #nameColors) + 1
		local randomColor: Color3 = nameColors[index]

    	properties.PrefixTextProperties = chatWindowConfiguration:DeriveNewMessageProperties()
		properties.PrefixTextProperties.TextColor3 = randomColor
	end

	return properties
end

Anda juga dapat menerapkan gradien warna dan transparansi ke prefiks pesan warna menggunakan UIGradient .

Warna Nama Pengguna Gradien
local TextChatService = game:GetService("TextChatService")

local chatWindowConfiguration = TextChatService.ChatWindowConfiguration

local gradient = Instance.new("UIGradient")
gradient.Color = ColorSequence.new{
	ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 0, 0)),
	ColorSequenceKeypoint.new(0.5, Color3.fromRGB(255, 255, 0)),
	ColorSequenceKeypoint.new(1, Color3.fromRGB(255, 0, 255))
}

TextChatService.OnChatWindowAdded = function(message: TextChatMessage)
	local properties = chatWindowConfiguration:DeriveNewMessageProperties()

	local textSource = message.TextSource
	if textSource then
    	properties.PrefixTextProperties = chatWindowConfiguration:DeriveNewMessageProperties()
		gradient:Clone().Parent = properties.PrefixTextProperties
	end

	return properties
end

Kustomisasi teks kaya

Tag warna teks kaya font dapat digunakan untuk memformat pesan obrolan, berguna jika Anda ingin menerapkan formatasi ke bagian pesan yang sangat spesifik.Perhatikan bahwa teks kaya tidak mendukung gradien, tetapi contoh kode berikut menunjukkan bagaimana Anda dapat memindahkan nama pengguna (disimpan di TextChatMessage.PrefixText ) ke dalam tubuh pesan dan kemudian menerapkan label teks kaya hanya pada bagian nama.

Kustomisasi Teks Kaya
local TextChatService = game:GetService("TextChatService")
local Players = game:GetService("Players")

local chatWindowConfiguration = TextChatService.ChatWindowConfiguration

local gradient = Instance.new("UIGradient")
gradient.Color = ColorSequence.new{
	ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 0, 0)),
	ColorSequenceKeypoint.new(0.5, Color3.fromRGB(255, 255, 0)),
	ColorSequenceKeypoint.new(1, Color3.fromRGB(255, 0, 255))
}

TextChatService.OnChatWindowAdded = function(message: TextChatMessage)
	local properties = chatWindowConfiguration:DeriveNewMessageProperties()

	if message.TextSource then
		properties.PrefixText = "[VIP]"
		properties.Text = string.format("<font color='#00ffff'>%s</font>", message.PrefixText) .. " " .. message.Text

		properties.PrefixTextProperties = chatWindowConfiguration:DeriveNewMessageProperties()
		gradient:Clone().Parent = properties.PrefixTextProperties
	end

	return properties
end

Kirim pesan dari sumber non-pemain

Terkadang, Anda mungkin ingin menampilkan dialog non-pemain di jendela obrolan, seperti "pidato" dari sistem alamat publik atau karakter non-pemain.

Sistem

Untuk mengirimkan pesan sistem ke pemain lokal, panggil DisplaySystemMessage() dari saluran default RBXGeneral dengan prefiks sebelum nama displaypemain.

Skrip Klien
local Players = game:GetService("Players")
local TextChatService = game:GetService("TextChatService")

local player = Players.LocalPlayer
local generalChannel: TextChannel = TextChatService:WaitForChild("TextChannels").RBXGeneral

local PREFIX = "[Guide] Welcome "

-- Kirim "pesan sistem" ke pemain dengan nama tampilan ditambahkan
generalChannel:DisplaySystemMessage(PREFIX .. player.DisplayName)

Untuk panduan yang lebih terperinci tentang cara menyesuaikan tampilan pesan sistem, lihat Menyesuaikan pesan sistem.

Pesan sistem default

Ketika TextChatService.CreateDefaultTextChannels adalah true, salah satu saluran teks default adalah saluran RBXSystem.Skrip obrolan default secara otomatis menampilkan pesan sistem di channelini.Anda dapat menyesuaikan tampilan pesan ini menggunakan panggilan balik TextChannel.OnIncomingMessage.

Anda mungkin ingin menyesuaikan atau mengubah pesan sistem yang dikeluarkan secara otomatis oleh sistem obrolan.Karena pesan sistem default diterjemahkan untuk pengguna, Anda harus merujuknya dengan TextChatMessage.Metadata dalam panggilan obrolan teks jika Anda ingin menyesuaikan penampilan mereka.

Di bawah ini adalah referensi pesan sistem default yang dipancarkan oleh sistem obrolan:

NPC/objek

Anda juga dapat menyulitkan dialog non-pemain dan menambahkan gelembung obrolan untuk membuatnya tampak seperti pesan berasal dari NPC atau objek di dunia 3D.

Skrip Klien
local TextChatService = game:GetService("TextChatService")
local Workspace = game:GetService("Workspace")

local generalChannel: TextChannel = TextChatService:WaitForChild("TextChannels").RBXGeneral

TextChatService.OnIncomingMessage = function(textChatMessage: TextChatMessage)
	local properties = Instance.new("TextChatMessageProperties")

	-- Periksa pesan sistem yang berisi metadata
	if not textChatMessage.TextSource and textChatMessage.Metadata ~= "" then

		-- Tambahkan pr prefik untuk membuat pesan terlihat seperti dikirim oleh pemain
		properties.PrefixText = string.format("<font color='#%s'>%s: </font>", "#50C999", textChatMessage.Metadata)

		-- Tambahkan obrolan gelembung
		TextChatService:DisplayBubble(Workspace.Statue, textChatMessage.Text)
	end

	return properties
end

local message = "Welcome! I will be your guide."
local speakerName = "Ancient Knight"
generalChannel:DisplaySystemMessage(message, speakerName)