Pasek Emotów

Emoty są podstawowym elementem każdej społecznej interakcji. Moduł EmoteBar dewelopera ma na celu zapewnienie graczom dostępnego, dostosowywanego sposobu na ułatwienie znaczącej interakcji społecznej.

Użycie modułu

Instalacja

Aby użyć modułu EmoteBar w doświadczeniu:

1. Z menu Okno w Studio lub z paska narzędzi karty Strona główna, otwórz Narzędziownię i wybierz kartę Sklep Twórcy.

   

2. Upewnij się, że wybrano sortowanie Modele, a następnie kliknij przycisk Zobacz wszystkie dla Kategorii.

   

3. Znajdź i kliknij kafelek Pakiety.

4. Zlokalizuj moduł Pasek Emotów i kliknij go lub przeciągnij do widoku 3D.

   

5. W oknie Eksploratora przenieś cały model EmoteBar do ReplicatedStorage. Po uruchomieniu doświadczenia moduł zacznie działać.

Konfiguracja

Moduł jest wstępnie skonfigurowany z 7 emotkami i można go łatwo dostosować własnymi emotkami i opcjami wyświetlania. Dodatkowo, jeśli gracz posiada jakiekolwiek emotki z wcześniejszych wydarzeń Roblox, takich jak Lil Nas X, Royal Blood czy Twenty One Pilots, te emotki zostaną automatycznie dodane do listy dostępnych emotek.

1. W ServerScriptService, utwórz nowy Script i zmień jego nazwę na ConfigureEmotes.

   

2. Wklej następujący kod do nowego skryptu ConfigureEmotes. Ustawienie useDefaultEmotes na false nadpisuje domyślne emotki i pozwala na zdefiniowanie niestandardowych emotek za pomocą funkcji setEmotes.

   Script - ConfigureEmotes
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local EmoteBar = require(ReplicatedStorage.EmoteBar)
   
   EmoteBar.configureServer({
   	useDefaultEmotes = false,
   })
   
   EmoteBar.setEmotes({
   	{
   		name = "Cześć",
   		animation = "rbxassetid://3344650532",
   		image = "rbxassetid://7719817462",
   		defaultTempo = 1,
   	},
   	{
   		name = "Brawa",
   		animation = "rbxassetid://5915693819",
   		image = "rbxassetid://7720292217",
   		defaultTempo = 2,
   	},
   })

Mega emotki

Mega emotka powstaje, gdy wielu graczy w tym samym obszarze wykonuje tę samą emotkę w tym samym czasie. Gdy coraz więcej graczy zaczyna uczestniczyć, mega emotka staje się większa. Gdy gracze przestają wykonywać emotkę, mega emotka staje się mniejsza, aż w końcu znika.

Tempo

Tempo emotki to prędkość, z jaką jest odtwarzana, gdy przycisk jest naciśnięty raz. Domyślna prędkość emotki jest określona przez jej defaultTempo. Prędkość emotki można zwiększyć lub zmniejszyć, naciskając jej przycisk szybciej lub wolniej.

Referencja API

Typy

Emote

Każda emotka jest reprezentowana przez słownik z następującymi parami klucz-wartość:

Enums

EmoteBar.GuiType

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

Funkcje

configureServer

Nadpisuje domyślne opcje konfiguracyjne po stronie serwera przez następujące klucze/wartości w tabeli config. Ta funkcja może być wywoływana tylko z Script, a zmiany będą automatycznie replikowane do wszystkich klientów.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

configureClient

Nadpisuje domyślne opcje konfiguracyjne po stronie klienta przez następujące klucze/wartości w tabeli config. Ta funkcja może być wywoływana tylko z LocalScript. W zależności od wartości guiType, opcje w wymienionych kartach również obowiązują.

LocalScript - Pasek Emotów
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

LocalScript - Koło Emotów
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

setEmotes

Ustawia niestandardowe emotki do użycia. Zostaną one dodane do domyślnych, jeśli useDefaultEmotes jest ustawione na true, lub zastąpią domyślne, jeśli useDefaultEmotes jest ustawione na false. Ta funkcja może być wywoływana tylko z Script, a zmiany będą automatycznie replikowane do wszystkich klientów.

Zobacz Emote dla struktury każdej emotki przekazanej do tej funkcji.

Script - ConfigureEmotes
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.configureServer({
	useDefaultEmotes = false,
})

EmoteBar.setEmotes({
	{
		name = "Cześć",
		animation = "rbxassetid://3344650532",
		image = "rbxassetid://7719817462",
		defaultTempo = 1,
	},
	{
		name = "Brawa",
		animation = "rbxassetid://5915693819",
		image = "rbxassetid://7720292217",
		defaultTempo = 2,
	},
})

setGuiVisibility

Pokazuje lub ukrywa GUI emotek. Ta funkcja może być wywoływana tylko z LocalScript na konkretnym kliencie.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.setGuiVisibility(false)

getEmote

Pobiera Emote według nazwy. Zwraca nil, jeśli emotka nie może zostać znaleziona. Ta funkcja może być wywoływana tylko z LocalScript na konkretnym kliencie.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

local shrug = EmoteBar.getEmote("Shrug")

playEmote

Odtwarza daną Emote i wywołuje zdarzenie emotePlayed na serwerze, jeśli jest podłączony. Ta funkcja może być wywoływana tylko z LocalScript na konkretnym kliencie.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

lockEmote

Zamyka Emote o danej nazwie. Ta funkcja może być wywoływana tylko z LocalScript na kliencie.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.lockEmote("Brawa")

unlockEmote

Odblokowuje Emote o danej nazwie. Ta funkcja może być wywoływana tylko z LocalScript na kliencie.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

EmoteBar.unlockEmote("Brawa")

Zdarzenia

emotePlayed

Wywołuje się, gdy jakikolwiek klient odtwarza emotkę. To zdarzenie można podłączyć tylko w LocalScript.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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

lockedEmoteActivated

Wywołuje się, gdy klient kliknie zablokowaną emotkę. To zdarzenie można podłączyć tylko w LocalScript.

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

local EmoteBar = require(ReplicatedStorage.EmoteBar)

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