アバターコンテキストメニュー

アバターコンテキストメニュー ACM (ACM) は、ユーザーが互いに交流するのを簡単にしますACM がエクスペリエンスで有効になっていると、ユーザーは他のユーザーのキャラクターまで歩いて行き、クリックして小さなメニューを開き、複数のデフォルトオプションを開くことができます。プレイヤーは友達リクエストを送信し、プライベートチャットを開始し、ユーザーのプロフィールを表示するか、ウェーブを送信することができます。

エクスペリエンスで ACM を有効にした後、次の方法で ACM をカスタマイズできます:

• プログラマティックに 特定のユーザーのためにACMを開いて閉じる。
• カスタムオプションを追加 および 既存のオプションを ACM から削除 します。
• ACM の外観をカスタマイズして、ユニークなユーザーインターフェイスを作成する

アバターコンテキストメニューを有効にする

アバターコンテキストメニューは、StarterGui:SetCore() オプション「AvatarContextMenuEnabled」を使用して、LocalScript で有効にする必要があります。ACM は、他のユーザーをクリックするための事前定義された動作がないエクスペリエンスで最もよく使用されます。

次のコードサンプルを使用して、LocalScript に ACM を有効にします：

-- ローカルスクリプトで実行、理想的には「StarterPlayerScripts」内
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

ACM が有効になっているかどうかを検出する必要がある場合は、次のコードを使用して ACM の現在の状態について boolean を返すことができます：

--ACM が現在有効になっているかどうかを示すブールを返します。
StarterGui:GetCore(AvatarContextMenuEnabled)

ACM を開いて閉じる

有効になったら、StarterGui でプログラマティックに ACM プログラムを開いて閉じることができます。

ACM をプログラムで開くには、次のコードを使用してください：

-- スターターGUIを使用:ターゲットプレイヤーが有効なプレイヤーオブジェクトである場合、SetCore を使用
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

ACM をプログラムで閉じるには、次のコードを使用してください：

StarterGui:SetCore("AvatarContextMenuTarget", nil)

メニューオプション

スクリプトで 追加 と 削除 アクションをスクリプト作成うことができます。デフォルトでは、メニューに次のオプションがあります：

ACM が開いたら、ユーザーはキャラクター選択カルーセルで他のユーザーをスクロールして選択できます。キャラクターは、選択したキャラクターへの距離に基づいて並べ替えられます。メニューは開いたときにのみ更新され、利用可能なユーザーのリストはスクロールすると繰り返されます。

メニューオプションを追加

有効になったら、経験に特有のアクションを ACM に追加できます。たとえば、エクスペリエンスは、取引リクエスト、パーティーへの追加オプション、または他の特別な相互作用を許可する可能性があります。

次の例では、アバターコンテキストメニューにカスタムアクションを追加する方法を示します：

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

-- 機能を "BindableEvent" に接続する
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
	-- この時点で、リモート関数に InvokeServer() を呼び出して、サーバーに選択を通知することができます
	print("ACM event selected by " .. player.Name .. " on " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)

-- SetCore() を使用して「AddAvatarContextMenuOption」で ACM オプションを追加
local options = {"Custom ACM Action", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)

メニューオプションを削除

アクション名またはデフォルトの Enum.AvatarContextMenuOption 枚数を参照して、カスタムとデフォルトの友達追加、チャット、表示、およびウェーブオプションを ACM から削除できます。

次のコードを使用して、デフォルトとカスタムメニューオプションを削除します：

-- 「カスタム ACM アクション」オプションを削除
StarterGui:SetCore("RemoveAvatarContextMenuOption", "Custom ACM Action")

-- AvatarContextMenuOption.Friend Enum を参照してデフォルトの「友達」オプションを削除する
StarterGui:SetCore("RemoveAvatarContextMenuOption", Enum.AvatarContextMenuOption.Friend)

メニューの外外見をカスタマイズ

アバターコンテキストメニューの外観を変更するには、StarterGui:SetCore() オプション「AvatarContextMenuTheme」を呼び出し、メニューの外外見を調整するパラメータと値のテーブルを提供します。

ACM ユーザーインターフェイスには次のセクションが含まれています：

A. 名前タグ: 対話するキャラクターのユーザー名。

B. ボタンフレーム: ACMボタンのすべてを含む。

C. ボタン: デフォルトまたはカスタム ACM アクションの個々のボタン。

外観パラメータ

これらは ACM とのカスタマイズパラメータです：

バックグランド

名前タグ

ボタンフレーム

ボタン

テキスト

様々な画像

選択されたキャラクタ

サイズと位置

カスタマイズの例

次のコードサンプルは、いくつかの基本パラメータを使用して ACM テーマをカスタマイズします：

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