Avatar Kontextmenü

Das Avatar-Kontextmenü (ACM) macht es einfacher für Benutzer, miteinander zu interagieren. Wenn das ACM in deiner Erlebnisaktiviert ist, kann ein Benutzer bis zu einem anderen Benutzer gehen und auf ihn klicken, um ein kleines Menü mit mehreren Standardoptionen zu öffnen. Der Spieler kann eine Anfragesenden, einen privaten Chat beginnen oder das Profilanzeigen oder auf Welle.

Nachdem du den ACM in deiner Erlebnisaktiviert hast, kannst du den ACM wie folgt anpassen:

• Programmieren Sie öffnen und schließen Sie die ACM für bestimmte Benutzer.
• Hinzufügen benutzerdefinierte Optionen und entfernen bestehende Optionen zum ACM.
• Anpassen Sie die ACM-Erscheinung, um eine einzigartige Benutzeroberfläche zu erstellen.

Aktivierung des Avatar-Kontextmenüs

Das Avatar-Kontextmenü muss mit der Option StarterGui:SetCore() aktiviert werden, die in einem LocalScript den ACM am besten verwendet wird.

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

-- Lauf in einem lokalen Skript, idealerweise innerhalb von "StarterPlayerScripts"
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

Wenn Sie überprüfen müssen, ob die ACM aktiviert ist, können Sie den folgenden Code verwenden, um eineBoolean auf dem aktuellen Status der ACM zurückzugeben:

--– gibt zurück, ob die ACM aktuell aktiviert ist.
StarterGui:GetCore(AvatarContextMenuEnabled)

Eröffnen und Schließen des ACM

Sobald aktiviert, kannst du das ACM-Programm mit StarterGui programmieren öffnen und schließen.

Um das ACM programmmatisch zu öffnen, verwenden Sie den folgenden Codes:

-- Verwenden Sie StarterGui:SetCore, wenn targetPlayer ein gültiges Objektist
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

Um das ACM programmierungsgemäß zu schließen, verwenden Sie den folgenden Codes:

StarterGui:SetCore("AvatarContextMenuTarget", nil)

Menüoptionen

Du kannst Hinzufügen und Entfernen Aktionen durch Scriptinghinzufügen. Standardmäßig hat das Menü die folgenden Optionen:

Sobald der ACM geöffnet ist, kann der Benutzer die Charaktere auswählen und andere Benutzer auf der Charakterauswahl-Karussell. Die Charaktere werden basierend auf der Entfernung zum ausgewählten Charakter sortiert. Das Menü wird nur aktualisiert, wenn es geöffnet ist, und die Liste der verfügbaren Benutzer wird beim Scrollen wiederholt.

Menüoptionen hinzufügen

Nach dem Aktivieren können Erlebnisse spezifische Aktionen dem ACM hinzugefügt werden. Zum Beispiel kann ein Erlebnis Anfragen für den Handel, Add-to-Party-Optionen oder andere Spezialinteraktionen ermöglichen.

Das folgende Beispiel zeigt, wie Sie einen benutzerdefinierten Aktion hinzufügen zum Avatar Kontext Menü:

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

-- Verbinden Sie eine Funktion mit einem "Bindbaren Ereignis"
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
	-- An diesem Punkt könnte Sie InvokeServer() auf eine RemoteFunction aufrufen, um den Server der Auswahl zu alarmieren
	print("ACM event selected by " .. player.Name .. " on " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)

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

Menüoptionen entfernen

Du kannst benutzerdefinierte und Standard-Freund, Chat, Ansicht und Welle-Optionen vom ACM entfernen, indem du auf den benutzerdefinierten Aktionsnamen oder das Standard- Enum.AvatarContextMenuOption -Ensemble verweist.

Verwenden Sie den folgenden Code, um eine Standard- und Benutzerdefinierungsmenüoption zu entfernen:

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

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

Menü-Erscheinung anpassen

Um das Aussehen des Avatar-Kontextmenüs zu ändern, rufen Sie StarterGui:SetCore() mit der Option "AvatarContextMenuTheme" auf, mit der Sie eine Tabelle von Parametern und Werten bereitstellen, um die Menü-Ansicht anzupassen.

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

A. Namens-Tag: Der Nutzername des Charakters, mit dem interagiert wird.

B. Button-Rahmen: Enthält alle ACM-Schaltflächen.

C. Buttons: Einzelne Schaltflächen für Standard- oder Benutzerdefinierte Aktionen.

Ausse参数

Dies sind die Anpassungsparameter mit dem ACM:

Hintergrund

Namensschild

Button-Rahmen

Taste

Text

Verschiedene Bilder

Ausgewählter Charakter

Größe und Position

Beispielanpassung

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

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
})