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

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

アバターは、(を)入力/(に)入る力する任意のスペースであなたの身元を表します。 ソーシャルインタラクション 開発者モジュール は、各ユーザーが自分自身と自然な動きをよりよく表現し、リアルなリアルムをエクスペリエンスに追加するためにあります。

このモジュールには、次の機能が含まれています:

ボディオリエンテーション 誰のアバターの顔の頭部で、それぞれのユーザーのカメラが指している方向を通じて、そのユーザーのアバターの顔を指します。これにより、誰かが相手に何かを操作しているかを潜在的に示します。
チャットアニメーション エクスペリエンス中のチャットに少しのびを追加するために、アバターは時々アニメーションをプレイし、メッセージの内容に応じてアニメーションを再生します。それぞれのアニメーションをトリガーする「トリガーワード」のリストは構成可能です。

モジュール使用

インストール

エクスペリエンスで ソーシャルインタラクションズ モジュールを使用するには:

  1. 从 the ビュー タブで、ツールボックスを開き、 クリエイターストア タブを選択します。

    Toolbox toggle button in Studio
  2. モデル ソートが選択されていることを確認してから、 すべてを表示 ボタンをクリックして、 カテゴリ のための 1>ボタン1> をクリックします。

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

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

  5. In the エクスプローラー ウィンドウ, move the entire ソーシャルインタラクションズ model into ServerScriptService . エクスペリエンスを実行すると、モジュールはさまざまなサービスに分配され、実行を開始します。

構成

単に ソーシャルインタラクションズ モジュールを挿入すると、あなたの場所内の ボディオリエンテーションチャットアニメーション 機能の両方が有効になります。デフォルトの動作を調整するには:

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

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

    ローカルスクリプト

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

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

各チャットアニメーションを有効にする「トリガーワード」のリストは、Lua ストリングパターンを使用して、認識可能なワードを増加させることができます。たとえば、

トリガーワードは 場合により無視される場合があります。 ですので、 hey を入力すると、 HEY 、 1> Hey1> 、および他の変更と同じです。

アニメーションアニメーション IDワードパターン
ウェーブ3344650532

hell+o+     h+i+o*     <

拍手5911729486

ya+y+     h[ou]+r+a+y+     woo+t+

賛成4841397952

ye+s*>     ye+a+h*     y[eu]+p+     0> o+k+0>     ye+s*3>

同意しない4841401869

no+     no+pe+     yi+ke+s+

シャーグ3334392772

not+%s+sure+     idk+     don't%s+know+     0> i%s+don't%s+know+0>     not+%s+sure+3>

笑う3337966527

lo+l+     rof+l+     ha[ha]*     0> he[he+0>

睡眠4686925579

zzz+     yawn+

各アニメーションがアクティブになるトリガーワードのリスト

ローカルスクリプト

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
-- 「傾く」アニメーションのストリングパターンを登録する
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})
-- 「拍手」アニメーション用の追加の弦楽器パターンを登録
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

API リファレンス

機能

環境設定

require(require: table )

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

キー説明デフォルト
useBodyOrientationボディオリエンテーション機能を切り替えます。 体オリエンテーション機能 はい
waistOrientationWeightボディのオリエンテーションは、腰と首の回転のミックスを使用します。このパラメータは、2つのうちのどちらが優勢かを決定します。1つの値は、腰に重点を置き、0つの値は、首に重点を置きます。0.5
useChatAnimationsチャットアニメーション機能を切り替えます。はい
useDefaultTriggerWordsForChatEmotesチャットアニメーションは、デフォルトの トリガーワード リストで提供されます。このパラメータを false 設定して、オフにして自所有のものを提供します。はい
ローカルスクリプト

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

チャットアニメーションのトリガーワードを設定

setTriggerWordsForChatAnimation(animationId: string , triggerWords: table )

チャットアニメーション機能に新しいアニメーションを登録します。 triggerWords テーブルに含まれるストリングパターンに一致する任意のワードを入力すると、ID が最初のパラメータとして渡されるアニメーションが有効になります。

トリガーワードはプレイヤーに ケースインサイトなし ですので、 woahwoah、 2> woah2>、および他のバリエーションのチャットフレーズを受信するパターンがあります。

ローカルスクリプト

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
-- カスタムアニメーションの新しいストリングパターンを登録する
SocialInteractions.setTriggerWordsForChatAnimation(
"rbxassetid://3334538554",
{"cra+zy", "woah+"}
)

イベント

オンチャットアニメーションプレイ

チャットアニメーションが再生されるときに発動します。接続された関数は、アニメーション ID と、そのアルガートとしてトリガーされた言葉を受信します。このイベントは、LocalScript 内のみに接続できます。

パラメータ
animationId: stringプレイしたアニメーション ID。
トリガーワード: stringアニメーションをトリガーするチャットワード。
ローカルスクリプト

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SocialInteractions = require(ReplicatedStorage:WaitForChild("SocialInteractions"))
SocialInteractions.onChatAnimationPlayed:Connect(function(animationId, triggerWord)
print(animationId, triggerWord)
end)