Menu Konteks Avatar

Menu Konteks Avatar (ACM) memudahkan pengguna untuk berinteraksi satu sama lain. Ketika ACM diaktifkan dalam permainan Anda, seorang pengguna dapat mendekati karakter pengguna lain dan mengkliknya untuk membuka menu kecil dengan beberapa opsi default. Pemain dapat mengirim permintaan pertemanan, memulai obrolan pribadi, melihat profil pengguna, atau melambaikan tangan.

Setelah mengaktifkan ACM dalam permainan Anda, Anda dapat menyesuaikan ACM dengan cara berikut:

• Secara programatik membuka dan menutup ACM untuk pengguna tertentu.
• Menambahkan opsi khusus dan menghapus opsi yang ada dari ACM.
• Menyesuaikan penampilan ACM untuk membuat antarmuka pengguna yang unik.

Mengaktifkan Menu Konteks Avatar

Menu Konteks Avatar harus diaktifkan menggunakan opsi StarterGui:SetCore() "AvatarContextMenuEnabled" dalam LocalScript. ACM paling baik digunakan dalam permainan di mana tidak ada perilaku yang telah ditentukan untuk mengklik pengguna lain.

Gunakan contoh kode berikut untuk mengaktifkan ACM dalam LocalScript:

-- Jalankan dalam LocalScript, idealnya di dalam "StarterPlayerScripts"
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

Jika Anda perlu mendeteksi apakah ACM diaktifkan, Anda dapat menggunakan kode berikut untuk mengembalikan boolean tentang status saat ini dari ACM:

---Mengembalikan boolean yang menunjukkan apakah ACM saat ini diaktifkan.
StarterGui:GetCore(AvatarContextMenuEnabled)

Membuka dan menutup ACM

Setelah diaktifkan, Anda dapat membuka dan menutup ACM secara programatik menggunakan StarterGui.

Untuk membuka ACM secara programatik, gunakan kode berikut:

-- Gunakan StarterGui:SetCore di mana targetPlayer adalah objek Pemain yang valid
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

Untuk menutup ACM secara programatik, gunakan kode berikut:

StarterGui:SetCore("AvatarContextMenuTarget", nil)

Opsi menu

Anda dapat menambahkan dan menghapus tindakan melalui pemrograman. Secara default, menu memiliki opsi berikut:

Setelah ACM dibuka, pengguna dapat menggulir dan memilih pengguna lain di karusel pemilihan karakter. Karakter diurutkan berdasarkan jarak ke karakter yang dipilih. Menu hanya diperbarui saat dibuka dan daftar pengguna yang tersedia akan diulang saat menggulir.

Menambahkan opsi menu

Setelah diaktifkan, tindakan khusus untuk permainan dapat ditambahkan ke ACM. Misalnya, sebuah permainan mungkin memungkinkan permintaan perdagangan, opsi tambahkan ke pesta, atau interaksi khusus lainnya.

Contoh berikut menunjukkan cara menambahkan tindakan khusus ke Menu Konteks Avatar:

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

-- Menghubungkan fungsi ke "BindableEvent"
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
	-- Pada tahap ini, Anda bisa memanggil InvokeServer() pada RemoteFunction untuk memberi tahu server tentang pemilihan
	print("ACM event dipilih oleh " .. player.Name .. " pada " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)

-- Tambahkan opsi ACM menggunakan SetCore() dengan "AddAvatarContextMenuOption"
local options = {"Aksi ACM Kustom", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)

Menghapus opsi menu

Anda dapat menghapus opsi kustom dan default Tambah Teman, Obrolan, Lihat, dan Wave dari ACM dengan merujuk pada nama Aksi kustom atau enum default Enum.AvatarContextMenuOption.

Gunakan kode berikut untuk menghapus opsi menu default dan kustom:

-- Hapus opsi "Aksi ACM Kustom"
StarterGui:SetCore("RemoveAvatarContextMenuOption", "Aksi ACM Kustom")

-- Hapus opsi default "Teman" dengan merujuk pada Enum AvatarContextMenuOption.Friend
StarterGui:SetCore("RemoveAvatarContextMenuOption", Enum.AvatarContextMenuOption.Friend)

Menyesuaikan penampilan menu

Untuk mengubah penampilan Menu Konteks Avatar, panggil StarterGui:SetCore() dengan opsi "AvatarContextMenuTheme", menyediakan tabel parameter dan nilai untuk menyesuaikan penampilan menu.

Antarmuka pengguna ACM mencakup bagian berikut:

A. Nama Tag: Nama pengguna dari karakter yang sedang berinteraksi.

B. Kerangka Tombol: Berisi semua tombol ACM.

C. Tombol: Tombol individu untuk tindakan ACM default atau kustom.

Parameter penampilan

Ini adalah parameter penyesuaian dengan ACM:

Latar Belakang

Nama tag

Kerangka tombol

Tombol

Teks

Gambar berbagai

Karakter terpilih

Ukuran dan posisi

Contoh penyesuaian

Contoh kode berikut menyesuaikan tema ACM menggunakan beberapa parameter dasar:

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