Platform-geïntegreerde chat

Platform-geïntegreerde chat geeft elke speler consistente toegang tot veiligheidstools zoals rapporteren en dempen, en laat chatfuncties zoals Snelle Woorden betrouwbaar uitrollen over alle games. Het vervangt ook het huidige prefix-systeem, zodat rollen die aan gebruikers zijn gekoppeld consistent worden weergegeven en veilig zijn voor alle leeftijden.

Niets in je game verandert totdat je platform-geïntegreerde chat inschakelt in Studio. Nadat je het hebt ingeschakeld:

• Roblox levert en geeft chat weer in het standaardvenster of een TextChannelWindow die je in je UI plaatst. Aangepaste chat-UIs kunnen berichten niet langer zelf weergeven.
• De tekst van spelersberichten is niet toegankelijk voor je code. Je kunt het niet lezen, loggen of exporteren. API's die eerder berichttekst teruggaven, geven nu een lege string ("") terug in plaats van nil, zodat je scripts blijven draaien maar geen inhoud ontvangen.

Niet-ondersteunde API's

Wanneer platform-geïntegreerde chat is ingeschakeld, geven de volgende API's "" (lege string, niet nil) terug en loggen een waarschuwing:

Platform-geïntegreerde chat inschakelen

Om platform-geïntegreerde chat in Studio in te schakelen:

1. Open het Explorer venster.
2. Selecteer TextChatService.
3. Zoek in het Eigenschappen paneel naar PlatformIntegratedChat.
4. Stel het in op Ingeschakeld.

Met de ingeschakelde update geven de eerder genoemde niet-ondersteunde API's lege strings terug en loggen waarschuwingen. Je kunt de eigenschap op elk moment weer instellen op Uitgeschakeld om terug te keren.

Je kunt deze eigenschap alleen in Studio wijzigen, niet vanuit een script.

Maak een TextChannelWindow

Om een TextChannelWindow te maken:

1. Maak een ScreenGui in StarterGui.
2. Voeg een TextChannelWindow instantie toe als kind van de ScreenGui.
3. Stel de Size en Position eigenschappen in om het venster te plaatsen waar je het wilt.
4. Stel de Target eigenschap in op de TextChannel die je wilt dat het venster weergeeft.

Elke TextChannelWindow bindt aan een enkele TextChannel. Om meerdere kanalen samen weer te geven, maak je een TextChannelWindow voor elk kanaal en pas je je eigen toon/verberg-logica toe. Het globale kanaal is niet beschikbaar als doel voor een aangepast venster.

Het volgende codevoorbeeld maakt een aangepast chatvenster dat het RBXGeneral kanaal weergeeft:

local TextChatService = game:GetService("TextChatService")

local screenGui = Instance.new("ScreenGui")
screenGui.Name = "TextChannelWindowDemo"
screenGui.Parent = script.Parent

local myTextChannelWindow = Instance.new("TextChannelWindow")
myTextChannelWindow.Size = UDim2.new(0, 400, 0, 300)
myTextChannelWindow.Position = UDim2.new(0, 10, 0, 10)
myTextChannelWindow.BackgroundColor3 = Color3.fromRGB(20, 20, 20)
myTextChannelWindow.BackgroundTransparency = 0.5

local targetChannelName = "RBXGeneral"
local targetChannel = TextChatService:WaitForChild("TextChannels"):WaitForChild(targetChannelName)

if targetChannel and targetChannel:IsA("TextChannel") then
	myTextChannelWindow.Target = targetChannel
end

myTextChannelWindow.Parent = screenGui

Toon een aangepast kanaal alleen in zijn eigen venster

Standaard geeft het standaard chatvenster berichten weer van elk TextChannel, zodat een kanaal dat je in een aangepast TextChannelWindow toont, ook in het standaardvenster verschijnt.

Om een aangepast kanaal alleen in zijn eigen venster weer te geven:

1. Selecteer in de Explorer ChatWindowConfiguration onder TextChatService.
2. Stel in het Eigenschappen paneel TextChannelDisplayMode in op DefaultTextChannels.
3. Maak voor elk aangepast kanaal een TextChannelWindow en stel de Target in op dat kanaal.

Het volgende voorbeeld toont een aangepast Guild-kanaal dat alleen in zijn eigen venster verschijnt:

-- Voorwaarde: TextChannelDisplayMode is ingesteld op DefaultTextChannels in Studio.
local TextChatService = game:GetService("TextChatService")
local Players = game:GetService("Players")
local playerGui = Players.LocalPlayer:WaitForChild("PlayerGui")

-- Scripts kunnen de eigenschap tijdens runtime lezen, maar kunnen deze niet wijzigen.
local config = TextChatService.ChatWindowConfiguration
if config.TextChannelDisplayMode ~= Enum.TextChannelDisplayMode.DefaultTextChannels then
	warn("Guild-berichten verschijnen ook in het standaard chatvenster.")
end

local guildChannel = TextChatService:WaitForChild("TextChannels"):WaitForChild("Guild")

local screenGui = Instance.new("ScreenGui")
screenGui.Name = "GuildChat"
screenGui.Parent = playerGui

local guildWindow = Instance.new("TextChannelWindow")
guildWindow.Size = UDim2.new(0, 400, 0, 300)
guildWindow.Target = guildChannel
guildWindow.Parent = screenGui

Houd rekening met deze gedragingen:

• Je kunt TextChannelDisplayMode alleen in Studio of vanuit een plugin instellen. Scripts kunnen het tijdens runtime lezen, maar kunnen het niet wijzigen.
• De eigenschap bestaat alleen op ChatWindowConfiguration. TextChannelWindow heeft het niet nodig omdat het al een enkel kanaal weergeeft via Target.
• Kanalen die tijdens runtime worden gemaakt, volgen de huidige modus wanneer ze verschijnen. Standaardkanalen die tijdens runtime worden gemaakt, zoals Team en Whisper, verschijnen nog steeds in het standaardvenster.

Migreer chat-geactiveerde admin-opdrachten

Of je je admin-opdrachten moet bijwerken, hangt af van hoe ze worden geactiveerd:

• Opdrachten die vanuit de chat worden geactiveerd, moeten TextChatCommand gebruiken.
• Opdrachtverwerking die ruwe chattekst leest, werkt niet langer. Dit omvat MessageReceived, Chatted, of iets anders dat de inhoud van TextChatMessage inspecteert.

Om te migreren:

1. Identificeer admin-opdrachten in je game die momenteel ruwe chatberichten parseren.
2. Maak een TextChatCommand voor elke opdracht.
3. Definieer het triggerwoord en de callback-logica van de opdracht.
4. Verwijder alle code die Text leest of luistert naar Chatted voor opdrachtverwerking.

Voor een voorbeeld, zie Aangepaste tekstchatopdrachten.

FAQ