UserGameSettings
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Cài đặt trò chơi người dùng là một lớp duy nhất được tìm thấy bên trong của UserSettings singleton.Nó giữ nhiều cài đặt lâu dài liên quan đến cách người dùng muốn kiểm soát máy ảnh và nhân vật của họ.
Bạn có thể truy cập đối tượng này từ một LocalScript qua:
Vật phẩm này dự định chỉ được sử dụng trên khách hàng, vì nó không phục vụ mục đích gì trên máy chủ.Nó cũng sẽ phản ánh cài đặt riêng của bạn khi kiểm tra trong Roblox Studio.
Mẫu mã
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)Tóm Tắt
Thuộc Tính
Chế độ di chuyển máy ảnh hiện đang được sử dụng bởi khách hàng trên máy tính.
Loại điều khiển đang được sử dụng bởi khách hàng trên máy tính.
Bật/tắt việc khách hàng có thể sử dụng chế độ Chuyển đổi chế độ Khóa chuột hay không.
Mô tả mức độ nhạy cảm của máy ảnh khi sử dụng gamepad.
Một float giữa 0 và 1 đại diện cho khối lượng của khách hàng trò chơi.
Một float giữa 0 và 4 đại diện cho độ nhạy của độ nhạy máy ảnh của khách hàng.
Kiểm soát cách nhân vật của khách hàng được xoay.
Cấp độ chất lượng đồ họa được thiết lập bởi khách hàng.
Loại camera đang sử dụng bởi khách hàng trong khi ở trên thiết bị di động.
Loại điều khiển đang được sử dụng bởi khách hàng trên thiết bị di động.
Phương Pháp
Trả giá trị Y-invert của máy ảnh.
Kiểm tra xem đã hoàn thành onboarding chưa.
Trả về true nếu cửa sổ Roblox của người dùng ở chế độ màn hình toàn màn.
Trả về true nếu phiên trò chơi của khách hàng ở trong Roblox Studio.
Nếu được gọi, Roblox chuyển đổi tùy chọn menu để đảo ngược trục camera của người dùng.
Nếu được gọi, Roblox chuyển đổi tùy chọn menu để kiểm soát độ nhạy của camera với gamepad.
Đặt onboarding hoàn thành.
Sự Kiện
Bắt lửa nếu chế độ màn hình toàn màn của người dùng được thay đổi.
Bị bắn khi khách hàng của người dùng chuyển đổi giữa chế độ Studio và chế độ trong trò chơi. Điều này được bắn theo chu kỳ trong Roblox Studio khi một phiên bắt đầu.
Thuộc Tính
AllTutorialsDisabled
CameraMode
ChatVisible
ComputerCameraMovementMode
Chế độ di chuyển máy ảnh hiện đang được sử dụng bởi khách hàng trên máy tính.
ComputerMovementMode
Loại điều khiển đang được sử dụng bởi khách hàng trên máy tính.
ControlMode
Bật/tắt việc khách hàng có thể sử dụng chế độ Chuyển đổi chế độ Khóa chuột hay không.
Fullscreen
GraphicsOptimizationMode
GraphicsQualityLevel
HasEverUsedVR
MasterVolumeStudio
MaxQualityEnabled
MouseSensitivity
Một float giữa 0 và 4 đại diện cho độ nhạy của độ nhạy máy ảnh của khách hàng.
OnboardingsCompleted
PartyVoiceVolume
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
TouchCameraMovementMode
Loại camera đang sử dụng bởi khách hàng trong khi ở trên thiết bị di động.
TouchMovementMode
Loại điều khiển đang được sử dụng bởi khách hàng trên thiết bị di động.
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
Phương Pháp
GetOnboardingCompleted
Kiểm tra xem có đã hoàn thành onboarding được cung cấp hay chưa, có ích để tránh hiển thị lại hoạt họa onboarding.
Nếu onboardingId không phải là một trong những ID được chấp nhận, một lỗi được ném ra.
Quá trình hòa nhập là một chiều. Điều này có nghĩa là, với tư cách là một nhà phát triển, bạn có thể buộc quá trình hòa nhập hoàn thành nhưng không thể đặt lại nó.
Xem thêm:
- UserGameSettings:SetOnboardingCompleted() , thiết lập onboarding hoàn thành
Tham Số
ID onboarding để hỏi.
Lợi Nhuận
Liệu có hoàn thành onboarding đặc biệt hay chưa.
InFullScreen
Trả về true nếu cửa sổ Roblox của người dùng ở chế độ màn hình toàn màn.
Lợi Nhuận
InStudioMode
Trả về true nếu phiên trò chơi của khách hàng ở trong Roblox Studio.
Lợi Nhuận
SetCameraYInvertVisible
Nếu được gọi, Roblox chuyển đổi tùy chọn menu để đảo ngược trục camera của người dùng.
Lợi Nhuận
SetGamepadCameraSensitivityVisible
Nếu được gọi, Roblox chuyển đổi tùy chọn menu để kiểm soát độ nhạy của camera với gamepad.
Lợi Nhuận
SetOnboardingCompleted
Đặt onboarding được cho là hoàn thành, vì vậy nó sẽ không được hiển thị lại cho người dùng lần tiếp theo họ chơi.
Hiện tại, chức năng này chỉ chấp nhận DynamicThumbstick , và nó được sử dụng để theo dõi liên tục xem có hay không có người chơi đã hoàn thành hướng dẫn cho cơ chế điều khiển Dynamic Thumbstick.Nếu onboardingId không phải là một trong những ID được chấp nhận, một lỗi được ném ra.
Quá trình hòa nhập là một chiều. Điều này có nghĩa là, với tư cách là một nhà phát triển, bạn có thể buộc quá trình hòa nhập hoàn thành nhưng không thể đặt lại nó.
Xem thêm:
- UserGameSettings:GetOnboardingCompleted() , kiểm tra xem đã hoàn thành onboarding chưa
Tham Số
ID onboarding để đặt là hoàn thành.
Lợi Nhuận
Sự Kiện
FullscreenChanged
Bắt lửa nếu chế độ màn hình toàn màn của người dùng được thay đổi.Sự kiện chỉ sẽ bắt lửa trên các thiết bị máy tính có thể chuyển đổi chế độ màn hình toàn màn.Trò chơi sẽ luôn ở trong toàn màn hình trên các thiết bị di động và bảng điều khiển.
Tham Số
Mẫu mã
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
Bị bắn khi khách hàng của người dùng chuyển đổi giữa chế độ Studio và chế độ trong trò chơi. Điều này được bắn theo chu kỳ trong Roblox Studio khi một phiên bắt đầu.