Kunden-seitige Chat-Module

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Sie können die folgenden Chat-Module verwenden, um die Client-seitigen Verhaltensweisen des Legacy Chat-Systems zu unterstützen.

Chat-Fenster

Das ChatWindow ist das Hauptchat-Modul der Seite des Clients des Legacy-Chat-Systems.

Methoden

Channel hinzufügen

Kanal entfernen

  • Parameter: string : channelName
  • Beschreibung: Entfernt eine ChatChannelUI mit dem angegebenen channelName aus dem Fenster.
  • Rückgibt: void

Channel erhalten

  • Parameter: string : channelName
  • Beschreibung:: Holen Sie sich die ChatChannelUI mit dem angegebenen channelName wenn es existiert.
  • Rückgaben: ChatChannelUI oder nil

Aktuellen Kanal bekommen

SwitchCurrentKanal

  • Parameter: string : channelName
  • Beschreibung: Schaltet den aktuellen Kanal auf den ChatChannelUI mit dem angegebenen channelName um, wenn er vorhanden ist.
  • Rückgibt: void

Sichtbar machen

  • Parameter: Keine
  • Beschreibung: gibt zurück, ob das Fenster sichtbar ist oder nicht. Beachten Sie: Dies bezieht sich auf die Chat-UI im Allgemeinen; wenn das Chat-Fenster aufgrund von Inaktivität transparen wird, wird das Fenster immer noch als sichtbar betrachtet.
  • Rückgaben: Boolean

SichtbarSetzen

  • Argumente:: Boolean: : visible
  • Beschreibung: Setzt die Sichtbarkeit des Chat-Fensters.
  • Rückgibt: void

Hintergrund löschen

  • Argumente:: schwimmender : duration
  • Beschreibung:: Verblasst den Hintergrund über die angegebene duration in Sekunden. Beachten Sie: spätere Aufrufe zum Steuern von Verblasstem/Verblasstem werden frühere Aufrufe überschreiben.
  • Rückgibt: void

FadeInHintergrund

  • Argumente:: schwimmender : duration
  • Beschreibung:: Verblasst im Hintergrund über dem angegebenen duration in Sekunden. Beachten Sie: spätere Anrufe zum Steuern von Verblasst/Ausblasst werden frühere Anrufe überschreiben.
  • Rückgibt: void

FadeOutText

  • Argumente:: schwimmender : duration
  • Beschreibung:: Fades out den Text über die angegebene duration in Sekunden. Beachte: spätere Aufrufe zum Steuern von Fading in/out werden frühere Aufrufe überschreiben.
  • Rückgibt: void

FadeInText

  • Argumente:: schwimmender : duration
  • Beschreibung:: Verblasst im Text über der angegebenen duration in Sekunden. Beachte: spätere Aufrufe zum Steuern von Verblasst/Out werden frühere Aufrufe überschreiben.
  • Rückgibt: void

Chat-Bar

Die ChatBar behandelt die clientseitige Text-Eintrag für das Lua-Chat-System. Es gibt zwei Schlüsselkomponenten der ChatBar:

  • ChatBar , ein TextBox , wo der Spieler Nachrichten und Befehle eingibt (hochge亮 in Orange)
  • MessageMode , ein TextLabel, der Informationen über die Nachricht anzeigen kann (in Grün hervorgehoben)

Methoden

Erhalte UTC

  • Parameter: Keine
  • Beschreibung: gibt die TextBox der Chat-Bar zurück.
  • Rückgaben: TextBox

ErhalteMessageModeTextLabel

  • Parameter: Keine
  • Beschreibung: gibt die MessageMode zurück TextLabel.
  • Rückgaben: TextLabel

Ist konzentriert

  • Parameter: Keine
  • Beschreibung: Gibt zurück, ob die Chat-Bar TextBox in Fokus (Spieler tippt in Auswahlbox) ist. Äquivalent于调用 TextBox:IsFocused 在结果上的 GetTextBox。
  • Rückgaben: Boolean

Kapitursicht

  • Parameter: Keine
  • Beschreibung: zwingt den Client, sich auf das TextBox der Chat-Bar zu konzentrieren. Äquivalent zu dem Aufrufen von TextBox:CaptureFocus auf dem Ergebnis von GetExecutor.
  • Rückgibt: void

Release-Fokus

  • Argumente: Boolean: : submitted = false
  • Beschreibung: Veröffentlicht die Konzentration der Chat-Bar TextBox. Wenn submitted wahr ist, wird dies so verhalten, als ob der Spieler Enter drückte, um die Nachricht zu senden.
  • Rückgibt: void

Text zurücksetzen

  • Parameter: Keine
  • Beschreibung: Setzt den Text der Chat-Leiste TextBox auf die leere String.
  • Rückgibt: void

Setzen Sie Text

  • Argumente:: string : text
  • Beschreibung: Setzt die Text der Chat-Leiste TextBox auf das angegebene 0> text0>.
  • Rückgibt: void

Erhalten Sie Text

  • Parameter: Keine
  • Beschreibung: gibt den Text in der Chat-Bar zurück TextBox.Text .
  • Rückgaben: string

SetTextLabelText

  • Argumente:: string : text
  • Beschreibung: Setzt die Text des MessageMode TextLabel auf die angegebene 0> text0> .
  • Rückgibt: void

GetEnabled

  • Parameter: Keine
  • Beschreibung: Gibt zurück, ob die Chat-Leiste Visible ist.
  • Rückgaben: Boolean

SetAktiviert

  • Parameter: Boolean: : enabled
  • Beschreibung: Setzt, ob die Chat-Leiste Visible ist.
  • Rückgibt: void

Textgröße einstellen

  • Argumente: int : textSize
  • Beschreibung: Setzt die TextSize von both the chat bar's TextBox und MessageMode 0> TextLabel0> .
  • Rückgibt: void

ZurücksetzenSize

  • Parameter: Keine
  • Beschreibung: Setzt die Größe der Chat-Bar auf eine Zeile Text.
  • Rückgibt: void

SetChannelZiel

  • Parameter: string : channelName
  • Beschreibung:: Setzt das Ziel ChatChannelUI mit seinem channelName an, an den der Chat-Bar Nachrichten senden soll.
  • Rückgibt: void

Hintergrund löschen

  • Argumente:: float: : duration 0> duration0>
  • Beschreibung:: Verblasst den Hintergrund über die angegebene duration in Sekunden. Beachten Sie: spätere Aufrufe zum Steuern von Verblasstem/Verblasstem werden frühere Aufrufe überschreiben.
  • Rückgibt: void

FadeInHintergrund

  • Argumente:: float: : duration 0> duration0>
  • Beschreibung:: Verblasst im Hintergrund über dem angegebenen duration in Sekunden. Beachten Sie: spätere Anrufe zum Steuern von Verblasst/Ausblasst werden frühere Anrufe überschreiben.
  • Rückgibt: void

FadeOutText

  • Argumente:: float: : duration 0> duration0>
  • Beschreibung:: Fades out den Text über die angegebene duration in Sekunden. Beachte: spätere Aufrufe zum Steuern von Fading in/out werden frühere Aufrufe überschreiben.
  • Rückgibt: void

FadeInText

  • Argumente:: float: : duration 0> duration0>
  • Beschreibung:: Verblasst im Text über der angegebenen duration in Sekunden. Beachte: spätere Aufrufe zum Steuern von Verblasst/Out werden frühere Aufrufe überschreiben.
  • Rückgibt: void

Chat-Kanal-Benutzeroberfläche

Die ChatChannelUI ist die Client-Version von ChatChannel. Sie erhält ChatMessages vom Server und überträgt sie an den 1> ChatMessageLogDisplay1>, der mit ihr verbunden ist.

Methoden

Nachricht an Kanal hinzufügen

Letzte Nachricht vom Kanal entfernen

ClearMessageLog

ChatNachrichten-Anzeige

Der ChatMessageLogDisplay verwaltet die Darstellung von ChatMessages in einem ChatChannelUI.

Methoden

Nachricht hinzufügen

  • Parametre: ChatMessagemessage
  • Beschreibung: Fügt dem message-Anzeigeprotokoll ein message hinzu.
  • Rückgibt: void

Letzte Nachricht entfernen

  • Parameter: Keine
  • Beschreibung: Entfernt die älteste ChatMessage im Nachrichten-Log-Anzeige.
  • Rückgibt: void

Alle Nachrichten neuordnen

  • Parameter: Keine
  • Beschreibung: Re-sorts alle Anzeigeelemente in aufsteigender Reihenfolge, relativ zur Größe des Anzeigeelements. Dies sollte aufgerufen werden, wenn das Anzeilelement neu sortiert wird.
  • Rückgibt: void

Löschen

  • Parameter: Keine
  • Beschreibung: Entfernt alle ChatMessages aus der Anzeige des Nachrichtenlogs.
  • Rückgibt: void

FadeOutText

  • Argumente: schwimmenderduration
  • Beschreibung:: Fades out den Text über die angegebene duration in Sekunden. Beachte: spätere Aufrufe zum Steuern von Fading in/out werden frühere Aufrufe überschreiben.
  • Rückgibt: void

FadeInText

  • Argumente: schwimmenderduration
  • Beschreibung:: Verblasst im Text über der angegebenen duration in Sekunden. Beachte: spätere Aufrufe zum Steuern von Verblasst/Out werden frühere Aufrufe überschreiben.
  • Rückgibt: void

Chat-Benutzeroberfläche

Die ChatCustomState ist eine Oberfläche von Rückrufen, die verwendet werden, wenn ein benutzerdefinierter Chat-Status im Chat-Fenster erstellt wird.

Whisper-Chat und Team-Chat verwenden ChatCustomState, um dem Spieler anzuzeigen, wo sein Nachrichten senden wird.

Rückrufe

Text aktualisiert

  • Parameter: Keine
  • Beschreibung:: Aufgerufen, wenn der Text in der Chat-Bar aktualisiert wird.
  • Rückgibt: void

Nachricht erhalten

  • Parameter: Keine
  • Beschreibung: Aufgerufen, um den Text der Nachricht zu erhalten, wie er als einzelnes Befehl geschrieben würde. Dies wird im Falle verwendet, dass der Server die Befehlsanzeige als Text anzeigt, anstatt den visuellen Zustand der Befehlsanzeige zu verarbeiten.
  • Rückgaben: string

Ausgewählte Nachricht

  • Parameter: Keine
  • Beschreibung:: Wird aufgerufen, wenn der Spieler die Nachricht einreicht, die vom benutzerdefinierten Zustand verarbeitet wird. Dies sollte wahr sein, wenn die Nachricht nicht angezeigt oder an den Server gesendet werden sollte.
  • Rückgaben: Boolean

Zerstören

  • Parameter: Keine
  • Beschreibung:: Die als ChatBar gekennte wird zurückgesetzt, um ihren ursprünglichen Zustand vor der Benutzerdefinierten Zustandsmodifizierung wiederherzustellen.
  • Rückgibt: void

ChatEinstellungen

Die ChatSettings ist ein Wörterbuch von Einstellungen für die clientseitige des Lua-Chat-Systems. Sie werden in einem ModuleScript namens ChatSettings gespeichert, der unter der 1> Chat1> Spieldienste unter dem 4> Folder4> namens ClientChatModule gefunden werden kann.

Um eine Einstellung zu ändern, benötigen Sie dieses Modul mit einem LocalScript in der folgenden Weise:


-- Benötigen Sie das ChatSettings-Modul (warten Sie, bis es geladen ist)
local Chat = game:GetService("Chat")
local ClientChatModules = Chat:WaitForChild("ClientChatModules")
local ChatSettings = require(ClientChatModules:WaitForChild("ChatSettings"))
-- Ändere Einstellungen, wie du es mit jeder anderen Tabelle tun würdest.
ChatSettings.MaximumMessageLength = 100

Chat-Verhaltens-Einstellungen

FensterDraggable

  • Typ: bool
  • Standard: false
  • Beschreibung:: Bestimmt, ob das Chat-FensterDraggable ist.

Fenster anpassbar

  • Typ: bool
  • Standard: false
  • Beschreibung: Bestimmt, ob das Chatfenster des Spieler:inskaliert werden kann

GamepadNavigieren aktiviert

  • Typ: bool
  • Standard: false
  • Beschreibung: Bestimmt, ob Gamepads die Chat-Benutzeroberfläche navigieren können.

ShowUserOwnFilteredNachricht

  • Typ: bool
  • Standard: true
  • Beschreibung:: Bestimmt, ob Spieler die gefilterte Version ihrer Chat-Nachrichten sehen sollen, oder den ursprünglichen Inhalt, den sie geschrieben haben.

Chat mit Topbar off

  • Typ: bool
  • Standard: false
  • Beschreibung: Bestimmt, ob die Chat-Oberfläche aktiviert ist, auch wenn die Topbar deaktiviert ist.

BlasenChat aktiviert

  • Typ: bool
  • Standard: game:GetService("Players").BubbleChat
  • Beschreibung:: Bestimmt, ob der Blasen-Chat aktiviert ist.

ClassicChat aktiviert

  • Typ: bool
  • Standard: game:GetService("Players").ClassicChat
  • Beschreibung:: Bestimmt, ob der klassische Chat aktiviert ist.

Chat-Textgröße-Einstellungen

ChatWindowTextgröße

  • Typ: int
  • Standard: 18
  • Beschreibung:: Bestimmt die Größe des Textes im Chat-Fenster.

ChatBarTextSize

  • Typ: int
  • Standard: 18
  • Beschreibung:: Bestimmt die Größe des Textes in der ChatBar.

ChatWindowTextSizePhone

  • Typ: int
  • Standard: 14
  • Beschreibung:: Bestimmt die Größe des Textes im Chat-Fenster für Telefone.

ChatBarTextSizePhone

  • Typ: int
  • Standard: 14
  • Beschreibung:: Bestimmt die Größe des Textes im ChatBar für Telefone.

Zeichensetzungseinstellungen

Standard-Font

ChatBarFont

Farbeinstellungen

Hintergrundfarbe

  • Typ: Color3
  • Standard: Color3.new(0, 0, 0)
  • Beschreibung: Bestimmt die BackgroundColor3 des ChatWindows.

Standard-Nachrichtenfarbe

  • Typ: Color3
  • Standard: Color3.new(1, 1, 1)
  • Beschreibung: Bestimmt die Standard TextColor3 von ChatMessages im 0> ChatWindow0>.

Standardnamefarbe

  • Typ: Color3
  • Standard: Color3.new(1, 1, 1)
  • Beschreibung: Bestimmt die Standard TextColor3 von Sprecher-Namen in Chat-Nachrichten im 0>Chat-Fenster0>.

ChatBar-Hintergrundfarbe

  • Typ: Color3
  • Standard: Color3.new(0, 0, 0)
  • Beschreibung: Bestimmt die BackgroundColor3 des ChatBar.

ChatBarBoxFarbe

  • Typ: Color3
  • Standard: Color3.new(1, 1, 1)
  • Beschreibung: Bestimmt die BackgroundColor3 des ChatBar 0> Executor0>.

ChatBarTextFarbe

  • Typ: Color3
  • Standard: Color3.new(0, 0, 0)
  • Beschreibung:: Bestimmt die TextColor3 des ChatBar.

Fehler-Nachricht-Farbe

  • Typ: Color3
  • Standard: Color3.fromRGB(245, 50, 50)
  • Beschreibung: Bestimmt die TextColor3 von Fehler-Nachrichten.

Fenster-Einstellungen

Minimum Fenstergröße

  • Typ: UDim2
  • Standard: UDim2.new(0.3, 0, 0.25, 0)
  • Beschreibung: Bestimmt die kleinste mögliche Größe des ChatWindows (angesichts der Tatsache, dass WindowResizable aktiviert ist).

Maximum Fenstergröße

  • Typ: UDim2
  • Standard: UDim2.new(1, 0, 1, 0)
  • Beschreibung: Bestimmt die größtmögliche Größe des ChatWindows (angesichts der Tatsache, dass WindowResizable aktiviert ist).
  • Notizen: Wenn dies auf die volle Bildschirmgröße geändert wird, beginnen seltsame Dinge mit der Größen-/Position-Festlegung zu passieren.

Standardfensterposition

  • Typ: UDim2
  • Standard: UDim2.new(0, 0, 0, 0)
  • Beschreibung:: Bestimmt die Standardposition des Chat창.

Standard-FenstergrößePhone

  • Typ: UDim2
  • Standard:: UDim2.new(0.5, 0, 0.5, (7 * 2) + (5 * 2))
  • Beschreibung:: Bestimmt die Standardgröße des Chat창 auf Telefonen.

Standard-FenstergrößeTablet

  • Typ: UDim2
  • Standard: UDim2.new(0.4, 0, 0.3, (7 * 2) + (5 * 2))
  • Beschreibung:: Bestimmt die Standardgröße des Chat창 auf Tischen.

Standard-Fenstergröße Desktop

  • Typ: UDim2
  • Standard:: UDim2.new(0.3, 0, 0.25, (7 * 2) + (5 * 2))
  • Beschreibung:: Bestimmt die Standardgröße des Chat창 auf dem Desktop.

Verblasen und in Einstellungen

ChatWindowBackgroundFadeOutTime

ChatWindowTextFadeOutTime

ChatStandardFadeDuration

  • Typ: schwimmender Schwertkopf (Sekunden)
  • Standard: 0.8
  • Beschreibung:: Bestimmt, wie lange die Verblasst-Chat-Benutzeroberfläche Elemente dauert.

ChatShouldFadeInFromNewInformation

  • Typ: bool
  • Standard: false
  • Beschreibung:: Bestimmt, ob der Chat nach dem Erhalten neuer Nachrichten verblasst.

Chat-AnimationFPS

  • Standard: 20.0
  • Beschreibung:: Bestimmt die Bildrate der Verblasst Animationen in der Chat-Benutzeroberfläche.

Kanal-Einstellungen

Allgemeiner Kanalname

  • Typ: string
  • Standard: "All"
  • Beschreibung: Bestimmt den Namen des Kanal.

EchoNachrichtenInGeneralKanal

  • Typ: bool
  • Standard: true
  • Beschreibung:: Bestimmt, ob Nachrichten an Kanäle außer dem Standardkanal in den Kanaleingenommen werden sollen.

Max. Kanalname Länge

  • Typ: int
  • Standard: 12
  • Beschreibung: Bestimmt die maximale Länge eines Kanalnamens, bevor er gekürzt wird.

Nachrichtenlänge pro Kanal

  • Typ: int
  • Standard: 50
  • Beschreibung:: Bestimmt die maximale Anzahl von ChatMessage, die in einem Chat-Kanal angezeigt werden kann.

ZeigeJoinAndLeaveHelpText

  • Typ: bool
  • Standard: false
  • Beschreibung: Bestimmt, ob der Hilfstext für das Beitreten/Verlassen von Kanälen angezeigt wird.

Nachrichteneinstellungen

Maximale Nachrichtenlänge

  • Typ: int
  • Standard: 200
  • Beschreibung:: Bestimmt die maximale Länge von ChatMessages .

Nicht erlaubter Weißer Platz

  • Typ: Arrays< string >
  • Standard: {"\n", "\r", "\t", "\v", "\f"}
  • Beschreibung: Bestimmt die weißen Zeichen, die nicht erlaubt sind.

Klicken Sie auf den Namen des Spielers, um

  • Typ: bool
  • Standard: true
  • Beschreibung:: Bestimmt, ob der Spieler auf den Namen eines anderen Spieler:inklicken kann, um in einem Whisper-Chat mit ihnen zu engagieren.

Klicken Sie auf den Kanalnamen, um den Hauptkanal einzurichten

  • Typ: bool
  • Standard: true
  • Beschreibung:: Bestimmt, ob der Spieler auf die Registerkarte eines Kanals klicken kann, um ihn als seinen Hauptkanal festzulegen.

Sonstige Einstellungen

Flüstern Sie die Namen der Spieler automatisch ab

  • Typ: bool
  • Standard: true
  • Beschreibung: Bestimmt, ob der Flüstern-Befehl automatisch Spieler-Namen abschließt.

Ereignisse

Einstellungen geändert

  • Argumente: Library.string``settingName , Variant 0> newValue0>
  • Beschreibung:: Feuert, wenn eine Einstellung mit dem angegebenen settingName auf newValue geändert wird.