El menú contextual del avatar (ACM) facilita que los usuarios interactúen entre sí. Cuando el ACM está habilitado en tu juego, un usuario puede acercarse al personaje de otro usuario y hacer clic en él para abrir un pequeño menú con varias opciones predeterminadas. El jugador puede enviar una solicitud de amistad, comenzar un chat privado, ver el perfil del usuario o saludar.
Después de habilitar el ACM en tu juego, puedes personalizar el ACM de las siguientes maneras:
- Programáticamente abrir y cerrar el ACM para usuarios específicos.
- Personalizar la apariencia del ACM para crear una interfaz de usuario única.
Habilitar el menú contextual del avatar
El menú contextual del avatar debe ser habilitado utilizando la opción StarterGui:SetCore() "AvatarContextMenuEnabled" en un LocalScript. El ACM se utiliza mejor en juegos donde no hay un comportamiento predefinido al hacer clic en otros usuarios.
Usa el siguiente ejemplo de código para habilitar el ACM en un LocalScript:
Si necesitas detectar si el ACM está habilitado, puedes usar el siguiente código para devolver un booleano sobre el estado actual del ACM:
Abrir y cerrar el ACM
Una vez habilitado, puedes abrir y cerrar el ACM programáticamente con StarterGui.
Para abrir programáticamente el ACM, usa el siguiente código:
Para cerrar programáticamente el ACM, usa el siguiente código:
Opciones del menú
Puedes agregar y eliminar acciones a través de scripting. Por defecto, el menú tiene las siguientes opciones:
| Opción del menú | Descripción |
|---|---|
| Amigo | Envía una solicitud de amistad al usuario seleccionado. |
| Chat | Abre una conversación privada con el usuario seleccionado en el chat del juego. |
| Ver | Abre una ventana para inspeccionar la apariencia del usuario seleccionado. |
| Saludar | Inicia una animación de saludo hacia el usuario seleccionado. |
Una vez que el ACM esté abierto, el usuario puede desplazarse y seleccionar otros usuarios en el carrusel de selección de personajes. Los personajes se ordenan en función de la distancia al personaje seleccionado. El menú solo se actualiza cuando se abre y la lista de usuarios disponibles se repetirá al desplazarse.
Agregar opciones al menú
Una vez habilitado, se pueden agregar acciones específicas del juego al ACM. Por ejemplo, un juego podría permitir solicitudes de intercambio, opciones para unirse a una fiesta u otras interacciones especiales.
El siguiente ejemplo muestra cómo agregar una acción personalizada al menú contextual del avatar:
local Players = game:GetService("Players")
local StarterGui = game:GetService("StarterGui")
local player = Players.LocalPlayer
-- Conectar una función a un "BindableEvent"
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
-- En este punto, podrías llamar a InvokeServer() en un RemoteFunction para alertar al servidor sobre la selección
print("Evento del ACM seleccionado por " .. player.Name .. " en " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)
-- Agrega la opción del ACM usando SetCore() con "AddAvatarContextMenuOption"
local options = {"Acción personalizada de ACM", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)
Eliminar opciones del menú
Puedes eliminar opciones personalizadas y las opciones predeterminadas de Agregar amigo, Chat, Ver y Saludar del ACM haciendo referencia al nombre de la acción personalizada o al enum predeterminado Enum.AvatarContextMenuOption.
Usa el siguiente código para eliminar una opción de menú predeterminada y personalizada:
No puedes hacer modificaciones al ACM mientras esté abierto. Tu código debe verificar que una acción siga siendo relevante en caso de que la acción haya sido eliminada del menú. Por ejemplo, si un área del mercado agrega una opción para enviar solicitudes de intercambio, debes verificar que ambos usuarios sigan en el mercado.
Personalizar la apariencia del menú
Para cambiar la apariencia del menú contextual del avatar, llama a StarterGui:SetCore() con la opción "AvatarContextMenuTheme", proporcionando una tabla de parámetros y valores para ajustar la apariencia del menú.
La interfaz de usuario del ACM incluye las siguientes secciones:
A. Etiqueta de nombre: El nombre del usuario del personaje con el que se está interactuando.
B. Marco de botones: Contiene todos los botones del ACM.
C. Botones: Botones individuales para las acciones predeterminadas o personalizadas del ACM.
Parámetros de apariencia
Estos son los parámetros de personalización del ACM:
Fondo
| BackgroundColor | Un Color3 para el fondo general del ACM (más útil cuando no se usa una imagen de fondo). |
| BackgroundTransparency | Valor de transparencia (0–1) para el fondo general del ACM (más útil cuando no se usa una imagen de fondo). |
| BackgroundImage | Un ID de activo válido de una imagen para el fondo del ACM. |
| BackgroundImageTransparency | Valor de transparencia (0–1) para la imagen de fondo. |
| BackgroundImageScaleType | Un enum Enum.ScaleType para el escalado de la imagen de fondo. |
| BackgroundImageSliceCenter | Un Rect que especifica el centro de una imagen de nueve partes cuando BackgroundImageScaleType está configurado como Enum.ScaleType.Slice. |
Etiqueta de nombre
| NameTagColor | Un Color3 para la barra que muestra qué jugador se está interactuando. |
| NameUnderlineColor | Un Color3 para la línea delgada entre la etiqueta de nombre y los botones de acción. |
Marco de botones
| ButtonFrameColor | Un Color3 para la sección (marco) que contiene los botones de acción. |
| ButtonFrameTransparency | Valor de transparencia (0–1) para la sección del marco de botones. |
Botón
| ButtonColor | Un Color3 para el fondo de los botones de acción del ACM. |
| ButtonTransparency | Valor de transparencia (0–1) para el color de fondo de los botones de acción. |
| ButtonHoverColor | Un Color3 para el estado de "sobre" de los botones de acción. |
| ButtonHoverTransparency | Valor de transparencia (0–1) para el color de "sobre" de los botones de acción. |
| ButtonUnderlineColor | Un Color3 para la línea delgada que separa cada botón de acción. |
| ButtonImage | Un ID de activo válido de una imagen para el fondo de los botones. |
| ButtonImageScaleType | Un enum Enum.ScaleType para el escalado de la imagen del botón. |
| ButtonImageSliceCenter | Un Rect que especifica el centro de una imagen de nueve partes cuando ButtonImageScaleType está configurado como Enum.ScaleType.Slice. |
Texto
| Font | Un valor enum Enum.Font para la etiqueta de nombre y el texto de los botones. |
| TextColor | Un Color3 para todo el texto dentro del ACM. |
| TextScale | Un valor float para escalar los tamaños de texto predeterminados de cada elemento. |
Varios imágenes
| LeaveMenuImage | Un ID de activo de una imagen para el botón de cerrar el ACM. |
| ScrollLeftImage | Un ID de activo de una imagen para el botón de "desplazar a la izquierda" del carrusel. |
| ScrollRightImage | Un ID de activo válido de una imagen para el botón de "desplazar a la derecha" del carrusel. |
Personaje seleccionado
| SelectedCharacterIndicator | El MeshPart que flota sobre la cabeza de un personaje para indicar que está seleccionado. |
Tamaño y posición
| Size | Un UDim2 para el tamaño total del ACM. |
| MinSize | Un Vector2 que especifica el tamaño mínimo del ACM. |
| MaxSize | Un Vector2 que especifica el tamaño máximo del ACM. |
| AspectRatio | Un valor float que especifica la relación de ancho y alto del ACM. |
| AnchorPoint | El AnchorPoint del ACM. |
| OnScreenPosition | Un UDim2 que especifica la posición en pantalla del ACM (la posición a la que se anima cuando se abre). |
| OffScreenPosition | Un UDim2 que especifica la posición fuera de pantalla del ACM (la posición de la que se anima cuando se abre/cierra). |
Ejemplo de personalización
El siguiente ejemplo de código personaliza el tema del ACM utilizando algunos parámetros básicos:
