リアクションバー

リアクションは、ソーシャル体験の核となる構成要素です。 EmoteBarの開発者モジュールは、プレイヤーが有意義に人と交流できるようにする、利用しやすくカスタマイズ可能な方法を提供することを目指しています。

モジュールの使用法

インストール

バーチャル空間内でEmoteBarモジュールを使用する方法

1. 表示タブから、ツールボックスを開き、マーケットプレイスタブを選択します。

   

2. モデルのソートが選択されていることを確認し、カテゴリのすべてのボタンを表示をクリックします。

   

3. DEV モジュールタイルを見つけてクリックします。

   

4. リアクションバーモジュールを見つけてクリックするか、3D ビューにドラッグ＆ドロップします。

   

5. エクスプローラウィンドウで、EmoteBarモデル全体をServerScriptServiceに移動します。 バーチャル空間を実行すると、モジュールはそれ自体をさまざまなサービスに配布し、実行を開始します。

   

設定

モジュールには 7 つのリアクションが事前に設定されており、独自のリアクションや表示オプションで簡単にカスタマイズできます。 さらに、プレイヤーが Lil Nas X、Royal Blood、Twenty One Pilots など過去の Roblox イベントのエモートを所有している場合、それらのエモートは自動的に利用可能なエモートリストに追加されます。

1. ServerScriptService内で新しい… を作成して名前をConfigureEmotesに変更Scriptします。

   

2. 以下のコードを新しいConfigureEmotesスクリプトに貼り付けます。 useDefaultEmotesのfalse設定はデフォルトのエモートを上書きし、setEmotes関数でカスタムエモートを定義することができます。

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

メガエモート

メガエモートは、同じエリアの複数のプレイヤーが同時に同じエモートを実行したときに形成されます。 参加プレイヤーが増えると、メガエモートは大きく成長していきます。 参加プレイヤーが増えると、メガエモートは大きく成長していきます。 プレイヤーがエモートを停止すると、メガエモートは小さくなり、最終的には消えてしまいます。

テンポ

エモートのテンポとは、そのボタンが一度タップされたときに再生される速度です。 エモートのデフォルトの速度は、そのdefaultTempoによって決定されます。 ボタンをタップする速度によって、エモートのスピードが速くなったり遅くなったりします。

API リファレンス

種類

リアクション

各エモートは、以下のキーと値のペアを持つ辞書で表現されます。

列挙型

EmoteBar.GuiType

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

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

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

関数

configureServer

configureServer(config:table):nil

デフォルトのサーバー側設定オプションは、configテーブル内の以下のキー/値を使用して上書きします。 この関数は、Scriptからのみ呼び出すことができ、変更内容は、すべてのクライアントに自動的に複製されます。

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

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

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

configureClient

configure(config:table):nil

デフォルトのクライアント側の設定オプションを、テーconfigブル内にある以下のキー/値を使用して上書きします。 この関数は、LocalScriptからのみ呼び出すことができます。 guiTypeの値に応じて、前述のタブのオプションも適用されます。

Script Editor

EmoteBar

EmoteWheel

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

setEmotes

setEmotes(emotes:table):nil

使用するカスタムリアクションを設定します。 これらは、useDefaultEmotesがtrueの場合はデフォルトに追加され、useDefaultEmotesがfalseの場合はデフォルトに置き換わります。 この関数は、Scriptからのみ呼び出すことができ、変更内容は、すべてのクライアントに自動的に複製されます。

この関数に渡される各エモートの構造については、エモートをご覧ください。

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

setGuiVisibility

setGuiVisibility(visible:boolean):nil

エモート GUI を表示または非表示にします。 この関数は、特定のクライアントのLocalScriptからのみ呼び出すことができます。

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

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

EmoteBar.setGuiVisibility(false)

getEmote

getEmote(emoteName:string):table

名前でエモートを取得します。 エモートが見つからない場合はnilを返します。 この関数は、特定のクライアントのLocalScriptからのみ呼び出すことができます。

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

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

local shrug = EmoteBar.getEmote("Shrug")

playEmote

playEmote(emote:Emote):nil

接続されている場合、指定されたリアクションを再生し、サーバー上でemotePlayedイベントを発生させます。 この関数は、特定のクライアントのLocalScriptからのみ呼び出すことができます。

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

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

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

lockEmote

lockEmote(emoteName:string):nil

指定された名前のリアクションをロックします。 この関数は、クライアントのLocalScriptからのみ呼び出すことができます。

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

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

EmoteBar.lockEmote("Applaud")

unlockEmote

unlockEmote(emoteName:string):nil

指定された名前のリアクションのロックを解除。 この関数は、クライアントのLocalScriptからのみ呼び出すことができます。

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

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

EmoteBar.unlockEmote("Applaud")

イベント

emotePlayed

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

クライアントがリアクションを再生すると発生します。 このイベントは、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)

lockedEmoteActivated

lockedEmoteActivated(emote:Emote): RBXScriptSignal

クライアントがロックされたリアクションをクリックしたときに発生。 このイベントは、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)