Kontextmenü für Avatar

Das Avatar-Kontextmenü (ACM) erleichtert es Benutzern, miteinander zu interagieren.Wenn der ACM in deiner Erlebnisaktiviert ist, kann ein Benutzer zum Charakter eines anderen Benutzers gehen und auf sie klicken, um ein kleines Menü mit mehreren Standardoptionen zu öffnen.Der Spieler kann eine Anfragesenden, einen privaten Chat beginnen, das Profil des Benutzers anzeigen oder winken.

Nachdem du den ACM in deiner Erlebnisaktiviert hast, kannst du den ACM auf folgende Weise anpassen:

• Programmieren Sie öffnen und schließen den ACM für bestimmte Benutzer.
• Füge benutzerdefinierte Optionen und entferne bestehende Optionen zum ACM hinzu.
• Anpassen Sie das ACM-Aussehen, um eine einzigartige Benutzeroberfläche zu erstellen.

Aktiviere das Avatar-Kontextmenü

Das Avatar-Kontextmenü muss mit der Option StarterGui:SetCore() "AvatarContextMenuEnabled" in einem LocalScript aktiviert werden.Die ACM wird am besten in Erlebnissen verwendet, in denen es kein vordefiniertes Verhalten für das Klicken auf andere Benutzer gibt.

Verwenden Sie das folgende Codebeispiel, um den ACM in einem LocalScript zu aktivieren:

-- Ausführen in einem LocalScript, idealerweise innerhalb von "StarterPlayerScripts"
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

Wenn Sie feststellen müssen, ob der ACM aktiviert ist, können Sie den folgenden Code verwenden, um einen booleschen Wert über den aktuellen Status des ACM zurückzugeben:

--Gibt eine boolesche Rückgabe zurück, die anzeigt, ob der ACM derzeit aktiviert ist.
StarterGui:GetCore(AvatarContextMenuEnabled)

Öffne und schließe die ACM

Sobald aktiviert, können Sie das ACM-Programm programmatisch mit StarterGui öffnen und schließen.

Um die ACM programmatisch zu öffnen, verwende den folgenden Codes:

-- Verwende StarterGui:SetCore, wo targetPlayer ein gültiges Objektist
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

Um die ACM programmatisch zu schließen, verwende den folgenden Codes:

StarterGui:SetCore("AvatarContextMenuTarget", nil)

Menüoptionen

Du kannst hinzufügen und entfernen Aktionen durch Scripting. Standardmäßig hat das Menü die folgenden Optionen:

Sobald der ACM geöffnet ist, kann der Benutzer durch andere Benutzer scrollen und auf dem Zeichenauswahl-Karussell auswählen.Zeichen werden nach Entfernung zum ausgewählten Zeichen sortiert.Das Menü wird nur aktualisiert, wenn es geöffnet wird, und die Liste der verfügbaren Benutzer wiederholt sich beim Scrollen.

Füge Menüoptionen hinzu

Sobald aktiviert, können Erfahrungsbezogene Aktionen zum ACM hinzugefügt werden.Zum Beispiel kann ein Erlebnis Handelsanfragen, Erweiterungsoptionen oder andere spezielle Interaktionen zulassen.

Das folgende Beispiel zeigt, wie man eine benutzerdefinierte Aktion zum Avatar-Kontextmenü hinzufügt:

local Players = game:GetService("Players")
local StarterGui = game:GetService("StarterGui")
local player = Players.LocalPlayer

-- Verbinde eine Funktion mit einem "BindableEvent"
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
	-- An dieser Stelle könnten Sie InvokeServer() auf eine Remotefunktion aufrufen, um den Server über die Auswahl zu informieren
	print("ACM event selected by " .. player.Name .. " on " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)

-- Füge die ACM-Option mit SetCore() hinzu, mit "AddAvatarContextMenuOption"
local options = {"Custom ACM Action", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)

Menüoptionen entfernen

Du kannst benutzerdefinierte und die Standardoption "Freund hinzufügen, Chat, anzeigen und winken" vom ACM entfernen, indem du den benutzerdefinierten Aktionsnamen oder die Standardoption Enum.AvatarContextMenuOption enum referenzierst.

Verwende den folgenden Code, um eine Standard- und benutzerdefinierte Menüoption zu entfernen:

-- Entferne die Option "Benutzerdefinierte ACM-Aktion"
StarterGui:SetCore("RemoveAvatarContextMenuOption", "Custom ACM Action")

-- Entferne die Standardoption "Freund" durch Bezugnahme auf die AvatarContextMenuOption.Friend Enum
StarterGui:SetCore("RemoveAvatarContextMenuOption", Enum.AvatarContextMenuOption.Friend)

Menüaussehen Aussehen

Um das Aussehen des Avatar-Kontextmenüs zu ändern, rufe StarterGui:SetCore() mit der Option "AvatarContextMenuTheme" auf, die einen Tisch von Parametern und Werten bietet, um das Menüaussehen anzupassen.

Die ACM-Benutzeroberfläche enthält die folgenden Abschnitte:

A. Namensschild: Der Benutzername des Charakters, mit dem interagiert wird.

B. Button-Frame: Enthält alle ACM-Buttons.

C. Schaltflächen: Einzelne Schaltflächen für die Standard- oder benutzerdefinierten ACM-Aktionen.

Aussehensparameter

Dies sind die Anpassungsparameter mit dem ACM:

Hintergrund

Namensschild

Knopfrahmen

Taste

Text

Verschiedene Bilder

Ausgewählter Charakter

Größe und Position

Beispielanpassung

Das folgende Codebeispiel passt das ACM-Thema mit einigen grundlegenden Parametern an:

local StarterGui = game:GetService("StarterGui")

StarterGui:SetCore("AvatarContextMenuTheme", {
	BackgroundImage = "",
	BackgroundTransparency = 0.5,
	BackgroundColor = Color3.fromRGB(111, 145, 242),
	NameTagColor = Color3.fromRGB(0, 0, 200),
	NameUnderlineColor = Color3.fromRGB(213, 233, 255),
	ButtonFrameColor = Color3.fromRGB(15, 24, 65),
	ButtonFrameTransparency = 0.2,
	ButtonUnderlineColor = Color3.fromRGB(213, 233, 255),
	Font = Enum.Font.SciFi
})