ソーシャルインタラクション

あなたのアバターは、あなたが入るすべての空間でのあなたのアイデンティティです。SocialInteractions 開発者モジュールは、各ユーザーが自分自身とその自然な動きをよりよく表現できるようにし、ゲームにリアリズムを加えます。

このモジュールには、以下の機能が含まれています。

モジュールの使用法

インストール

ゲームでSocialInteractionsモジュールを使用するには：

1. スタジオのウィンドウメニューまたはホームタブツールバーから、ツールボックスを開き、クリエイターストアタブを選択します。

   

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

   

3. パッケージタイルを見つけてクリックします。

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

   

5. エクスプローラーウィンドウで、SocialInteractionsモデル全体をReplicatedStorageに移動します。ゲームを実行すると、モジュールが実行を開始します。

設定

SocialInteractionsモジュールを挿入するだけで、あなたの場所内で体の向きとチャットアニメーション機能の両方が有効になります。デフォルトの動作を調整するには：

1. StarterPlayerScripts内に新しいLocalScriptを作成し、名前をConfigureSocialInteractionsに変更します。

   

2. 新しいスクリプトに以下のコードを貼り付け、configure関数を使用してモジュールの動作をカスタマイズします。

   LocalScript

   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- 腰の回転をより強調し、チャットアニメーション機能を無効にします
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

チャットアニメーショントリガーワード

各チャットアニメーションをトリガーする「トリガーワード」のリストは設定可能で、Luau文字列パターンを利用して認識可能な単語を増やします。たとえば、Waveアニメーションで使用される組み合わせの1つはhe+y+o*であり、これはhey、heyyy、heyo、heyyyyo、heeeeyyyyoなどのバリエーションがアニメーションをトリガーすることを意味します。

また、トリガーワードは大文字と小文字を区別しないため、heyと入力することはHEY、Hey、および他のバリエーションと同じです。

各アニメーションをトリガーするトリガーワードのリストは設定可能で、追加のアニメーションはsetTriggerWordsForChatAnimation関数を介して追加できます。たとえば、次のLocalScriptは、文字列パターンcra+zyを使用してTiltアニメーションをリンクし、crazyやcraaaaaazyのようなトリガーワードをサポートします。また、Applaudアニメーションのためにcoo+lの追加文字列パターンを登録し、coolやcooooolのような単語をサポートします。

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- "Tilt"アニメーションのための文字列パターンを登録
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- "Applaud"アニメーションのための追加文字列パターンを登録
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

APIリファレンス

関数

configure

configテーブル内の以下のキー/値を介してデフォルトの設定オプションをオーバーライドします。この関数はLocalScriptからのみ呼び出すことができます。

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- 腰の回転をより強調し、チャットアニメーション機能を無効にします
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

チャットアニメーション機能に新しいアニメーションを登録します。triggerWordsテーブルに含まれる文字列パターンに一致する単語を入力すると、最初のパラメータとして渡されたアニメーションのIDがアクティブになります。

トリガーワードはプレイヤーに対して大文字と小文字を区別しないため、woahのパターンはwoah、WOAH、Woahなどのチャットフレーズを受け入れます。

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- カスタムアニメーションのための新しい文字列パターンを登録
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

イベント

onChatAnimationPlayed

チャットアニメーションが再生されると発火します。接続された関数は、アニメーションIDとアニメーションをトリガーした単語を引数として受け取ります。このイベントはLocalScript内でのみ接続できます。

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
	print(animationId, triggerWord)
end)