Pas bubble chat aan

Met TextChatService kun je bubble chat gebruiken om aanpasbare spraakchatbellen boven gebruikersavatars en NPC's weer te geven. Bubble chat kan je spel visueel meeslepender maken en gebruikers helpen om berichten en hun sprekers op een contextueel relevante manier gemakkelijk te identificeren. Deze functie is vooral nuttig voor spellen waarin gebruikers zich moeten concentreren op de inhoud terwijl ze tegelijkertijd met anderen communiceren op een minder opdringerige manier.

Bubble chat inschakelen

Om bubble chat in je spel in te schakelen:

1. Selecteer in het Explorer venster BubbleChatConfiguration onder TextChatService.

   

2. Vink in het Properties venster het vakje BubbleChatConfiguration.Enabled aan.

   

Bubble aanpassing

Nadat je bubble chat hebt ingeschakeld, kun je het uiterlijk en gedrag van je chatbellen aanpassen om overeen te komen met het thema van je spel. Gebruik het Properties venster van BubbleChatConfiguration voor basis wijzigingen zoals tekstkleur en spatiëring, of implementeer geavanceerde aanpassingen voor achtergrondafbeeldingen van bellen en andere visuele aanpassingen.

Voeg alternatieve een LocalScript toe in StarterPlayerScripts met al je aanpassingsinstellingen. Dit stelt de engine in staat om je aanpassingen tijdens runtime toe te passen, waarbij de instellingen in Studio worden overschreven. Het is nuttig voor het toevoegen van speciale effecten aan chatbellen wanneer gebruikers bepaalde gebeurtenissen of voorwaarden activeren.

Basis aanpassing

De volgende tabel toont veelvoorkomende aanpassingsproperties voor bubble chat. Voor een volledige lijst van aanpassingsproperties, zie BubbleChatConfiguration.

Geavanceerde aanpassing

Voor geavanceerde aanpassing van je bubble, voeg UI-objecten toe die bepaalde aspecten van het uiterlijk van de bubble vertegenwoordigen als kinderen onder BubbleChatConfiguration, waaronder:

• ImageLabel voor achtergrondafbeeldingsinstellingen.
• UIGradient voor achtergrondverloopinstellingen.
• UICorner voor de hoekvorm van bellen.
• UIPadding voor de paddingruimte tussen de tekst en de randen van de bubble, relatief aan de normale grootte van de ouder.

Nadat je deze objecten hebt toegevoegd, kun je eigenschappen van deze objecten aanpassen die van toepassing zijn op chatbellen voor geavanceerde bubble aanpassing. Het volgende voorbeeld LocalScript voegt een achtergrondafbeelding en scherpe hoeken toe aan bellen:

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

De volgende tabellen schetsen de beschikbare GuiObject en uiterlijk modificator kinderen samen met hun geldige aanpassingsproperties:

Per-bubble aanpassing

Je kunt chatbellen individueel stylen en het gedrag ervan aanpassen op basis van specifieke voorwaarden om je algemene instellingen te overschrijven. Bijvoorbeeld, je kunt chatbellen gebruiken om NPC's en gebruikers te onderscheiden, kritieke gezondheidsstatus te benadrukken, en speciale effecten toe te passen op berichten met vooraf gedefinieerde sleutelwoorden.

Om per-bubble aanpassing in te stellen, voeg een client-side LocalScript toe met behulp van BubbleChatMessageProperties, die overeenkomende eigenschappen van BubbleChatConfiguration overschrijft, en de TextChatService.OnBubbleAdded callback om te specificeren hoe je elke bubble wilt aanpassen. De callback levert je de TextChatMessage eigenschap evenals de adornee, zodat je de aanpassing kunt toepassen op basis van attributen die zijn geassocieerd met gebruikers, de chattekstinhoud, eigenschappen van gebruikerskarakters, en eventuele speciale voorwaarden die je wilt definiëren.

De volgende basis aanpassingsproperties zijn beschikbaar voor per-bubble aanpassing:

Het volgende voorbeeld voegt een speciale uitstraling toe aan de chatbellen van VIP-gebruikers door te controleren of een chatbericht verzender de IsVIP attribuut heeft:

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

-- Evenement handler voor wanneer een nieuwe chat bubble aan het spel is toegevoegd
TextChatService.OnBubbleAdded = function(message: TextChatMessage, adornee: Instance)
	-- Controleer of het chatbericht een TextSource (afzender) heeft die eraan is gekoppeld
	if message.TextSource then
		-- Maak een nieuwe BubbleChatMessageProperties instantie aan om de chat bubble aan te passen
		local bubbleProperties = Instance.new("BubbleChatMessageProperties")

		-- Verkrijg de gebruiker die het chatbericht heeft verzonden op basis van hun UserId
		local player = Players:GetPlayerByUserId(message.TextSource.UserId)

		if player:GetAttribute("IsVIP") then
			-- Als de speler een VIP is, pas de eigenschappen van de chat bubble aan
			bubbleProperties.TextColor3 = Color3.fromHex("#F5CD30")
			bubbleProperties.BackgroundColor3 = Color3.fromRGB(25, 27, 29)
			bubbleProperties.FontFace = Font.fromEnum(Enum.Font.PermanentMarker)
		end
		return bubbleProperties
	end
end

Alle geavanceerde aanpassingsopties zijn beschikbaar voor per-bubble aanpassing. Vergelijkbaar met geavanceerde aanpassing voor algemene bellen, voeg instanties toe die je wilt aanpassen als kinderen van BubbleChatMessageProperties. Het volgende voorbeeld voegt een speciaal verloop effect toe samen met andere eigenschappen aan chatbellen van gebruikers met een lage gezondheidsstatus door de Humanoid.Health eigenschap van de chatbericht verzenders' karakters te controleren:

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

-- Evenement handler voor wanneer een nieuwe chat bubble aan het spel is toegevoegd
TextChatService.OnBubbleAdded = function(message: TextChatMessage, adornee: Instance)
	-- Controleer of het chatbericht een TextSource (afzender) heeft die eraan is gekoppeld
	if message.TextSource then
		-- Verkrijg de gebruiker die het chatbericht heeft verzonden door hun UserId te gebruiken
		local player = Players:GetPlayerByUserId(message.TextSource.UserId)

		-- Zoek de humanoïde in het karakter van de gebruiker
		local humanoid = player.Character:FindFirstChildWhichIsA("Humanoid")

		if humanoid and humanoid.Health < 25 then
			-- Maak een nieuwe BubbleChatMessageProperties instantie aan om de chat bubble aan te passen
			local bubbleProperties :BubbleChatMessageProperties = Instance.new("BubbleChatMessageProperties")

			-- Pas de eigenschappen van de chat bubble aan voor lage gezondheidsconditie
			bubbleProperties.BackgroundColor3 = Color3.fromRGB(245, 245, 245)
			bubbleProperties.TextColor3 = Color3.fromRGB(234, 51, 96)
			bubbleProperties.TextSize = 20
			bubbleProperties.FontFace = Font.fromEnum(Enum.Font.DenkOne)

			-- Voeg een UIGradient toe als kind om het verloop aan te passen
			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

Handmatig bellen weergeven

Je wilt misschien een chat bubble weergeven wanneer spelers geen bericht hebben verzonden, zoals bij NPC's. Gebruik de TextChatService:DisplayBubble() methode om handmatig een chat bubble weer te geven.

De aanpassing van deze bellen is hetzelfde als de aanpassing van de bellen die automatisch worden weergegeven wanneer spelers berichten verzenden via TextChannels met behulp van de TextChatService.OnBubbleAdded callback.

NPC bellen

Geef chatbellen weer voor niet-speler personages (NPC's) door TextChatService:DisplayBubble(character, message) aan te roepen, met de NPC-figuur en het bericht als parameters. Deze bellen zijn aanpasbaar met behulp van de TextChatService.OnBubbleAdded callback, net als elke andere chat bubble.

TextChatService:DisplayBubble() werkt alleen op client-side scripts, dus zorg ervoor dat je een Script gebruikt met RunContext ingesteld op Enum.RunContext.Client, of een LocalScript in een geschikte container, zoals StarterPlayerScripts. Als je een ProximityPrompt aan een NPC koppelt, kan een script voor het weergeven van een chat bubble er als volgt uitzien:

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, "Hallo wereld!")
end)