Tương Tác Xã Hội

Avatar của bạn là danh tính của bạn trong mọi không gian mà bạn bước vào. Mô-đun SocialInteractions mô-đun phát triển cho phép mỗi người dùng thể hiện bản thân và chuyển động tự nhiên tốt hơn, mang lại một chút thực tế cho trải nghiệm.

Mô-đun này bao gồm các tính năng sau:

Cách Sử Dụng Mô-đun

Cài Đặt

Để sử dụng mô-đun SocialInteractions trong một trải nghiệm:

1. Từ menu Cửa Sổ của Studio hoặc thanh công cụ Trang Chủ, mở Công Cụ và chọn tab Cửa Hàng Tạo.

   

2. Đảm bảo rằng việc sắp xếp Mô Hình đã được chọn, sau đó nhấn nút Xem Tất Cả cho Danh Mục.

   

3. Tìm và nhấp vào ô Gói.

4. Tìm mô-đun Tương Tác Xã Hội và nhấp vào nó, hoặc kéo và thả vào chế độ xem 3D.

   

5. Trong cửa sổ Khám Phá, di chuyển toàn bộ mô hình SocialInteractions vào ReplicatedStorage. Khi chạy trải nghiệm, mô-đun sẽ bắt đầu chạy.

Cấu Hình

Chỉ cần chèn mô-đun SocialInteractions sẽ kích hoạt cả tính năng hướng cơ thể và hoạt hình trò chuyện trong địa điểm của bạn. Để điều chỉnh hành vi mặc định:

1. Trong StarterPlayerScripts, tạo một LocalScript mới và đổi tên nó thành ConfigureSocialInteractions.

   

2. Dán mã sau vào script mới, sử dụng hàm configure để tùy chỉnh hành vi của mô-đun.

   LocalScript
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SocialInteractions = require(ReplicatedStorage.SocialInteractions)
   
   -- Làm cho xoay eo rõ ràng hơn và vô hiệu hóa tính năng hoạt hình trò chuyện
   SocialInteractions.configure({
   	waistOrientationWeight = 0.75,
   	useChatAnimations = false,
   })

Từ Kích Hoạt Hoạt Hình Trò Chuyện

Danh sách các "từ kích hoạt" giúp kích hoạt mỗi hoạt hình trò chuyện có thể cấu hình và các mẫu chuỗi Luau được sử dụng để tăng cường nhận diện từ. Ví dụ, một kết hợp được sử dụng cho hoạt hình Vẫy Tay là he+y+o*, có nghĩa là hey, heyyy, heyo, heyyyyo, heeeeyyyyo, và các biến thể khác sẽ đủ điều kiện để kích hoạt hoạt hình.

Lưu ý rằng các từ kích hoạt là không phân biệt chữ hoa chữ thường, nên gõ hey cũng giống như HEY, Hey, và các biến thể khác.

Danh sách các từ kích hoạt giúp kích hoạt mỗi hoạt hình có thể cấu hình, và các hoạt hình bổ sung có thể được thêm vào thông qua hàm setTriggerWordsForChatAnimation. Ví dụ, LocalScript sau liên kết hoạt hình Nghiêng với mẫu chuỗi cra+zy để hỗ trợ các từ kích hoạt như crazy và craaaaaazy. Nó cũng đăng ký một mẫu chuỗi bổ sung coo+l cho hoạt hình Vỗ Tay để hỗ trợ các từ như cool và coooool.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Đăng ký mẫu chuỗi cho hoạt hình "Nghiêng"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://3334538554", {"cra+zy"})

-- Đăng ký mẫu chuỗi bổ sung cho hoạt hình "Vỗ Tay"
SocialInteractions.setTriggerWordsForChatAnimation("rbxassetid://5911729486", {"coo+l"})

Tham Khảo API

Các Hàm

configure

Ghi đè các tùy chọn cấu hình mặc định thông qua các khóa/giá trị sau trong bảng config. Hàm này chỉ có thể được gọi từ một LocalScript.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Làm cho xoay eo rõ ràng hơn và vô hiệu hóa tính năng hoạt hình trò chuyện
SocialInteractions.configure({
	waistOrientationWeight = 0.75,
	useChatAnimations = false,
})

setTriggerWordsForChatAnimation

Đăng ký một hoạt hình mới trong tính năng hoạt hình trò chuyện. Gõ bất kỳ từ nào khớp với một mẫu chuỗi trong bảng triggerWords sẽ kích hoạt hoạt hình có ID được truyền vào dưới dạng tham số đầu tiên.

Lưu ý rằng các từ kích hoạt là không phân biệt chữ hoa chữ thường với người chơi, vì vậy một mẫu là woah sẽ chấp nhận các cụm từ trò chuyện như woah, WOAH, Woah, và các biến thể khác.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

-- Đăng ký mẫu chuỗi mới cho một hoạt hình tùy chỉnh
SocialInteractions.setTriggerWordsForChatAnimation(
	"rbxassetid://3334538554",
	{"cra+zy", "woah+"}
)

Các Sự Kiện

onChatAnimationPlayed

Sự kiện xảy ra khi một hoạt hình trò chuyện được phát. Hàm kết nối nhận ID hoạt hình và từ kích hoạt hoạt hình làm đối số. Sự kiện này chỉ có thể được kết nối trong một LocalScript.

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

local SocialInteractions = require(ReplicatedStorage.SocialInteractions)

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