Passe das Chat-Fenster an

Das Erlebnistext-Chat-System, betrieben von TextChatService, ermöglicht es Spielern, leicht miteinander zu kommunizieren und sich in Echtzeit-Erlebnissen zu sozialisieren.Zusätzlich zur Unterstützung des Standardtextchats kannst du die Benutzeroberfläche des Frontends anpassen.

Konfiguration des Chatfensters

Das Gesamtfenster des Chats besteht aus:

• Chatten-Fenster
• Eingabefeld
• Kanal-Registerkarten (optional)

Die Kanal-Tabs sind standardmäßig deaktiviert und jede Komponente kann in Studio oder durch Scriptingein- und ausgeschaltet werden:

Im Explorer Fenster erweitern Sie die TextChatService Zweig und wählen Sie ChatWindowConfiguration , ChatInputBarConfiguration oder ChannelTabsConfiguration aus.Dann aktiviere oder deaktiviere die Komponente im Eigenschaften-Fenster.

Wenn ChannelTabsConfiguration aktiviert ist, erscheint jedes Standard-TextChannel in einem Tab wie im folgenden Tabellen beschrieben.Darüber hinaus erstellt jedes benutzerdefinierte TextChannel eine Registerkarte, die der Eigenschaftendes Kanals entspricht Name.

Aussehen

Das Aussehen des gesamten Chatfensters ist anpassbar durch ChatWindowConfiguration.

Auswahlleiste-Aussehen

Das Aussehen der Chat-Eingabeleiste ist anpassbar durch ChatInputBarConfiguration.

Aussehen der Kanal-Tabs

Das Aussehen der Kanal-Tabs ist über ChannelTabsConfiguration.

Nachrichten anpassen

Du kannst das Aussehen von Chat-Nachrichtenkörpern und Präfixen anpassen, indem du ChatWindowMessageProperties und TextChatService.OnChatWindowAdded Rückrufe verwendest, ohne die bestehende UI zu überschreiben.Die Anpassungsoptionen ermöglichen es Ihnen, das Aussehen von Chat-Nachrichten zu modifizieren, um das Thema Ihrer Erlebniszu entsprechen, und Sie können auch Nachrichten von verschiedenen Benutzergruppen nach Farbe sortieren oder hervorheben, indem Sie Präfixe färben oder Chat-Tags hinzufügen.

Farbene Benutzernamen

Wenn ein Benutzer eine Chatnachricht sendet, wird seine DisplayName Anzeige als Präfixteil der Nachricht angezeigt.Standardmäßig wird der Name jedes Benutzers nach seinen Player.TeamColor gefärbt, aber du kannst die Farben der Chat-Namen mit ChatWindowMessageProperties und OnChatWindowAdded ändern.Das Folgende LocalScript in StarterPlayerScripts weist jedem Benutzer eine vordefinierte Farbe zu, wählt zufällig aus einer Tabelle mit RGB-Farben.

LocalScript - Zufällige Benutzername-Farben
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

Du kannst auch Farb- und Transparenzgradienten auf Farb-Nachrichtenpräfixe anwenden, indem du UIGradient verwendest.

Gradient-Benutzername-Farben
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

Reiche Textanpassung

Reicher Text Font-Farben-Tags können verwendet werden, um Chatnachrichten zu formatieren, nützlich, wenn Sie die Formatierung auf sehr spezifische Teile der Nachricht anwenden möchten.Beachten Sie, dass reicher Text keine Gradienten unterstützt, aber das folgende Codebeispiel zeigt, wie Sie den Benutzernamen (der in TextChatMessage.PrefixText gespeichert ist) in den Nachrichtenkörper verschieben und dann nur den Namensteil mit reichhaltigen Textmarkierungen versehen können.

Reiche Textanpassung
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

Sende Nachrichten von nicht-spielerischen Quellen

Manchmal möchten Sie möglicherweise den Nicht-Spieler-Dialog im Chat-Fenster anzeigen, z. B. "Sprache" aus einem öffentlichen Adresssystem oder einem Nicht-Spieler-Charakter.

System

Um eine Systemnachricht an den lokalen Spieler:inzu senden, rufen Sie DisplaySystemMessage() aus dem Standardkanal RBXGeneral mit einem Präfix vor dem Display-Namen des Spieler:inauf.

Client-Skript
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 "

-- Senden Sie "Nachricht" an Spieler mit ihrem Displaynamen angehängt
generalChannel:DisplaySystemMessage(PREFIX .. player.DisplayName)

Für einen detaillierteren Leitfaden zur Anpassung des Aussehens von Systemnachrichten siehe Anpassung von Systemnachrichten.

Standard systemnachrichten

Wenn TextChatService.CreateDefaultTextChannels ist true , ist einer der Standardtextkanäle der Kanal RBXSystem .Die Standard-Chat-Skripte zeigen automatisch Systemnachrichten in diesem Kanal an.Du kannst das Aussehen dieser Nachrichten anpassen, indem du den TextChannel.OnIncomingMessage Callbackverwendest.

Vielleicht möchten Sie die Systemnachrichten anpassen oder ändern, die vom Chat-System automatisch emittiert werden.Da die Standard-Systemnachrichten für Benutzer lokalisiert sind, solltest du sie mit TextChatMessage.Metadata in deinen Text-Chat-Anrufen referenzieren, wenn du ihr Aussehen anpassen möchtest.

Im Folgenden ist eine Referenz der Standard-Systemnachrichten, die vom Chat-System emittiert werden:

NPC/Objekt

Du kannst auch den nicht-spielerischen Dialog stylen und Chat-Blasen hinzufügen, um zu vermitteln, dass Nachrichten von einem NPC oder einem Objekt innerhalb der 3D-Welt kommen.

Client-Skript
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")

	-- Überprüfen Sie Systemnachrichten, die Metadaten enthalten
	if not textChatMessage.TextSource and textChatMessage.Metadata ~= "" then

		-- Präfix hinzufügen, um die Nachricht so aussehen zu lassen, als wäre sie von einem Spieler:ingesendet
		properties.PrefixText = string.format("<font color='#%s'>%s: </font>", "#50C999", textChatMessage.Metadata)

		-- Blasenchat hinzufügen
		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)