Barra emote

Le emote sono una componente fondamentale di qualsiasi esperienza sociale. Il modulo sviluppatore EmoteBar ha lo scopo di fornire ai giocatori un modo accessibile e personalizzabile per facilitare l'interazione sociale significativa.

Utilizzo del modulo

Installazione

Per utilizzare il modulo BarraEmote in un'esperienza:

1. Dalla scheda Visualizza, aprire il Pannello degli strumenti e selezionare la scheda Marketplace.

   

2. Assicurarsi che la selezione dei modelli sia selezionata, quindi fare clic sul pulsante Vedi tutto per le Categorie.

   

3. Individuare e fare clic sulla piastrella DEV MODULES.

   

4. Individuare il modulo EmoteBar e fare clic su di esso, o trascinarlo e rilasciarlo nella visualizzazione 3D.

   

5. Nella finestra Explorer, spostare l'intero modello EmoteBar in ServerScriptService. Dopo aver avviato l'esperienza, il modulo si distribuirà ai vari servizi e inizierà a funzionare.

   

Configurazione

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

1. All'interno di ServizioScriptServer, crea un Scriptnuovoe rinominalo ConfiguraEmote.

   

2. Incolla il seguente codice nel nuovo script ConfiguraEmote. L'useDefaultEmotesimpostazione di falsesovrascrive le emote predefinite e ti consente di definire emote personalizzate tramite la funzione impostaEmote.

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

Una mega emote si forma quando più giocatori nella stessa area eseguono la stessa emote allo stesso tempo. Man mano che sempre più giocatori si uniscono, la mega emote diventa sempre più grande. Quando i giocatori smettono di eseguire l'emote, la mega emote diventa più piccola fino a scomparire.

Tempo

Il tempo di un'emote è la velocità alla quale viene riprodotta quando il suo pulsante viene toccato una volta. La velocità predefinita di un'emote è determinata dal suo defaultTempo. La velocità di un'emote può essere aumentata o diminuita toccando il suo pulsante più velocemente o più lentamente.

Riferimento API

Tipi

Emote

Ciascuna emote è rappresentata da un dizionario con le seguenti coppie di valore chiave:

Enums

EmoteBar.GuiType

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureClient({
    guiType = EmoteBar.GuiType.EmoteWheel,
})

Funzioni

configureServer

configureServer(config:table):nil

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

Script
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureServer({
    emoteMinPlayers = 2,
    playParticles = false,
})

configureClient

configureClient(config:table):nil

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

Generale

BarraEmote

RuotaEmote

LocalScript - Emote 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,
})

LocalScript - Emote Wheel
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.configureClient({
    guiType = EmoteBar.GuiType.EmoteWheel,
})

impostaEmote

setEmotes(emotes:table):nil

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

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

Script - ConfigureEmotes
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,
    },
})

impostaVisibilitàGui

setGuiVisibility(visible:booleano):nil

Mostra o nasconde la GUI delle emote. Questa funzione può essere chiamata solo da un LocalScript su un client specifico.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.setGuiVisibility(false)

ottieniEmote

getEmote(emoteName:string):table

Fa ottenere 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.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
local shrug = EmoteBar.getEmote("Shrug")

riproduciEmote

playEmote(emote:Emote):nil

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

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
local shrug = EmoteBar.getEmote("Shrug")
EmoteBar.playEmote(shrug)

bloccaEmote

lockEmote(emoteName:string):nil

Sblocca l'Emote con il nome dato. Questa funzione può essere chiamata solo LocalScriptsul client.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.lockEmote("Applaud")

sbloccaEmote

unlockEmote(emoteName:string):nil

Blocca l'Emote con il nome dato. Questa funzione può essere chiamata solo LocalScriptsul client.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.unlockEmote("Applaud")

Eventi

emoteRiprodotta

emotePlayed(player:Player, emote:Emote): RBXScriptSignal

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

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.emotePlayed:Connect(function(player, emote)
    print(player.Name, "played", emote.name)
end)

EmotebloccataAttivata

lockedEmoteActivated(emote:Emote): RBXScriptSignal

Si accende quando un client fa clic su un'emote bloccata. Questo evento può essere collegato solo in un LocalScript.

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