Menu de contexto de avatar

O Menu de Conjunto de Avatar (ACM) facilita a interação entre usuários. Quando o ACM estiver ativado na sua experiência, um usuário pode caminhar até outro usuário's personagem e clicar nele para abrir um pequeno menu com várias opções padrão. O jogador pode enviar uma solicitar / pedirde amigo, iniciar uma conversa privada ou ver o perfil do usuário. O jogador pode enviar uma solicitação de onda.

Depois de habilitar o ACM em sua experiência, você pode personalizar o ACM da seguinte maneira:

• Programaticamente aberto e fechado o ACM para usuários específicos.
• Adicionar opções personalizadas e remover as opções existentes para o ACM.
• Personalize a aparência do ACM para criar uma interface de usuário única.

Habilitando o Menu de Contexto de Avatar

O Menu de Contexto do Avatar deve ser habilitado usando a opção StarterGui:SetCore() "AvatarContextMenuEnabled" em um LocalScript . O ACM é melhor usado em experiências onde não há comportamento predefinido para clicar em outros usuários.

Use o seguinte código de exemplo para habilitar o ACM em um LocalScript :

-- Execute em um LocalScript, idealmente dentro de "StarterPlayerScripts"
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

Se você precisar detectar se o ACM está habilitado, você pode usar o seguinte código para retornar um booleano no status atual do ACM:

--Retorna um boolo indicando se o ACM está atualmente habilitado.
StarterGui:GetCore(AvatarContextMenuEnabled)

Abrindo e Fechando o ACM

Uma vez ativado, você pode abrir e fechar o programa ACMaticamente com StarterGui .

Para abrir programaticamente o ACM, use o seguinte código:

-- Use StarterGui:SetCore onde o targetPlayer é um Objetode Jogador válido
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

Para fechar programaticamente o ACM, use o seguinte código:

StarterGui:SetCore("AvatarContextMenuTarget", nil)

Opções de Menu

Você pode adicionar e remover ações através de scripting. Por padrão, o menu tem as seguintes opções:

Uma vez que o ACM está aberto, o usuário pode rolar e selecionar outros usuários na roda de seleção de personagens. Os personagens são classificados com base na distância para o personagem selecionado. O menu só é atualizado quando aberto e a lista de usuários disponíveis será repetida ao rolar.

Adicionando Opções de Menu

Uma vez ativado, ações específicas de experiência podem ser adicionadas ao ACM. Por exemplo, uma experiência pode permitir solicitações de comércio, opções de grupo ou outras interações especiais.

O seguinte exemplo mostra como adicionar uma ação personalizada ao Menu de Contexto do Avatar:

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

-- Conecte uma função a um "BindableEvent"
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
	-- Neste ponto, você pode chamar InvokeServer() em uma Função Remota para alertar o servidor da seleção
	print("ACM event selected by " .. player.Name .. " on " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)

-- Adicione a opção ACM usando SetCore() com "AddAvatarContextMenuOption"
local options = {"Custom ACM Action", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)

Removendo Opções de Menu

Você pode remover as opções de Adicionar Amigo, chat/conversa, Ver e Onda personalizadas do ACM ao referenciar o nome de ação personalizado ou o índice padrão Enum.AvatarContextMenuOption.

Use o seguinte código para remover uma opção de menu padrão e personalizado:

-- Remova a opção "Ação ACM Personalizada"
StarterGui:SetCore("RemoveAvatarContextMenuOption", "Custom ACM Action")

-- Remova a opção "Amigo" padrão ao referenciar o AvatarContextMenuOption.Friend Enum
StarterGui:SetCore("RemoveAvatarContextMenuOption", Enum.AvatarContextMenuOption.Friend)

Personalizando a Aparência do Menu

Para alterar a aparência do Menu de Contexto do Avatar, chame StarterGui:SetCore() com a opção "AvatarContextMenuTheme", fornecendo uma tabela de parâmetros e valores para ajustar a aparência do menu.

A interface do usuário da ACM inclui as seguintes seções:

A. Nome de Usuário: O nome do usuário com quem o personagem está interagindo.

B. Frame de Botão: Contém todos os botões ACM.

C. Botões: Botões individuais para as ações padrão ou personalizadas do ACM.

Parâmetros de Aparência

Esses são os parâmetros de personalização com o ACM:

Fundo

Nome de Tag

Armação de Botão

Botão

Texto

Várias Imagens

Personagem Selecionado

Tamanho e Posição

Exemplo de Personalização

O seguinte código de exemplo personaliza o tema ACM usando alguns parâmetros básicos:

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