UserGameSettings
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
การตั้งค่าเกมผู้ใช้เป็นคลาสสิงโลนที่พบภายในของ UserSettings สิงโลนเดียวมันเก็บการตั้งค่าถาวรต่างๆ ที่เกี่ยวข้องกับวิธีที่ผู้ใช้ต้องการควบคุมกล้องและตัวละครของพวกเขา
คุณสามารถเข้าถึงวัตถุนี้จาก LocalScript ผ่าน:
วัตถุนี้มีจุดมุ่งหมายเพื่อใช้บนไคลเอนต์เท่านั้น เนื่องจากไม่มีวัตถุประสงค์ในเซิร์ฟเวอร์นอกจากนี้ยังจะสะท้อนการตั้งค่าของคุณเองเมื่อทดสอบใน Roblox Studio
ตัวอย่างโค้ด
A basic example that shows how you can listen to changes in the user's settings. With this code pasted into a LocalScript running in the StarterPlayerScripts, you can change settings in Roblox's game menu, and see their values appear in the output as detected changes.
local gameSettings = UserSettings().GameSettings
local function onGameSettingChanged(nameOfSetting)
-- Fetch the value of this setting through a pcall to make sure we can retrieve it.
-- Sometimes the event fires with properties that LocalScripts can't access.
local canGetSetting, setting = pcall(function()
return gameSettings[nameOfSetting]
end)
if canGetSetting then
print("Your " .. nameOfSetting .. " has changed to: " .. tostring(setting))
end
end
gameSettings.Changed:Connect(onGameSettingChanged)สรุป
คุณสมบัติ
โหมดการเคลื่อนไหวของกล้องที่ใช้อยู่ในขณะนี้โดยไคลเอนต์บนเดสก์ท็อป
ประเภทของการควบคุมที่ใช้โดยคลายน์บนเดสก์ท็อป
สลับว่าลูกค้าสามารถใช้โหมดการล็อคเมาส์หรือไม่
อธิบายถึงความไวของกล้องเมื่อใช้ gamepad
ลอยระหว่าง 0 และ 1 ที่แทนที่ปริมาณของไคลเอนต์เกม
ลอยระหว่าง 0 และ 4 ที่แทนความไวของความไวของกล้องของไคลเอนต์
ควบคุมวิธีที่ตัวละครของไคลเอนต์หมุน
ระดับคุณภาพกราฟิกที่กำหนดโดยคลายเอนต์
ประเภทกล้องที่ใช้งานโดยลูกค้าในขณะที่อยู่บนอุปกรณ์เคลื่อนที่
ประเภทของการควบคุมที่ใช้โดยไคลเอนต์บนอุปกรณ์เคลื่อนที่
วิธีการ
restores ค่า Y-invert ของกล้อง
ตรวจสอบว่าการออนบอร์ดเสร็จสมบูรณ์แล้ว
ส่งคืนค่าจริงหากหน้าต่าง Roblox ของผู้ใช้อยู่ในโหมดเต็มหน้าจอ
ส่งคืนจริงหากเซสชันเกมของไคลเอนต์อยู่ใน Roblox Studio
หากเรียกใช้ Roblox จะสลับตัวเลือกเมนูเพื่อย้อนกลับแกนกล้องของผู้ใช้
หากเรียกใช้ Roblox จะสลับตัวเลือกเมนูเพื่อควบคุมความไวของกล้องด้วยเกมแพด
ตั้งการฝึกอบรมเสร็จสมบูรณ์
อีเวนต์
จะเกิดไฟไหม้ถ้าโหมดหน้าจอเต็มของผู้ใช้ถูกเปลี่ยนแปลง
ยิงเมื่อไคลเอนต์ของผู้ใช้สลับระหว่างโหมดสตูดิโอและโหมดในเกม สิ่งนี้จะถูกยิงเป็นระยะเวลาใน Roblox Studio เมื่อเซสชันเริ่มต้น
คุณสมบัติ
AllTutorialsDisabled
CameraMode
ChatVisible
ComputerCameraMovementMode
โหมดการเคลื่อนไหวของกล้องที่ใช้อยู่ในขณะนี้โดยไคลเอนต์บนเดสก์ท็อป
Fullscreen
GraphicsOptimizationMode
GraphicsQualityLevel
HasEverUsedVR
MasterVolumeStudio
MaxQualityEnabled
OnboardingsCompleted
PartyVoiceVolume
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
TouchCameraMovementMode
ประเภทกล้องที่ใช้งานโดยลูกค้าในขณะที่อยู่บนอุปกรณ์เคลื่อนที่
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
วิธีการ
GetOnboardingCompleted
ตรวจสอบว่าออนบอร์ดที่กำหนดไว้ถูกสรุปแล้วหรือยัง ซึ่งมีประโยชน์ในการหลีกเลี่ยงการแสดงอนิเมชั่นออนบอร์ดอีกครั้ง
หาก onboardingId ไม่ใช่หนึ่งในรหัสที่ยอมรับแล้วจะมีการโยนข้อผิดพลาด
กระบวนการออนบอร์ดมีทิศทางเดียว ซึ่งหมายความว่าในฐานะนักพัฒนาคุณสามารถบังคับให้กระบวนการออนบอร์ดสําเร็จได้ แต่ไม่สามารถรีเซ็ตได้
ดูเพิ่ม:
- UserGameSettings:SetOnboardingCompleted() ตั้งการฝึกอบรมเสร็จสมบูรณ์
พารามิเตอร์
ID ออนบอร์ดที่จะสอบถาม
ส่งค่ากลับ
ว่าการออนบอร์ดโดยเฉพาะจะเสร็จสมบูรณ์แล้วหรือยัง
SetCameraYInvertVisible
หากเรียกใช้ Roblox จะสลับตัวเลือกเมนูเพื่อย้อนกลับแกนกล้องของผู้ใช้
ส่งค่ากลับ
SetGamepadCameraSensitivityVisible
หากเรียกใช้ Roblox จะสลับตัวเลือกเมนูเพื่อควบคุมความไวของกล้องด้วยเกมแพด
ส่งค่ากลับ
SetOnboardingCompleted
ตั้งค่าการอบรมที่กำหนดให้เสร็จสิ้นเพื่อไม่ให้แสดงอีกครั้งให้กับผู้ใช้ในครั้งต่อไปที่พวกเขาเล่น
ปัจจุบันฟังก์ชันนี้รับ DynamicThumbstick เท่านั้น และใช้เพื่อติดตามอย่างต่อเนื่องว่าผู้เล่นได้สิ้นสุดการสอนใช้สำหรับสคริปต์การควบคุม Dynamic Thumbstick หรือไม่หาก onboardingId ไม่ใช่หนึ่งในรหัสที่ยอมรับแล้วจะมีการโยนข้อผิดพลาด
กระบวนการออนบอร์ดมีทิศทางเดียว ซึ่งหมายความว่าในฐานะนักพัฒนาคุณสามารถบังคับให้กระบวนการออนบอร์ดสําเร็จได้ แต่ไม่สามารถรีเซ็ตได้
ดูเพิ่ม:
- UserGameSettings:GetOnboardingCompleted() ตรวจสอบว่าการออนบอร์ดเสร็จสมบูรณ์แล้ว
พารามิเตอร์
รหัสออนบอร์ดที่ตั้งเป็นเสร็จสมบูรณ์
ส่งค่ากลับ
อีเวนต์
FullscreenChanged
จะเกิดไฟไหม้ถ้าโหมดหน้าจอเต็มของผู้ใช้ถูกเปลี่ยนแปลงอีเวนต์จะยิงเฉพาะในอุปกรณ์เดสก์ท็อปที่สามารถสลับโหมดหน้าจอเต็มได้เกมจะอยู่ในหน้าจอเต็มเสมอบนอุปกรณ์มือถือและคอนโซล
พารามิเตอร์
ตัวอย่างโค้ด
A LocalScript that demonstrates how you can detect whether a game is in full screen or not.
local gameSettings = UserSettings().GameSettings
local function checkFullScreenMode()
local inFullscreen = gameSettings:InFullScreen()
if inFullscreen then
print("Full Screen mode enabled!")
else
print("Full Screen mode disabled!")
end
end
checkFullScreenMode()
gameSettings.FullscreenChanged:Connect(checkFullScreenMode)StudioModeChanged
ยิงเมื่อไคลเอนต์ของผู้ใช้สลับระหว่างโหมดสตูดิโอและโหมดในเกม สิ่งนี้จะถูกยิงเป็นระยะเวลาใน Roblox Studio เมื่อเซสชันเริ่มต้น