Interaksi Sosial

Avatar Anda adalah identitas Anda di setiap ruang yang Anda masuki. Modul SocialInteractions pengembang modul memungkinkan setiap pengguna untuk lebih mengekspresikan diri dan gerakan alami mereka, menambahkan sentuhan realisme pada pengalaman tersebut.

Modul ini mencakup fitur-fitur berikut:

Penggunaan Modul

Instalasi

Untuk menggunakan modul SocialInteractions dalam suatu pengalaman:

1. Dari menu Window Studio atau toolbar tab Home, buka Toolbox dan pilih tab Creator Store.

   

2. Pastikan pengurutan Models dipilih, lalu klik tombol See All untuk Categories.

   

3. Temukan dan klik ubin Packages.

4. Temukan modul Interaksi Sosial dan klik, atau seret dan lepaskan ke dalam tampilan 3D.

   

5. Di jendela Explorer, pindahkan seluruh model SocialInteractions ke ReplicatedStorage. Setelah menjalankan pengalaman, modul ini akan mulai berjalan.

Konfigurasi

Cukup memasukkan modul SocialInteractions akan mengaktifkan fitur orientasi tubuh dan animasi obrolan di dalam tempat Anda. Untuk menyesuaikan perilaku default:

1. Di StarterPlayerScripts, buat LocalScript baru dan ubah namanya menjadi ConfigureSocialInteractions.

   

2. Tempelkan kode berikut ke dalam skrip baru, menggunakan fungsi configure untuk menyesuaikan perilaku modul.

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- Membuat rotasi pinggang lebih menonjol dan menonaktifkan fitur animasi obrolan
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Kata Pemicu Animasi Obrolan

Daftar "kata pemicu" yang mengaktifkan setiap animasi obrolan dapat dikonfigurasi dan pola string Luau digunakan untuk meningkatkan kata-kata yang dapat dikenali. Misalnya, satu kombinasi yang digunakan oleh animasi Wave adalah he+y+o*, yang berarti bahwa hey, heyyy, heyo, heyyyyo, heeeeyyyyo, dan variasi lainnya memenuhi syarat untuk memicu animasi.

Perlu dicatat juga bahwa kata pemicu bersifat tidak sensitif terhadap huruf besar, jadi mengetik hey sama dengan HEY, Hey, dan variasi lainnya.

Daftar kata pemicu yang mengaktifkan setiap animasi dapat dikonfigurasi, dan animasi tambahan dapat ditambahkan melalui fungsi setTriggerWordsForChatAnimation. Sebagai contoh, LocalScript berikut menghubungkan animasi Tilt dengan pola string cra+zy untuk mendukung kata pemicu seperti crazy dan craaaaaazy. Ini juga mendaftarkan pola string tambahan coo+l untuk animasi Applaud untuk mendukung kata-kata seperti cool dan coooool.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Daftarkan pola string untuk animasi "Tilt"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Daftarkan pola string tambahan untuk animasi "Applaud"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Referensi API

Fungsi

configure

Mengganti opsi konfigurasi default melalui kunci/nilai berikut dalam tabel config. Fungsi ini hanya dapat dipanggil dari LocalScript.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Membuat rotasi pinggang lebih menonjol dan menonaktifkan fitur animasi obrolan
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

Mendaftarkan animasi baru dalam fitur animasi obrolan. Mengetik kata apa pun yang cocok dengan pola string yang termasuk dalam tabel triggerWords akan mengaktifkan animasi dengan ID yang diteruskan sebagai parameter pertama.

Perlu dicatat bahwa kata pemicu bersifat tidak sensitif terhadap huruf besar bagi pemain, sehingga pola woah akan menerima frasa obrolan woah, WOAH, Woah, dan variasi lainnya.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Daftarkan pola string baru untuk animasi kustom
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Acara

onChatAnimationPlayed

Ditembakkan ketika animasi obrolan dimainkan. Fungsi yang terhubung menerima ID animasi dan kata yang memicu animasi sebagai argumennya. Acara ini hanya bisa terhubung dalam LocalScript.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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