Avatar Konteyner Menüsü

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Avatar Konteyner Menüsü (ACM) kullanıcıların birbirleriyle etkileşim kurmasını kolaylaştırır. ACM'nin deneyiminizde etkinleştirildiğinde, bir kullanıcı başka bir kullanıcın karakterine yürüyebilir ve onlara açılır bir menüyü göstermek için tıklayabilir. Oyuncu bir

Deneyiminizdeki ACM'yi etkinleştirdikten sonra, ACM'yi şu şekilde özelleştirebilirsiniz:

Avatar Konteyner Menüsü'nü Etkinleştirme

Avatar Konteyner Menüsü, StarterGui:SetCore() seçeneğini kullanarak etkinleştirilmelidir "AvatarContextMenuEnabled" bir LocalScript içinde. ACM, diğer kullanıcıları tıklamak için önceden tanımlanmış davranış yokken kullanılır.

Aşağıdaki kod örneğini kullanarak ACM'yi bir LocalScript içinde etkinleştirin:


-- YerelScript içinde, ideal olarak "StarterPlayerScripts" içinde çalıştırılır
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuEnabled", true)

ACM'nin etkinleştirilip etkinleştirilmediğini algılamanız gerekirse, aşağıdaki kodu kullanarak ACM'nin mevcut durumunda bir boşluk döndürebilirsiniz:


--ACM'nin şu anda etkinleştirilmiş olup olmadığını gösteren bir boşaltma döndürür.
StarterGui:GetCore(AvatarContextMenuEnabled)

ACM'yi Açılıp Kapatılması

Etkinleştirildiğinde, ACM programını StarterGui ile programal olarak açıp kapatabilirsiniz.

ACM'yi programlama olarak açmak için şu kodu kullanın:


-- HedefPlayer geçerli bir Oyuncu nesnesi olduğunda StarterGui:SetCore'yi kullanın
StarterGui:SetCore("AvatarContextMenuTarget", targetPlayer)

ACM'yi programlama olarak kapatmak için şu kodu kullanın:


StarterGui:SetCore("AvatarContextMenuTarget", nil)

Menü Seçenekleri

Eylemleri eklemek ve kaldırmak işlemlerini kullanarak ekleyebilir ve 2>kaldırebilirsiniz2>.Varsayılan olarak, menünün şu seçenekleri vardır:

Menü SeçeneğiAçıklama
ArkadaşSeçili kullanıcıya bir arkadaş isteği gönderir.
SohbetSeleksiyon kullanıcısının deneyim içindeki özel bir sohbeti açar.
GörüntüSeçili kullanıcının görünümünü incelemek için bir pencere açar.
DalgaSeçili kullanıcıya bir dalga animasyonu başlatır.

ACM açıldığında, kullanıcı karakter seçme aracındaki diğer kullanıcıları kaydırabilir ve seçebilir. Karakterler, seçilen karaktere olan mesafeye göre sıralanır. Menü sadece açıldığında güncellenir ve mevcut kullanıcılar listesi kaydırılır.

Menü Seçenekleri Ekleme

Etkinleştirildiğinde, deneyim özgürlükçi eylemleri ACM'ye eklenebilir. Örneğin, bir deneyim takas isteklerine, eklenmeyi, veya diğer özel etkileşimleri sağlayabilir.

Aşağıdaki örnek, Avatar Konteyner Menüsü'ne bir özel eylem eklemek için nasıl:


local Players = game:GetService("Players")
local StarterGui = game:GetService("StarterGui")
local player = Players.LocalPlayer
-- Bir "BindableEvent" e işlev bağlayın
local bindableEvent = Instance.new("BindableEvent")
local function onCustomACMAction(targetPlayer)
-- Bu noktada, InvokeServer()'ı bir uzaktan işlevi arayarak seçimciyi uyandırabilirsiniz
print("ACM event selected by " .. player.Name .. " on " .. targetPlayer.Name)
end
bindableEvent.Event:Connect(onCustomACMAction)
-- SetCore() kullanarak "AddAvatarContextMenuOption" ile "AddAvatar" seçeneğini ekleyin
local options = {"Custom ACM Action", bindableEvent}
StarterGui:SetCore("AddAvatarContextMenuOption", options)

Menü Seçeneklerini Kaldırma

Özelleştirilmiş ve varsayılan "Arkadaş Ekleme" "Sohbet Görüntüleme" "Gelmeyi Görüntüleme" ve "Dalga" seçeneklerini ACM'den kaldırabilirsiniz, böylece özelleştirilmiş "Eylem Adı" veya varsayılan "Enum.AvatarContextMenuOption" enemuabını referans ederek.

Aşağıdaki kodu kullanarak bir varsayılan ve özelleştirilmiş menü seçeneğini kaldırın:


-- “Özel ACM Eylemi” seçeneğini kaldır
StarterGui:SetCore("RemoveAvatarContextMenuOption", "Custom ACM Action")
-- AvatarContextMenuOption.Friend Enum'i referans alarak varsayılan "Arkadaş" seçeneğini kaldır
StarterGui:SetCore("RemoveAvatarContextMenuOption", Enum.AvatarContextMenuOption.Friend)

Menü Görünümü Özelleştirme

Avatar Konteyner Menüsünün Görünümünü Değiştirmek için, StarterGui:SetCore() ile şu seçeneği çağırın "AvatarContextMenuTheme", bir tabloda parametreleri ve değerleri ayarlayarak menü görünümünü ayarlayın.

ACM kullanıcı arayüzü aşağıdaki bölümleri içerir:

A. İsim Etiketi: Etkileşimde olan karakterin kullanıcı adı.

B. Buton Çerçevesi: Tüm ACM düğmelilerini içerir.

C. Butonlar: Standart veya özel ACM eylemleri için bireysel butonlar.

Görünüm Parçaları

Bunlar ACM ile ilgili özelleştirme parametreleridir:

Arka Plan

Arka Plan RengiACM'nin genel arka planı için bir Color3 .
Arka PlanTransparansıACM'nin genel arka planı için (bir arka plan görüntüsü kullanmadığınızda en yararlı) transparans değeri (0-1).
Hayalet EğitimiACM arka planı için bir görüntünün geçerli bir varlık kimliği.
Arka Plan GörünürlüğüYan ışınlanma için kapasite (0-1).
BackgroundImageScaleTypeBir Enum.ScaleType enümü için arka plan görüntüsü ölçeği.
BackgroundImageSliceCenterBackgroundImageScaleType Rect ile yapılandırıldığında dokuz bölümlü bir görüntünün merkezini belirtir.

İsim Etiketi

İsim Etiket RengiEtkileşimde bulunulan oyuncuya gösterilen bir Color3 .
İsimAltıRenkİsim etiketi ile eylem düğmeleri arasındaki ince çizgi için bir Color3.

Buton Çerçevesi

ButonRenkEylem düğmeleri içeren bir bölüm (Frame) için bir Color3 .
Buton Çerçevesi SaydamlığıButon kafesi bölümü için görünürlük değeri (0-1).

Buton

ButonRenkACM eylem düğmelilerinin arka planı için bir Color3 .
ButonTransparencyEylem düğmelerinin arka plan rengi için (0-1) saydamlık değeri.
ButonHoverRenkEylem düğmeliğinin "hoşluk" durumu için bir Color3 .
ButonHoverTransparencyEylem düğmeli renklerinin "hoş" rengi için (0-1) saydamlık değeri.
Buton Hatlı RenkHer eylem butonunu ayrılayan ince çizgi için bir Color3.
ButonResmiButonların arka planı için bir resimde geçerli bir varlık kimliği.
ButtonImageScaleTypeButon resim boyutlandırması için bir Enum.ScaleType uzantı.
ButonResimAlanıOrtasıButtonImageScaleType Rect olarak ayarlandığında dokuz bölümlü bir görüntünün merkezini belirten bir Enum.ScaleType.Slice .

Metin

YazıBir Enum.Font kimlik etiketi ve buton metni için bir kıymet değeri.
MetniRenkBir Color3 için tüm metinler ACM içinde.
Metin ÖlçeğiHer öğenin varsayılan metin boyutlarını artırmak için bir float değeri.

Çeşitli Görüntü

MenüGörüntüsünüBırakACM kapatma düğmesi için bir görüntünün kaynağı.
Yatay Scroll KızılımOto döndürme " sol " düğmesi için bir görüntü ID'si.
YüzdeğiştirmeOtobüs "sağa kaydır" düğmesi için bir resimde geçerli bir varlık kimliği.

Seçilmiş Karakter

SeçilmişKarakterGöstergesiSeçildiğini göstermek için bir karakterin kafasının üzerinde flot eden MeshPart .

Boyut ve Konum

BoyutACM'nin genel büyüklüğü için bir UDim2 .
MinBoyutBir ACM'nin minimum büyüklüğünü belirten bir Vector2 özelliği.
Maksimum BoyutBir Vector2 , ACM'nin maksimum boyutunu belirtir.
Yüz OranıACM'nin relatif genişliğini ve yüksekliğini belirten bir float değeri.
Anka NoktasıACM'nin AnchorPoint 'i.
Ekran PuanıA UDim2 ACM'nin ekran pozisyonunu belirtir (açıldığında genç olduğu pozisyon).
Ekran Dışındaki KonumBir UDim2 ACM'nin kapalı/açık olduğu pozisyonunu belirtir (açıldığında/susulduğunda eğilmez/geçmez).

Örnek Özelleştirme

Aşağıdaki kod örneği, bazı temel parametreleri kullanarak ACM temasını özelleştirir:


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