Interaksi Sosial

Avatar Anda adalah identitas Anda di setiap ruang yang Anda masuki. Modul SocialInteractions pengembang memungkinkan setiap pengguna untuk mengekspresikan diri dan gerakan alami mereka dengan lebih baik, menambahkan sentuhan realisme ke dalam permainan.

Modul ini mencakup fitur-fitur berikut:

Penggunaan Modul

Instalasi

Untuk menggunakan modul SocialInteractions dalam sebuah permainan:

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 lepas ke dalam tampilan 3D.

   

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

Konfigurasi

Cukup dengan menyisipkan 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 ganti 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 mencolok 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 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 bahwa kata pemicu bersifat tidak peka huruf besar/kecil, 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. Misalnya, 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.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

-- Mendaftarkan 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.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Membuat rotasi pinggang lebih mencolok 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 yang ID-nya diteruskan sebagai parameter pertama.

Perlu dicatat bahwa kata pemicu bersifat tidak peka huruf besar/kecil bagi pemain, jadi pola woah akan menerima frasa obrolan woah, WOAH, Woah, dan variasi lainnya.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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

Peristiwa

onChatAnimationPlayed

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

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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