จุดมุ่งหมายของ Emotes คือการให้ผู้ใช้ประสบการณ์สังคมที่เข้าถึงได้ การปรับแต่ง Emotes ให้ผู้ใช้สามารถใช้งานได้ง่ายขึ้น และการให้ผู้พัฒนาโมดูลการใช้งาน Emotes เพื่อให้ผู้ใช้สามารถใช้งานได้อย่างเต็มร
การใช้งานโมดูล
การติดตั้ง
เพื่อใช้โมดูล EmoteBar ในประสบการณ์:
จากแท็บ ดู เปิด กล่องเครื่องมือ และเลือกแท็บ ร้านค้าผู้สร้าง
ให้แน่ใจว่า รุ่น การเรียงลำดับเลือกแล้วคลิกปุ่ม ดูทั้งหมด สําหรับ หมวดหมู่
ค้นหาและคลิกที่ โมดูลการพัฒนา รายการ
ค้นหาโมดูล Emote Bar และคลิกหรือลากไปยัง 3D มุมมอง
ใน หน้าต Explorer ของคุณ ย้ายรุ่น EmoteBar ทั้งหมดไปยัง 1> ServerScriptService1> เมื่อเรียกใช้ประสบการณ์จะเริ่มต้นทำงานโมดูล
การกำหนดค่า
โมดูลนี้ได้รับการกำหนดลักษณะล่วงหน้าด้วย 7 อิโมจิและสามารถปรับแต่งได้ง่ายดายด้วยอิโมจิของคุณเองและตั้งค่าการแสดงผล โดยเฉพาะอย่างยิ่งหากผู้เล่นเป็นเจ้าของอิโมจิ
ใน ServerScriptService สร้าง Script ใหม่และเปลี่ยนชื่อมันใหม่ว่า กำหนดอารมณ์
วางรหัสต่อไปนี้ในสคริปต์ใหม่ กำหนดอิโมจิเมนต์ใหม่ รหัสการตั้งค่า useDefaultEmotes ของ false เหนือสมบัติเมจิเมนต์ปกติและสามารถกำหนดเมจิเมนต์ที่กำหนดเ
สคริป - กำหนดอารมณ์local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.configureServer({useDefaultEmotes = false,})EmoteBar.setEmotes({{name = "Hello",animation = "rbxassetid://3344650532",image = "rbxassetid://7719817462",defaultTempo = 1,},{name = "Applaud",animation = "rbxassetid://5915693819",image = "rbxassetid://7720292217",defaultTempo = 2,},})
เมก้าเอมอต
เมกะอิโมจิเกิดขึ้นเมื่อผู้เล่นหลายคนในพื้นที่เดียวกันทำเมกะอิโมตเดียวกันในเวลาเดียวกัน ท่าทาง
เวลา
เวลา ท่าทางความเร็วปกติของอีโมจิจะได้รับการกำหนดโดย defaultTempo ของมัน ท่าทาง
อ้างอิง เอกสารอ้างอิงเกี่ยวกับ API
รูปแบบ
อิโมจิ
แต่ละ emote ได้รับการแทนที่ด้วยคู่ค่าสัญลักษณ์ด้านล่าง:
กุญแจ | ชนิด | คำอธิบาย |
---|---|---|
name | สตริง | ชื่ออีโมต, ตัวอย่างเช่น "Shrug" . |
animation | สตริง | แอนิเมชัน |
image | สตริง | รหัสสินทรัพย์สำหรับรูปภาพ ท่าทางใน GUI |
defaultTempo | จํานวน | แอนิเมชันเช่น เวลา 2 จะเล่นอนิเมชันที่เร็วเป็นสองเท่าของความเร็วปกติ ต้องใหญ่กว่า 0 |
isLocked | บูล | ว่าจุดมุ่งหมายจะถูก "ล็อค" จากการใช้งาน |
เอนัม
EmoteBar.GuiType
ชื่อ | สรุป |
---|---|
EmoteBar | แบบฟอร์มเริ่มต้นที่จะแสดงอิโมจิในแถบด้านล่างของหน้าจอ แบ่งออกเป็นแต่ละ "หน้า" |
EmoteWheel | ตัวแปรที่จะแสดงอิโมจิในแหวนเมื่อผู้เล่นคลิกหรือแตะที่ตัวละครผู้เล่นของพวกเขา |
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.configureClient({guiType = EmoteBar.GuiType.EmoteWheel,})
ฟังก์ชัน
กำหนดค่าเซิร์ฟเวอร์
ปิดการตั้งค่าของเซิร์ฟเวอร์ด้านล่างผ่านคีย์/ค่าต่อไปนี้ในตาราง config เท่านั้น ฟังก์ชันนี้สามารถเรียกได้จาก Script และการเปลี่ยนแปลงจะถูกเรียกให้ทุกคลายเคลม
กุญแจ | คำอธิบาย | เริ่มต้น |
---|---|---|
useDefaultEmotes | ว่าจะมีอิโมจิที่กำหนดเรียบร้อยหรือไม่ | จริง |
useMegaEmotes | เปิด/ปิดคุณสมบัติ เมกะแอร์โมต | จริง |
emoteMinPlayers | ท่าทาง | 3 |
emoteMaxPlayers | จํานวนผู้เล่นสูงสุดที่เล่นเมโมเดียมเพื่อบริจาคให้กับเมโมเดียมใหญ่ | 50 |
playParticles | เปิดหรือปิดอิโมจิที่ผู้เล่นเล่นเป็นอนุภาคลอยอยู่เหนือหัวของพวกเขา | จริง |
sendContributingEmotes | เปิดหรือปิดการส่งไอคอนอีโมตเล็ก ๆ น้อย ๆ ท่าทาง | จริง |
สคริป
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.configureServer({emoteMinPlayers = 2,playParticles = false,})
กำหนดค่าลูกค้า
เปลี่ยนการตั้งค่าด้านล่างของตัวเรือผ่านคีย์/ค่าต่อไปนี้ในตาราง config ของ LocalScript ฟังก์ชันนี้สามารถเรียกได้จาก guiType เท่านั้น ขึ้นอยู่กับค่าของ 1>guityType
กุญแจ | คำอธิบาย | เริ่มต้น |
---|---|---|
guiType | การควบคุมที่เป็น GUI จะใช้เพื่อแสดงอารมณ์ (EmoteBar.GuiType). | EmoteBar เอมอตเมนต์ |
useTempo | เปิดหรือปิดคุณสมบัติ เวลา ซึ่งผู้ใช้สามารถควบคุมว่าอิโมจิของพวกเขาเล่นเร็วหรือช้าโดยการเปิดใช้งานเวลาเดียวกันอยู่เสมอ | จริง |
tempoActivationWindow | จำนวนเวลาในวินาทีที่ผู้ใช้มีระหว่างการเปิดใช้งานอิโมจิในช่วงเวลาที่นับเวลาในช่วงเวลา | 3 |
lockedImage | รูปภาพที่แสดงอยู่ด้านบนล็อคอิโมจิ | “ริบบอนเอสเซ็ตส์ไอดี://6905802778” |
สคริปต์ในเวลาท้องถิ่น - แถบ Emote
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.configureClient({guiType = EmoteBar.GuiType.EmoteBar,maxEmotesPerPage = 6,nextPageKey = Enum.KeyCode.Z,prevPageKey = Enum.KeyCode.C,})
สคริปต์ท้องถิ่น - ล้อเม็ด
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.configureClient({guiType = EmoteBar.GuiType.EmoteWheel,})
ใส่อิโมจิ
ตั้งค่าเมโมสามัคคีที่ใช้ได้ เหล่านี้จะถูกเพิ่มเข้ามาในค่าเริ่มต้นหาก useDefaultEmotes เป็นค่า true หรือแทนที่ค่าเริ่มต้นหาก
ดู Emote สำหรับสถานะของแต่ละ emote ที่ส่งมาให้ตัวนี้
สคริป - กำหนดอารมณ์
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.configureServer({useDefaultEmotes = false,})EmoteBar.setEmotes({{name = "Hello",animation = "rbxassetid://3344650532",image = "rbxassetid://7719817462",defaultTempo = 1,},{name = "Applaud",animation = "rbxassetid://5915693819",image = "rbxassetid://7720292217",defaultTempo = 2,},})
ตั้งค่าความโปร่งใสของ GUI
แสดงหรือซ่อนอิโมจิ GUI นี้ ฟังก์ชันนี้สามารถเรียกได้จาก LocalScript บนลูกค้าที่กำหนดเท่านั้น
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.setGuiVisibility(false)
รับอิโมต
รับ อีโมตเมื่อ โดยชื่อ กลับ nil หากอีโมตเมื่อไม่สามารถพบได้ ฟังก์ชันนี้สามารถเรียกได้จาก LocalScript บนลูกค้าที่กำหนดเท่านั้น
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))local shrug = EmoteBar.getEmote("Shrug")
เล่นอีโมต
เล่น อิโมจิ ที่ให้และเรียกอีเมนต์ เล่นอิโมจิ บนเซิร์ฟเวอร์ หากเชื่อมต่อ ฟังก์ชันนี้สามารถเรียกได้จาก LocalScript บนเซิร์ฟเวอร์ที่เฉพาะเท่านั้น
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))local shrug = EmoteBar.getEmote("Shrug")EmoteBar.playEmote(shrug)
ล็อคอิโมจิ
ล็อค อิโมจิ ด้วยชื่อที่กำหนด ฟังก์ชันนี้สามารถเรียกได้เฉพาะจาก LocalScript บนเครื่องคอมพิวเตอร์เท่านั้น
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.lockEmote("Applaud")
ปลดล็อคอีโมต
ปลดล็อก อิโมจิ ด้วยชื่อที่กำหนด ฟังก์ชันนี้สามารถเรียกได้เฉพาะจาก LocalScript บนเครื่องคอมพิวเตอร์เท่านั้น
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))EmoteBar.unlockEmote("Applaud")
เหตุการณ์
เอโมตเล่น
ท่าทางเหตุการณ์นี้สามารถเชื่อมต่อได้ใน LocalScript เท่านั้น
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.emotePlayed:Connect(function(player, emote)
print(player.Name, "played", emote.name)
end)
Emote ล็อค
เปิดในขณะที่ลูกค้าคลิกอีโมตเป็นล็อค อีเวนต์นี้สามารถเชื่อมต่อได้ใน LocalScript เท่านั้น
ตัวแปร | |
---|---|
ท่าทาง: อิโมจิ | ล็อคอิโมจิที่ถูกเปิดใช้งานแล้ว |
สคริปต์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")
local EmoteBar = require(ReplicatedStorage:WaitForChild("EmoteBar"))
EmoteBar.lockedEmoteActivated:Connect(function(emote)
print(Players.LocalPlayer, "clicked", emote.name)
end)