Barra delle emozioni

Le emozioni sono un componente principale di qualsiasi esperienza sociale.Il EmoteBar modulo sviluppatore mira a fornire ai giocatori un modo accessibile e personalizzabile per facilitare l'interazione sociale significativa.

Uso del modulo

Installazione

Per utilizzare il modulo EmoteBar in un'esperienza:

1. Dalla scheda Visualizza, apri la Toolbox e seleziona la scheda Creator Store .

   

2. Assicurati che la classificazione Modelli sia selezionata, quindi fai clic sul pulsante Vedi tutti per Categorie .

   

3. Individua e fai clic sul riquadro Moduli di sviluppo .

   

4. Individua il modulo Barra delle emozioni e cliccalo, oppure trascinalo nella vista 3D.

   

5. Nella finestra Explorer, sposta l'intero modello EmoteBar nel ServerScriptService .Dopo l'esecuzione dell'esperienza, il modulo si distribuirà a vari servizi e inizierà a funzionare.

   

Configurazione

Il modulo è preconfigurato con 7 emote e può essere facilmente personalizzato con le tue emote e le opzioni di visualizzazione.Inoltre, se il giocatore possiede qualsiasi emote da eventi precedenti di Roblox come Lil Nas X, Royal Blood o Twenty One Pilots, tali emote verranno automaticamente aggiunte all'elenco delle emote disponibili.

1. In ServerScriptService , crea un nuovo Script e rinominalo ConfiguraEmotes .

   

2. Incolla il seguente codice nel nuovo script ConfiguraEmotes .La useDefaultEmotes impostazione di false sovrascrive le emote predefinite e ti consente di definire emote personalizzate tramite la funzione setEmotes.

   Script - ConfiguraEmotes
   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 emote

Un'emote mega si forma quando più giocatori nella stessa area eseguono la stessa emote allo stesso tempo.Mentre sempre più giocatori si uniscono, l'emote mega cresce di dimensioni.Mentre i giocatori smettono di eseguire l'Emote, la mega emote diventa più piccola fino a quando non scompare.

Tempo

Il tempo di un'Emote è la velocità a cui suona quando il suo pulsante viene premuto una volta La velocità predefinita di un'emote è determinata dal suo defaultTempo .La velocità di un'Emotepuò essere aumentata o diminuita premendo il suo pulsante più velocemente o più lentamente.

Riferimento API

Tipi

Emoticon

Ogni emote è rappresentata da un dizionario con i seguenti paari chiave-valore:

Enumi

EmoteBar.GuiTipo

Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

Functioni

configurareServer

Sovrascrive le opzioni di configurazione predefinite lato server attraverso le seguenti chiavi/valori nella tabella config.Questa funzione può essere chiamata solo da un Script e le modifiche si replicano automaticamente a tutti i client.

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

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

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

configurareClient

Sovrascrive le opzioni di configurazione predefinite lato client attraverso le seguenti chiavi/valori nella tabella config.Questa funzione può essere chiamata solo da un LocalScript .A seconda del valore di guiType , le opzioni nelle schede note si applicano anche.

Script locale - Barra delle emozioni
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,
})

Script locale - Ruota delle emozioni
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

setEmotes

Imposta le emote personalizzate da utilizzare.Questi verranno aggiunti ai predefiniti se useDefaultEmotes è true , o sostituiranno i predefiniti se useDefaultEmotes è false .Questa funzione può essere chiamata solo da un Script e le modifiche si replicano automaticamente a tutti i client.

Vedi Emote per la struttura di ogni emote passata a questa funzione.

Script - ConfiguraEmotes
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

Mostra o nasconde l'GUI or Intefaccia grafica utenteutente delle emote. Questa funzione può essere chiamata solo da un LocalScript su un client specifico.

Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.setGuiVisibility(false)

ottenereEmote

Ottiene un Emote per nome.Restituisce nil se l'emote non può essere trovata.Questa funzione può essere chiamata solo da un LocalScript su un client specifico.

Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local shrug = EmoteBar.getEmote("Shrug")

giocaEmote

Riproduce l'emote data e lancia l'evento emotePlayed sul Server, se connesso.Questa funzione può essere chiamata solo da un LocalScript su un client specifico.

Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

bloccaEmote

Blocca il Emote con il nome fornito. Questa funzione può essere chiamata solo da un LocalScript sul client.

Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.lockEmote("Applaud")

sbloccaEmote

Sblocca l'emote con il nome fornito con la funzione data. Questa funzione può essere chiamata solo da un LocalScript sul client.

Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

EmoteBar.unlockEmote("Applaud")

Eventi

emoticonSuonato

Si accende quando qualsiasi client riproduce un'Emote. Questo evento può essere collegato solo in un LocalScript .

Script locale
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

锁定表情激活ato

Si attiva quando un client clicca un'Emotebloccata. Questo evento può essere collegato solo in un LocalScript .

Script locale
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)