โหมดเซลฟี่

ผู้เล่นแล้วใช้สกรีนช็อตเพื่อระลึกถึงช่วงเวลาสนุกในประสบการณ์แล้วโหมดเซลฟี่ SelfieMode โมดูลนักพัฒนา ช่วยให้ผู้เล่นบันทึกความทรงจําที่สะอาดขึ้นในช่วงเวลานั้นโดยไม่มีหน้าต่างแชทหรือรายชื่อผู้เล่น ในขณะเดียวกันก็สนับสนุนเอฟเฟกต์การกรอง การซ่อนตัวละครอื่น ๆ และการโพสต์

การใช้งานโมดูล

การติดตั้ง

เพื่อใช้โมดูล โหมดเซลฟี่ ในประสบการณ์:

จากแท็บ ดู เปิด กล่องเครื่องมือ และเลือกแท็บ ร้านค้าผู้สร้าง
ตรวจสอบให้แน่ใจว่าการจัดเรียง รูปแบบ ถูกเลือกแล้วคลิกที่ปุ่ม ดูทั้งหมด สำหรับ หมวดหมู่
ค้นหาและคลิกที่แท็บ โมดูลพัฒนา
ค้นหาโมดูล โหมดเซลฟี่ และคลิกหรือลากลงไปในมุมมอง 3D
ในหน้าต่าง สํารวจ เคลื่อนย้ายรูปแบบทั้งหมดของ SelfieMode ไปยัง ServerScriptService เมื่อเรียกใช้ประสบการณ์แล้ว โมดูลจะแจกจ่ายตัวเองไปยังบริการต่างๆ และเริ่มทำงาน

การกำหนดค่า

โมดูลจะได้รับการกำหนดค่าล่วงหน้าเพื่อทำงานสำหรับกรณีการใช้งานส่วนใหญ่ แต่คุณสามารถปรับแต่งได้ง่ายผ่านฟังก์ชัน กำหนดค่า

ใน StarterPlayerScripts สร้างใหม่ LocalScript และเปลี่ยนชื่อเป็น กำหนดโหมดการเซลฟี่ 2. ใส่โค้ดต่อไปนี้ลงในสคริปต์ใหม่

สคริปท์ท้องถิ่น - กำหนดโหมดเซลฟี่
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.configure({
	disableCharacterMovement = true
})

การเคลื่อนที่ของตัวละคร

อาจเป็นประโยชน์ในการป้องกันไม่ให้ตัวละครของผู้เล่นเคลื่อนที่ในโหมดเซลฟี่คุณสามารถบรรลุสิ่งนี้โดยการตั้งค่า disableCharacterMovement เป็นจริงในการโทร กำหนดค่า

สคริปท์ท้องถิ่น - กำหนดโหมดเซลฟี่
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.configure({
	disableCharacterMovement = true
})

การดำเนินการโหมดเซลฟี่

โหมดเซลฟี่ มาพร้อมกับการดำเนินการต่อไปนี้ แต่ละคนสามารถใช้งานได้ด้วยฟังก์ชัน activateAction , deactivateAction และ toggleAction หรือตรวจพบผ่านเหตุการณ์ actionActivated และ actionDeactivated

ความลึกของฟิลด์

โดยค่าเริ่มต้น โหมดเซลฟี่ จะแสดงเอฟเฟกต์ทั่วไป ความลึกของฟิลด์ (ความละเอียดของพื้นหลัง) แอ็คชัน

เอฟเฟกต์นี้ไม่แสดงบนอุปกรณ์เคลื่อนที่เช่นโทรศัพท์และแท็บเล็ตดังนั้นจะไม่ถูกเสนอให้เป็นการดำเนินการบนอุปกรณ์เหล่านั้น:

บนอุปกรณ์ที่ไม่ใช่มือถือคุณภาพกราฟิกของผู้เล่น ( การตั้งค่า → คุณภาพกราฟิก ) ต้องเป็นแปดหรือสูงกว่าเพื่อแสดงความลึกของฟิลด์หากคุณภาพกราฟิกของพวกเขาน้อยกว่าแปดพวกเขาจะถูกขอให้เพิ่มขึ้น

เพื่อเปลี่ยนเอฟเฟกต์ความลึกของฟิลด์เริ่มต้นให้ตั้ง depthOfFieldEffect เป็นตัวอย่างของคุณเองในการเรียก DepthOfFieldEffect ในการกำหนดค่า คอนฟิก

สคริปท์ท้องถิ่น - กำหนดโหมดเซลฟี่
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local customDepthOfField = Instance.new("DepthOfFieldEffect")
customDepthOfField.NearIntensity = 0
customDepthOfField.FarIntensity = 1
customDepthOfField.FocusDistance = 5
customDepthOfField.InFocusRadius = 5

SelfieMode.configure({
	depthOfFieldEffect = customDepthOfField
})

ล็อคสายตา

การเปิดใช้งาน ล็อคสายตา ทำให้ตัวละครของผู้เล่นมองกล้องในขณะที่ตั้งค่าโพสต์ selfie ภายในระยะที่เป็นจริงของวิธีที่คอของพวกเขาสามารถหมุนได้

ซ่อนคนอื่น

โดยค่าเริ่มต้นตัวอักษรอื่นๆ จะปรากฏข้างสัญลักษณ์ของผู้เล่นผู้เล่นสามารถรับการยิงเดี่ยวที่สมบูรณ์แบบได้โดยคลิกที่ปุ่ม ซ่อนคนอื่น เมื่อเปิดใช้งานแล้ว ตัวละครอื่นจะหายไปจากสายตาและยังคงไม่สามารถมองเห็นได้จนกว่าจะปิดใช้งานการดำเนินการ

กรอง

การดำเนินการ กรอง ช่วยให้ผู้เล่นสามารถใช้กรองล่วงหน้าจากตัวเลือก ป๊อป อ่อนโยน โบราณ น่ารัก ดราม่า และ ขาวดำ

โพส

การดำเนินการ โพส ทำให้ผู้เล่นสามารถเลือกโพสต์ล่วงหน้าจากตัวเลือก เชียร์ ปรบมือ ปลาโลมา ฟลอส กีตาร์ คลื่นกระโดด เพิ่มเสียงตะโกน และ กระบวนท่าวิปริต และ คลื่น

คู่มือ เอกสารอ้างอิงเกี่ยวกับ API

ประเภท

การดำเนินการ

แต่ละการดำเนินการจะถูกแทนที่ด้วยสารบัญที่มีคู่คีย์-ค่าต่อไปนี้:

กุญแจ	ประเภท	คําอธิบาย
name	สตริง	แอ็คชัน
description	สตริง	คําอธิบายของการกระทําที่แสดงหลังจาก ชื่อ ในคําอธิบายเครื่องมือ
icon	สตริง	แอ็คชัน
activeIcon	สตริง	แอ็คชัน"ใช้งาน" สามารถใช้ได้เฉพาะกับการกระทำของพ่อเท่านั้น ไม่ใช่การกระทำรอง
actions	ตาราง	รายการตัวเลือกของการกระทําย่อย ซึ่งช่วยให้คุณสามารถสร้างเมนูย่อยของการกระทําอื่น ๆ ได้
parent	การดำเนินการ	แอ็คชัน; สิ่งนี้ใช้ได้เฉพาะกับการกระทําย่อยและชี้ไปที่การกระทําที่มีมัน
onActivated	ฟังก์ชัน	ฟังก์ชันการโทรกลับทางเลือกที่ทำงานเมื่อผู้เล่นเปิดใช้งานการดำเนินการหรือส่วนการดำเนินการโดยปกติแล้ว หากการดำเนินการมีส่วนปฏิบัติย่อย เฉพาะส่วนปฏิบัติย่อยเท่านั้นที่จะต้องการการโทรกลับที่กำหนดเป็นวิธีการทราบว่าผู้เล่นได้เปิดใช้งานส่วนปฏิบัติย่อยและไม่ได้เพียงแค่ "ขยาย" แอ็คชัน

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.actionActivated:Connect(function(action)
	print(action.name, "activated")
end)

SelfieMode.actionDeactivated:Connect(function(action)
	print(action.name, "deactivated")
end)

เอนุม

การกระทำ SelfieMode.Action

โหมดเซลฟี่ มาพร้อมกับหลาย การกระทำคุณสามารถใช้รายการนี้กับ activateAction , deactivateAction และ toggleAction ฟังก์ชัน

ชื่อ	สรุป
DepthOfField	การอ้างอิงถึงการดำเนินการ แอ็คชัน
LockGaze	การอ้างอิงถึงการดำเนินการ ล็อคสายตา
HideOthers	แอ็คชันซ่อนคนอื่น
Filter	แอ็คชันกรอง
Pose	แอ็คชันโพส

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

-- เปิดใช้งานการดำเนินการ "กรอง"
SelfieMode.activateAction(SelfieMode.Action.Filter)

ฟังก์ชัน

กำหนดค่า

กำหนดค่า (config: table )

ยกเลิกตัวเลือกการกำหนดค่าเริ่มต้นผ่านตัวแปรหรือค่าต่อไปนี้ในตาราง config ด้วยคีย์/ค่าฟังก์ชันนี้สามารถโทรได้เฉพาะจาก LocalScript

กุญแจ	คําอธิบาย	ค่าเริ่มต้น
disableCharacterMovement	ถ้าเป็นจริง จะป้องกันไม่ให้ตัวละครเคลื่อนที่ในขณะที่โหมดเซลฟี่เปิดอยู่	ปิด
depthOfFieldEffect	กำหนดเองได้ DepthOfFieldEffect ตัวอย่างที่ปรากฏเมื่อผู้เล่นสลับการดำเนินการ ความลึกของฟิลด์

สคริปท์ท้องถิ่น - กำหนดโหมดเซลฟี่
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.configure({
	disableCharacterMovement = true
})

เปิดโหมดเซลฟี่

เปิดโหมด Selfie()

ผู้เล่นมักจะเปิดโหมดเซลฟี่ด้วยปุ่ม "กล้อง" ที่ด้านขวาของหน้าจอ แต่ฟังก์ชันนี้ช่วยให้คุณสามารถเปิดได้ผ่านรหัสเมื่อใช้ปุ่มที่กําหนดเองตามที่แสดงด้านล่าง คุณควรปิดการใช้งานปุ่มเริ่มต้นผ่าน setHudButtonEnabledฟังก์ชันนี้สามารถโทรได้เฉพาะจาก LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local button = script.Parent

-- ลบปุ่มเริ่มต้น
SelfieMode.setHudButtonEnabled(false)

-- เชื่อมต่อปุ่มกำหนดเอง
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

ปิดโหมดเซลฟี่

ปิดโหมดเซลฟี่()

ผู้เล่นมักจะปิดโหมดเซลฟี่ด้วยปุ่ม ⊗ ที่ด้านล่างของหน้าจอ แต่ฟังก์ชันนี้ช่วยให้คุณสามารถปิดได้ผ่านโค้ดสามารถเรียกได้เฉพาะจาก LocalScript เท่านั้น

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.closeSelfieMode()

เปิดโหมดเซลฟี่หรือไม่

เปิดโหมดเซลฟี่ได้แล้ว: boolean

ส่งคืน true หากโหมดเซลฟี่เปิดเป็นผลจากการกระทำของผู้เล่นหรือผ่าน openSelfieModeฟังก์ชันนี้สามารถโทรได้เฉพาะจาก LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.openSelfieMode()

print(SelfieMode.isSelfieModeOpen())

ตั้งค่าปุ่ม Hud เปิดใช้งาน

ตั้งค่าปุ่ม Hud เปิดใช้งาน()

ตั้งค่าว่าปุ่มเริ่มต้นที่จะเข้าสู่โหมดเซลฟีจะแสดงหรือไม่มีประโยชน์เมื่อใช้ openSelfieMode ผ่านปุ่ม UI ที่กําหนดเองฟังก์ชันนี้สามารถโทรได้เฉพาะจาก LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local button = script.Parent

-- ลบปุ่มเริ่มต้น
SelfieMode.setHudButtonEnabled(false)

-- เชื่อมต่อปุ่มกำหนดเอง
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

รับการดำเนินการ

รับการกระทำ(แอ็คชัน: SelfieMode.Action ): การกระทำ

ได้รับประเภทการดำเนินการ Action ผ่าน enum SelfieMode.Action

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

เปิดใช้งานการกระทํา

เปิดใช้งานการกระทำ (แอ็คชัน: SelfieMode.Action )

เปิดใช้งานโปรแกรมอย่างต่อเนื่องหนึ่งในการดำเนินการเริ่มต้น actionsนี่เป็นเหมือนกับเมื่อผู้เล่นสลับการดำเนินการจากแถบการกระทำสามารถเรียกได้เฉพาะจาก LocalScript เท่านั้น

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

-- เปิดใช้งานการดำเนินการ "กรอง"
SelfieMode.activateAction(SelfieMode.Action.Filter)

ปิดใช้งานการกระทำ

ปิดใช้งานการกระทำ (แอ็คชัน: SelfieMode.Action )

ปิดใช้งานหนึ่งในการดำเนินการเริ่มต้น อย่างโปรแกรมนี่เป็นเหมือนกับเมื่อผู้เล่นสลับการดำเนินการออกจากแถบการดำเนินการสามารถเรียกได้เฉพาะจาก LocalScript เท่านั้น

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

-- ปิดใช้งานการดำเนินการ "กรอง"
SelfieMode.deactivateAction(SelfieMode.Action.Filter)

เปิด/ปิดการกระทํา

เปิด/ปิดการกระทำ(การกระทำ: SelfieMode.Action ): boolean

สลับการดำเนินการ ในกรณีที่ปิด หรือสลับการปิดหากเปิดนี่เป็นเช่นเดียวกับเมื่อผู้เล่นคลิกที่การดำเนินการจากแถบการดำเนินการคืนสถานะใหม่ "เปิดใช้งาน" เป็นบูลีนสามารถเรียกได้เฉพาะจาก LocalScript เท่านั้น

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

local isEnabled = SelfieMode.toggleAction(lockGazeAction)

if isEnabled then
	print("Activated", lockGazeAction.name)
else
	print("Deactivated", lockGazeAction.name)
end

ตั้งธีม

ตั้งธีม(ธีม: table )

กำหนดธีมโหมดเซลฟี่รวมถึงขนาดข้อความฟอนต์ปุ่ม/การชี้แจงสีและอื่นๆ ฟังก์ชันนี้สามารถเรียกได้เฉพาะจาก LocalScript

กุญแจ	คําอธิบาย	ค่าเริ่มต้น
textSize	ขนาดของข้อความทั้งหมด	16
font	ฟอนต์ที่ใช้กับ UI ทั้งหมด ( Enum.Font ).	GothamMedium
padding	การเว้นวรรคหลักที่ใช้สำหรับวางองค์ประกอบ UI ( UDim ).	(0, 12)
paddingSmall	การเว้นวรรคขนาดเล็กที่ใช้สำหรับการใช้ช่องว่างละเอียดระหว่างองค์ประกอบ ( UDim ).	(0, 6)
paddingScreen	การเว้นวรรคที่ใช้รอบขอบหน้าจอเพื่อให้โหมดเซลฟี่มีพื้นที่หายใจ ( UDim )	(0, 24)
backgroundColor	สีพื้นหลังที่ใช้สำหรับแถบที่แสดงการดำเนินการ ( Color3 )	[0, 0, 0]
scrollBarColor	สีของแถบเลื่อนที่ใช้ในองค์ประกอบ ScrollingFrame ของโมดูล ( Color3 )	[255, 255, 255]

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.setTheme({
	textSize = 20,
	font = Enum.Font.Michroma,
	backgroundColor = Color3.fromRGB(0, 40, 75),
})

ตั้งค่าเปิดใช้งาน

ตั้งค่าเปิดใช้งาน (isEnabled: boolean )

ตั้งค่าว่าโหมดเซลฟี่จะเปิดใช้งานหรือไม่เมื่อปิดใช้งานแล้ว จะลบ UI ทั้งหมดสำหรับโมดูลและเหตุการณ์ทั้งหมดจะถูกตัดการเชื่อมต่อฟังก์ชันนี้สามารถโทรได้เฉพาะจาก LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.setEnabled(false)

อีเวนต์

โหมดเซลฟี่เปิดแล้ว

จะเกิดไฟไหม้เมื่อผู้เล่นเปิดโหมดเซลฟี่หรือเมื่อ openSelfieMode ถูกเรียกใช้ อีเวนต์นี้สามารถเชื่อมต่อได้เฉพาะใน LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.selfieModeOpened:Connect(function()
	print("Selfie mode open")
end)

โหมดเซลฟี่ปิด

จะเกิดไฟไหม้เมื่อผู้เล่นปิดโหมดเซลฟี่หรือเมื่อ closeSelfieMode ถูกเรียกใช้ อีเวนต์นี้สามารถเชื่อมต่อได้เฉพาะใน LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.selfieModeClosed:Connect(function()
	print("Selfie mode closed")
end)

การดำเนินการเปิดใช้งาน

พารามิเตร
แอ็คชัน: SelfieMode.Action	การกระตุ้น การดำเนินการ ที่เปิดใช้งาน

จะเกิดไฟเมื่อการดำเนินการถูกเปิดใช้งาน; อาจเป็นหนึ่งในการกระทำหลักเช่น ความลึกของฟิลด์ , ล็อคสายตา หรือ ซ่อนคนอื่น ; หรืออาจเป็นการกระทำรองเช่น ฟิลเตอร์ หรือ โพสฟังก์ชันที่เชื่อมต่อได้รับการกระตุ้น การดำเนินการ .อีเวนต์นี้สามารถเชื่อมต่อได้เฉพาะใน LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.actionActivated:Connect(function(action)
	print(action.name, "activated")
end)

การกระทําถูกปิดใช้งาน

พารามิเตร
แอ็คชัน: SelfieMode.Action	การปิดใช้งาน การดำเนินการ ถูกปิดใช้งาน

เกิดไฟไหม้เมื่อการดำเนินการหลักหรือส่วนย่อยถูกปิดใช้งานฟังก์ชันที่เชื่อมต่อได้รับการปิดใช้งาน การดำเนินการ ที่ถูกปิดใช้งานอีเวนต์นี้สามารถเชื่อมต่อได้เฉพาะใน LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.actionDeactivated:Connect(function(action)
	print(action.name, "deactivated")
end)

กรองเปลี่ยนแปลง

พารามิเตร
ตัวกรองใหม่: string	ตัวกรองใหม่
กรองเก่า: string	ตัวกรองก่อนหน้านี้

จะเกิดไฟไหม้เมื่อฟิลเตอร์ ถูกใช้หรือลบออกฟังก์ชันที่เชื่อมต่อได้รับชื่อฟิลเตอร์ใหม่และชื่อฟิลเตอร์เก่าอีเวนต์นี้สามารถเชื่อมต่อได้เฉพาะใน LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.filterChanged:Connect(function(newFilter, oldFilter)
	print("Filter changed from", oldFilter, "to", newFilter)
end)

เปลี่ยนตําแหน่งแล้ว

พารามิเตร
ท่าใหม่: string	ท่าใหม่
โพสเก่า: string	ท่าที่เกิดก่อนหน้านี้

จะเกิดไฟไหม้เมื่อใช้หรือลบโพส ฟังก์ชันที่เชื่อมต่อได้รับชื่อโพสต์ใหม่และชื่อโพสต์เก่าอีเวนต์นี้สามารถเชื่อมต่อได้เฉพาะใน LocalScript

สคริปท์ท้องถิ่น
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.poseChanged:Connect(function(newPose, oldPose)
	print("Pose changed from", oldPose, "to", newPose)
end)

ในหน้านี้