İfade Çubuğu

Duygular herhangi bir sosyal deneyimin temel bir bileşenidir.The EmoteBar geliştirici modülü oyunculara anlamlı sosyal etkileşimleri kolaylaştırmak için erişilebilir, özelleştirilebilir bir yol sağlamayı hedefliyor.

Modül kullanımı

Yükleme

Bir deneyimde EmoteBar modülünü kullanmak için:

1. Görüntü sekmesinden açın Araç çantası ve Yaratıcı mağazası sekmesini seçin.

   

2. Modellerin sıralanması seçildiğinden emin olun, ardından Tümünü Görüntüle düğmesine tıklayın Kategoriler için >.

   

3. Yerini ve tıklayın Geliştirici Modülleri düğmesi.

   

4. ifade çubuğu modülünü bulun ve tıklayın veya 3B görüntüye sürükleyin ve bırakın.

   

5. Gezgini penceresinde, tüm EmoteBar modelini ServerScriptService ye taşıyın.Deneyimi çalıştırdıktan sonra, modül kendini çeşitli hizmetlere dağıtacak ve çalışmaya başlayacaktır.

   

Yapılandırma

Modül 7 emote ile önceden yapılandırılmıştır ve kendi emote ve görüntü seçeneklerinizle kolayca özelleştirilebilir.Ayrıca, oyuncu Lil Nas X, Royal Blood veya Twenty One Pilots gibi önceki Roblox etkinliklerinden herhangi bir emote sahipse, bu emoteler otomatik olarak mevcut emote listesine eklenecektir.

1. In ServerScriptService , yeni bir Script oluştur ve adını Emote Yapılandırma olarak değiştir.

   

2. Aşağıdaki kodu yeni ConfigureEmotes scriptine yapıştırın.The useDefaultEmotes ayarı false öntanımlı ifadeleri geçersiz kılar ve setEmotes işlevi aracılığıyla özel ifadeler tanımlamanıza izin verir.

   Script - ConfigureEmotes'u yapılandır
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
   
   EmoteBar.configureServer({
   	useDefaultEmotes = false,
   })
   
   EmoteBar.setEmotes({
   	{
   		name = "Hello",
   		animation = "rbxassetid://3344650532",
   		image = "rbxassetid://7719817462",
   		defaultTempo = 1,
   	},
   	{
   		name = "Applaud",
   		animation = "rbxassetid://5915693819",
   		image = "rbxassetid://7720292217",
   		defaultTempo = 2,
   	},
   })

Mega ifadeler

Aynı alandaki birden fazla oyuncu aynı emote'u aynı anda yaptığında bir mega ifade oluşur.Gittikçe daha fazla oyuncu katıldıkça, mega ifade daha da büyür.Oyuncular ifadeyi yapmayı bıraktığında, mega ifade sonunda kaybolana kadar daha küçük hale gelir.

Hız

Bir ifadenin ritmi düğmesine basıldığında oynadığı hızdır.Bir ifadenin varsayılan hızı, defaultTempo 'si tarafından belirlenir.Bir ifadenin hızı, daha hızlı veya daha yavaş dokunarak düğmesine basarak artırılabilir veya azaltılabilir.

API referansı

Türler

ifade

Her ifade, aşağıdaki anahtar-değer çiftleriyle bir sözlük tarafından temsil edilir:

Enleri

EmoteBar.GuiType türü

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteWheel,
})

Fonksiyonlar

sunucu yapılandırmak

Varsayılan sunucu tarafı yapılandırma seçeneklerini aşağıdaki anahtarlar/değerler aracılığıyla geçersiz kılar: config tablosunda.Bu işlev yalnızca bir Script 'dan çağrılabilir ve değişiklikler otomatik olarak tüm müşterilere yayılır.

Komut Dosyası
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureServer({
	emoteMinPlayers = 2,
	playParticles = false,
})

client yapılandırmak

Varsayılan istemci tarafı yapılandırma seçeneklerini aşağıdaki anahtarlar/değerler aracılığıyla geçersiz kılar: config tablosunda.Bu işlev yalnızca bir LocalScript 'dan çağrılabilir.guiType değerine bağlı olarak, not edilen sekmelerdeki seçenekler de uygulanır.

YerelScript - Duygusal Bar
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteBar,
	maxEmotesPerPage = 6,
	nextPageKey = Enum.KeyCode.Z,
	prevPageKey = Enum.KeyCode.C,
})

YerelScript - İfade Çarkı
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureClient({
	guiType = EmoteBar.GuiType.EmoteWheel,
})

setEmotes Yorumlar Yorumlar Yorumlar setEmotes

Kullanılacak özel ifadeleri ayarlar.Bunlar varsayılana eklenecek veya varsayılanların yerine geçeceklerdir, eğer useDefaultEmotes varsa true veya useDefaultEmotes varsa false .Bu işlev yalnızca bir Script 'dan çağrılabilir ve değişiklikler otomatik olarak tüm müşterilere yayılır.

Bu işleve geçen her bir ifadenin yapısı için ifade görün.

Script - ConfigureEmotes'u yapılandır
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.configureServer({
	useDefaultEmotes = false,
})

EmoteBar.setEmotes({
	{
		name = "Hello",
		animation = "rbxassetid://3344650532",
		image = "rbxassetid://7719817462",
		defaultTempo = 1,
	},
	{
		name = "Applaud",
		animation = "rbxassetid://5915693819",
		image = "rbxassetid://7720292217",
		defaultTempo = 2,
	},
})

setGuiVisibility değeri

Duyguları GUI'yi gösterir veya gizler. Bu işlev yalnızca belirli bir istemceden LocalScript üzerinden çağrılabilir.

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.setGuiVisibility(false)

getEmote Yorumlar Yorumlar Yorumlar Get Emote

Adına bir ifade alır.Emote bulunamıyorsa nil döndürür.Bu işlev yalnızca belirli bir istemceden LocalScript üzerinden çağrılabilir.

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

local shrug = EmoteBar.getEmote("Shrug")

oynaEmote

Verdiği ifadeyi oynar ve veri aktarıldığında sunucuda ifadeOynandı etkinliğini ateş eder, bağlıysa.Bu işlev yalnızca belirli bir istemceden LocalScript üzerinden çağrılabilir.

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

local shrug = EmoteBar.getEmote("Shrug")
EmoteBar.playEmote(shrug)

lockEmote kapanışı

ifadenın verilen adıyla kilidini kilitler. Bu işlev yalnızca istemciden bir LocalScript üzerinden çağrılabilir.

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.lockEmote("Applaud")

ifadeKilidiniAç

Verilen adı kullanarak ifadeyi kilidini açar. Bu işlev yalnızca istemceden bir LocalScript üzerinden çağrılabilir.

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.unlockEmote("Applaud")

Etkinlikler

ifadeOynandı

Herhangi bir istemci bir ifade oynattığında ateş eder. Bu olay yalnızca bir LocalScript içinde bağlanabilir.

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.emotePlayed:Connect(function(player, emote)
	print(player.Name, "played", emote.name)
end)

kilitliEmoteAktif edildi

Bir müşteri kilitli bir ifadeye tıkladığında ateş eder. Bu olay yalnızca bir LocalScript içinde bağlanabilir.

YerelScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))

EmoteBar.lockedEmoteActivated:Connect(function(emote)
	print(Players.LocalPlayer, "clicked", emote.name)
end)