Interaksi Sosial | Dokumentasi - Pusat Kreator Roblox

Avatar Anda adalah identitas Anda di ruang apa pun yang Anda masuki. The SocialInteractions module developer memungkinkan setiap pengguna untuk mengekspresikan diri lebih baik dan gerakan alami mereka, menambahkan sentuhan realisme ke pengalaman.

Modul ini termasuk fitur berikut:

Orientaasi Tubuh	Membuat wajah avatar setiap orang di mana kamera pengguna yang sesuai menunjuk, melalui campuran rotasi leher dan pinggul. Ini memberikan petunjuk subtil tentang siapa atau apa yang orang lain interaksi dengan.
Animasi Obrolan	Menambahkan beberapa kecerdasan ke chat dalam pengalaman dengan membuat avatar kadang-kadang memainkan animasi, tergantung pada konten pesan yang mereka kirim. Daftar "kata-kata pemicu" yang mengaktifkan setiap animasi dapat dikonfigurasikan.

Fitur orientasi tubuh menggunakan CFrame penyesuaian dari Neck dan Waist joints pada karakter, yang berarti kuatig rakitan harus mencakup 2>Class.Motor6D2> objek dengan nama yang sama untuk modul berfungsi dengan benar.

Penggunaan Modul

Pemasangan

Untuk menggunakan modul SocialInteractions dalam pengalaman:

Dari tab Lihat, buka tab Kotak Alat dan pilih tab Toko Pencipta .
Pastikan Model penyortiran dipilih, lalu klik tombol Lihat Semua untuk Kategori .
Temukan dan klik Modul Dev ubin.
Temukan modul Interaksi Sosial dan klik, atau seret-seret ke dalam tampilan 3D.
Di jendela Explorer, pindahkan seluruh model SocialInteractions ke ServerScriptService . Setelah mengeksekusi pengalaman, modul akan di distribusikan ke berbagai layanan dan mulai berjalan.

Konfigurasi

Hanya dengan menyisipkan modul SocialInteractions akan mengaktifkan kedua fitur orientasi tubuh dan animasi chat di dalam tempat Anda. Untuk menyesuaikan perilaku default:

Dalam StarterPlayerScripts , buat LocalScript baru dan ganti nama menjadi KonfigurasiInteraksiSosial .

Tempaste kode berikut ke dalam naskah baru, menggunakan fungsi konfigurasikan untuk menyesuaikan perilaku modul.

Skrip Lokal
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

-- Buat rotasi pinggul lebih terangkat dan nonaktifkan fitur animasi chat
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

Kata-Kata Pemicu Animasi Chat

Daftar kata-kata "触发单词" yang mengaktifkan setiap animasi chat dapat dikonfigurasi dan pola string Lua digunakan untuk meningkatkan kata-kata yang dapat dikenali. Misalnya, salah satu kombinasi yang dig

Juga perhatikan bahwa kata-kata pemicu adalah tanpa batas kasus , jadi mengetik hey sama dengan HEY, 1> Hey1>, dan variasi lainnya.

Animasi	ID Animasi	Pola Kata
Gelombang	3344650532	hell+o+ h+i+o* <
Tepuk Tangan	5911729486	ya+y+ h[ou]+r+a+y+ wo
Setuju	4841397952	ye+s> ye+a+h y[eu]+p+ 0> o+k+0> ye+s*3>
Tidak Setuju	4841401869	no+ no+pe+ yi+ke+s+
Keriting	3334392772	not+%s+sure+ idk+ don't%s+know+ 0> i%s+don't%s+know+0> not+%s+sure+3>
Tawa	3337966527	lo+l+ rof+l+ ha[ha]* 0> he[he+0>
Tidur	4686925579	zzz+

Daftar kata-kata pemicu yang mengaktifkan setiap animasi dapat dikon

Skrip Lokal
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

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

Referensi API

Fungsi

mengonfigurasi

mengonfigurasi(config: table )

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

Kunci	Deskripsi	Standar
useBodyOrientation	Mengubah fitur orientasi tubuh .	benar
waistOrientationWeight	Orienteasi tubuh menggunakan campuran antara rotasi pinggul dan leher; parameter ini menentukan mana dari dua yang paling umum. Sebuah nilai 1 menempatkan fokus pada pinggul sementara 0 menempatkan fokus pada leher.	0,5
useChatAnimations	Mengubah fitur animasi chat .	benar
useDefaultTriggerWordsForChatEmotes	Animasi obrolan datang dengan daftar default kata-kata pemicu. Tetapkan parameter ini menjadi false jika Anda ingin menonaktifkannya dan menyediakan Anda memiliki.	benar

Skrip Lokal
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

-- Buat rotasi pinggul lebih terangkat dan nonaktifkan fitur animasi chat
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setKataParaMengaturAnimasiObrolan

setTriggerWordsForChatAnimation(animationId: string , triggerWords: table )

Mendaftarkan animasi baru dalam fitur animasi chat. Mengetik kata apa pun yang cocok dengan pola tanda bersama-sama dalam tabel triggerWords akan mengaktifkan animasi whose ID diberikan sebagai parameter pertama.

Catat bahwa kata-kata pemicu adalah tanpa sensitif kasus bagi pemain, jadi pola dari woah akan menerima frasa chat dari woah, 1> WOAH1>, 4> Woah4>, dan variasi lainnya.

Skrip Lokal
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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

Acara

padaChatAnimationPlayed

Diaktifkan ketika animasi chat dimainkan. Fungsi terhubung menerima ID animasi dan kata yang mengaktifkan animasi sebagai argumennya. Acara ini hanya dapat dihubungkan dalam LocalScript .

Parameter
animasiId: string	Animasi ID yang bermain.
triggerScript: string	Kata obrolan yang mengaktifkan animasi.

Skrip Lokal
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

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