Personalizza la chat delle bolle

Con TextChatService, puoi usare la chat a bolle per visualizzare bolle di chat personalizzabili sopra gli avatar degli utenti e i NPC.La chat a bolle può rendere la tua esperienza più visivamente coinvolgente e aiutare gli utenti a identificare facilmente i messaggi e i loro oratori in modo contestualmente rilevante.Questa funzione è particolarmente utile per le esperienze in cui gli utenti devono concentrarsi sul contenuto nel frattempo comunicando con gli altri in modo meno invadente.

Abilita la chat a bolle

Per abilitare la chat a bolle nella tua esperienza:

1. Nella finestra Explorer, seleziona BubbleChatConfiguration sotto TextChatService.

   

2. Nella finestra Proprietà, controlla la casella di controllo BubbleChatConfiguration.Enabled.

   

Personalizzazione della bolla

Dopo aver abilitato la chat a bolle, puoi personalizzare l'aspetto e il comportamento delle tue bolle di chat per abbinare il tema della tua esperienza.Usa la finestra Proprietà di BubbleChatConfiguration per modifiche di base come colore del testo e spaziatura, o implementa personalizzazione avanzata per le immagini di sfondo delle bolle e altri aggiustamenti visivi.

In alternativa, aggiungi un LocalScript in StarterPlayerScripts con tutte le tue impostazioni di personalizzazione.Questo consente al motore di applicare le tue personalizzazioni durante l'Tempo esecuzione, sostituendo le impostazioni in Studio.È utile per aggiungere effetti speciali alle bolle di chat quando gli utenti attivano determinati eventi o condizioni.

Personalizzazione di base

La seguente tabella mostra le proprietà di personalizzazione della chat a bolle comune. Per una lista completa delle proprietà di personalizzazione, vedi BubbleChatConfiguration .

Personalizzazione avanzata

Per una personalizzazione avanzata della tua bolla, aggiungi oggetti UI che rappresentano determinati aspetti dell'aspetto della bolla come figli sotto BubbleChatConfiguration, tra cui:

• ImageLabel per le impostazioni dell'immagine di sfondo.
• UIGradient per le impostazioni di gradiente di sfondo.
• UICorner per la forma angolare delle bolle.
• UIPadding per lo spazio di imbottitura tra i bordi del testo e della bolla, rispetto alle dimensioni normali del parent.

Dopo aver aggiunto questi oggetti, puoi modificare le proprietà di questi oggetti applicabili alle bolle di chat per una personalizzazione avanzata delle bolle.L'esempio seguente LocalScript aggiunge un'immagine di sfondo e angoli acuti alle bolle:

Personalizzazione avanzata delle bolle
local TextChatService = game:GetService("TextChatService")

local bubbleChatConfiguration = TextChatService.BubbleChatConfiguration
bubbleChatConfiguration.TailVisible = false
bubbleChatConfiguration.TextColor3 = Color3.fromRGB(220, 50, 50)
bubbleChatConfiguration.FontFace = Font.fromEnum(Enum.Font.LuckiestGuy)

local bubbleUICorner = bubbleChatConfiguration:FindFirstChildOfClass("UICorner")
if not bubbleUICorner then
	bubbleUICorner = Instance.new("UICorner")
	bubbleUICorner.Parent = bubbleChatConfiguration
end
bubbleUICorner.CornerRadius = UDim.new(0, 0)

local bubbleUIPadding = bubbleChatConfiguration:FindFirstChildOfClass("UIPadding")
if not bubbleUIPadding then
	bubbleUIPadding = Instance.new("UIPadding")
	bubbleUIPadding.Parent = bubbleChatConfiguration
end
bubbleUIPadding.PaddingTop = UDim.new(0, 20)
bubbleUIPadding.PaddingRight = UDim.new(0, 10)
bubbleUIPadding.PaddingBottom = UDim.new(0, 15)
bubbleUIPadding.PaddingLeft = UDim.new(0, 10)

local bubbleImageLabel = bubbleChatConfiguration:FindFirstChildOfClass("ImageLabel")
if not bubbleImageLabel then
	bubbleImageLabel = Instance.new("ImageLabel")
	bubbleImageLabel.Parent = bubbleChatConfiguration
end
bubbleImageLabel.Image = "rbxassetid://109157529833093"
bubbleImageLabel.ScaleType = Enum.ScaleType.Slice
bubbleImageLabel.SliceCenter = Rect.new(40, 40, 320, 120)
bubbleImageLabel.SliceScale = 0.5

Le seguenti tabelle riassumono i modificatori di aspetto disponibili GuiObject e bambini insieme alle loro proprietà di personalizzazione valide:

Personalizzazione per bolle

Puoi personalizzare e modificare singolarmente i comportamenti della bolla di chat in base a condizioni specifiche per annullare le tue impostazioni generali.Ad esempio, puoi usare le bolle di chat per differenziare NPC e utenti, evidenziare lo Statodi salute critico e applicare effetti speciali ai messaggi con parole chiave predefinite.

Per impostare la personalizzazione per bolla, aggiungi un lato client LocalScript utilizzando BubbleChatMessageProperties , che sostituisce le proprietà corrispondenti di BubbleChatConfiguration , e il richiamo TextChatService.OnBubbleAdded per specificare come personalizzare ogni bolla.Il richiamo ti fornisce la proprietà TextChatMessage e l'ornamento, così puoi applicare la personalizzazione in base agli attributi associati agli utenti, al contenuto del testo della chat, alle proprietà del personaggio dell'utente e a qualsiasi condizione speciale che vuoi definire.

Le seguenti proprietà di personalizzazione di base sono disponibili per la personalizzazione per bolla:

L'esempio seguente aggiunge un aspetto speciale alle bolle di chat degli utenti VIP controllando se un mittente di messaggi di chat ha l'attributo IsVIP:

Bolleggiate VIP
local TextChatService = game:GetService("TextChatService")
local Players = game:GetService("Players")

-- Gestore eventi per quando viene aggiunta una nuova bolla di chat all'esperienza
TextChatService.OnBubbleAdded = function(message: TextChatMessage, adornee: Instance)
	-- Verifica se il messaggio di chat ha una Fonte di testo ( mittente) associata ad esso
	if message.TextSource then
		-- Crea una nuova istanza di BubbleChatMessageProperties per personalizzare la bolla di chat
		local bubbleProperties = Instance.new("BubbleChatMessageProperties")

		-- Ottieni l'utente che ha inviato il messaggio di chat in base al suo UserId
		local player = Players:GetPlayerByUserId(message.TextSource.UserId)

		if player:GetAttribute("IsVIP") then
			-- Se il giocatore è un VIP, personalizza le proprietà della bolla di chat
			bubbleProperties.TextColor3 = Color3.fromHex("#F5CD30")
			bubbleProperties.BackgroundColor3 = Color3.fromRGB(25, 27, 29)
			bubbleProperties.FontFace = Font.fromEnum(Enum.Font.PermanentMarker)
		end
		return bubbleProperties
	end
end

Tutte le opzioni avanzate di personalizzazione sono disponibili per la personalizzazione per bolla.Simile alla personalizzazione avanzata per le bolle generali, aggiungi istanze che vuoi personalizzare come figli di BubbleChatMessageProperties .L'esempio seguente aggiunge un effetto di gradiente speciale insieme ad altre proprietà per le bolle di chat degli utenti con basso stato di salute controllando la proprietà Humanoid.Health dei personaggi dei mittenti del messaggio di chat:

Bolle di bassa salute
local TextChatService = game:GetService("TextChatService")
local Players = game:GetService("Players")

-- Gestore eventi per quando viene aggiunta una nuova bolla di chat all'esperienza
TextChatService.OnBubbleAdded = function(message: TextChatMessage, adornee: Instance)
	-- Verifica se il messaggio di chat ha una Fonte di testo ( mittente) associata ad esso
	if message.TextSource then
		-- Ottieni l'utente che ha inviato il messaggio di chat utilizzando il suo UserId
		local player = Players:GetPlayerByUserId(message.TextSource.UserId)

		-- Trova l'umanoide nel personaggio dell'utente
		local humanoid = player.Character:FindFirstChildWhichIsA("Humanoid")

		if humanoid and humanoid.Health < 25 then
			-- Crea una nuova istanza di BubbleChatMessageProperties per personalizzare la bolla di chat
			local bubbleProperties :BubbleChatMessageProperties = Instance.new("BubbleChatMessageProperties")

			-- Personalizza le proprietà della bolla di chat per la condizione di bassa salute
			bubbleProperties.BackgroundColor3 = Color3.fromRGB(245, 245, 245)
			bubbleProperties.TextColor3 = Color3.fromRGB(234, 51, 96)
			bubbleProperties.TextSize = 20
			bubbleProperties.FontFace = Font.fromEnum(Enum.Font.DenkOne)

			-- Aggiungi un UIGradient come figlio per personalizzare il gradiente
			local uiGradient : UIGradient = Instance.new("UIGradient")
			uiGradient.Color = ColorSequence.new(Color3.fromRGB(110, 4, 0), Color3.fromRGB(0, 0, 0))
			uiGradient.Rotation = 90
			uiGradient.Parent = bubbleProperties
			
			return bubbleProperties
		end
	end
end

Mostra manualmente le bolle

Potresti voler visualizzare una bolla di chat quando i giocatori non hanno inviato un Messaggio, come con i NPC.Usa il metodo TextChatService:DisplayBubble() per visualizzare manualmente una bolla di chat.

La personalizzazione di queste bolle è la stessa della personalizzazione delle bolle che vengono visualizzate automaticamente quando i giocatori inviano messaggi attraverso i canali di testo usando il richiamo TextChatService.OnBubbleAdded callback.

Bolle di NPC

Mostra le bolle di chat per i personaggi non giocatori (NPC) chiamando TextChatService:DisplayBubble(character, message) , con il personaggio NPC e il messaggio come parametri.Queste bolle sono personalizzabili utilizzando il TextChatService.OnBubbleAdded callback come qualsiasi altra bolla di chat.

TextChatService:DisplayBubble() funziona solo su script lato client, quindi assicurati di utilizzare un Script con RunContext impostato su Enum.RunContext.Client , o un LocalScript in un contenitore appropriato , come StarterPlayerScripts .Se aggiungi un ProximityPrompt a un NPC, uno script per visualizzare una bolla di chat potrebbe sembrare questo:

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

local prompt = Workspace.SomeNPC.ProximityPrompt
local head = prompt.Parent:WaitForChild("Head")

prompt.Triggered:Connect(function()
	TextChatService:DisplayBubble(head, "Hello world!")
end)