Menu de contexto de avatar

O Menu de contexto de avatar (ACM) torna mais fácil para os usuários interagirem uns com os outros.Quando o ACM é ativado em sua experiência, um usuário pode caminhar até o personagem de outro usuário e clicar nele para abrir um pequeno menu com várias opções padrão.O jogador pode enviar um solicitar / pedirde amizade, iniciar um chat privado, visualizar o perfil do usuário ou saudar.

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

• Programaticamente abra e feche o ACM para usuários específicos.
• Adicione opções personalizadas e remova opções existentes para o ACM.
• Personalize a aparência do ACM para criar uma interface de usuário única.

Ativar o Menu de Contexto do Avatar

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

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

-- Correr 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 sobre o status atual do ACM:

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

Abra e feche o ACM

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

Para abrir o ACM de forma programática, use o seguinte código:

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

Para fechar o ACM programaticamente, 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 no carrossel 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 se repetirá ao rolar.

Adicionar 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 troca, opções de adicionar ao 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ê poderia 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)

Remover opções de menu

Você pode remover opções personalizadas e padrão de Adicionar Amigo, chat/conversa, Ver e Onda da ACM referenciando o nome de ação personalizado ou o padrão Enum.AvatarContextMenuOption enum.

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

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

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

Personalize 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 de usuário do ACM inclui as seguintes seções:

A. Etiqueta de Nome: O nome do usuário do personagem com o qual está sendo interagido.

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

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

Plano de fundo

Tag de nome

Armação de botão

Botão

Texto

Várias imagens

Personagem selecionado

Tamanho e posição

Exemplo de personalização

O seguinte exemplo de código 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
})