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.
The UserGameSettings là một lớp singleton được tìm thấy bên trong của singleton Class.UserSettings. Nó giữ các cài đặt persistente liên quan đến cách người dùng muốn điều khiển máy ảnh của họ và nhân vật của họ.
Bạn có thể truy cập vào đối tượng này từ một LocalScript thông qua:
Đối tượng này chỉ được đưa ra trên máy chủ, vì nó không phục vụ mục đích trên máy chủ. Nó cũng sẽ phản ánh cài đặt của riêng bạn khi thử nghiệm trong Roblox Studio.
Mẫu mã
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 xách tay.
Loại các nút được sử dụng bởi khách hàng trên máy tính xách tay.
Bật/tắt chế độ Khoá chuột trên máy chủ.
Mô tả độ nhạy của máy ảnh khi sử dụng gamepad.
Một float giữa 0 và 1 diễn tả khối lượng của client trò chơi.
Một float giữa 0 và 4 diễn tả độ nhạy của camera khách hàng.
Điều khiển cách nhân vật của client được quay.
Cấu hình chất lượng đồ họa của khách hàng.
Loại máy ảnh đang được sử dụng bởi khách hàng trên thiết bị di động.
Loại các nút được sử dụng bởi khách hàng trên một 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 hay chưa quá trình onboarding.
Trả lại true nếu cửa sổ Roblox của người dùng đang ở chế độ màn hình đầy đủ.
Trả về true nếu phiên bản trò chơi của khách hàng ở trong Roblox Studio.
Nếu được gọi, Roblox sẽ bật/tắt tùy chọn menu để đổi hướng camera của người dùng.
Nếu được gọi, Roblox sẽ bật/tắt tùy chọn menu để điều khiển độ nhạy của máy ảnh với gamepads.
Đặt onboarding hoàn tất.
Sự Kiện
Kích hoạt nếu chế độ màn hình đầy của người dùng được thay đổi.
Được kích hoạt khi client của người dùng chuyển giữa chế độ studio và chế độ trong game. Điều này được kích hoạt theo thời gian thực tế 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 xách tay.
ComputerMovementMode
Loại các nút được sử dụng bởi khách hàng trên máy tính xách tay.
Fullscreen
GraphicsOptimizationMode
GraphicsQualityLevel
HasEverUsedVR
MasterVolumeStudio
MaxQualityEnabled
OnboardingsCompleted
PartyVoiceVolume
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
TouchCameraMovementMode
Loại máy ảnh đang được sử dụng bởi khách hàng trên thiết bị di động.
TouchMovementMode
Loại các nút được sử dụng bởi khách hàng trên một thiết bị di động.
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
Phương Pháp
GetOnboardingCompleted
Kiểm tra xem đã hoàn thành hay chưa màn hướng dẫn đã được cung cấp, tốt hơn là 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 sẽ được ném.
Quá trình onboarding là một chiều. Điều này có nghĩa là, như một nhà phát triển, bạn có thể buộc quá trình onboarding hoàn tất nhưng không thể thiết lập lại nó.
Xem thêm:
- UserGameSettings:SetOnboardingCompleted() , thiết lập onboarding như hoàn thành
Tham Số
ID onboarding để hỏi về.
Lợi Nhuận
Dù có phải hoàn thành onboarding riêng lẻ hay không.
InFullScreen
Trả lại true nếu cửa sổ Roblox của người dùng đang ở chế độ màn hình đầy đủ.
Lợi Nhuận
InStudioMode
Trả về true nếu phiên bản trò chơi của khách hàng ở trong Roblox Studio.
Lợi Nhuận
SetCameraYInvertVisible
Nếu được gọi, Roblox sẽ bật/tắt tùy chọn menu để đổi hướng camera của người dùng.
Lợi Nhuận
SetGamepadCameraSensitivityVisible
Nếu được gọi, Roblox sẽ bật/tắt tùy chọn menu để điều khiển độ nhạy của máy ảnh với gamepads.
Lợi Nhuận
SetOnboardingCompleted
Đặt onboarding đã được 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ỉ hỗ trợ DynamicThumbstick, và nó được sử dụng để theo dõi kiên trì có hay không người chơi đã hoàn thành hướng dẫn cho các điều khiển của Dynamic Thumbstick. Nếu onboardingId không phải là một trong những ID được hỗ trợ, một lỗi sẽ được ném
Quá trình onboarding là một chiều. Điều này có nghĩa là, như một nhà phát triển, bạn có thể buộc quá trình onboarding hoàn tất nhưng không thể thiết lập lại nó.
Xem thêm:
- UserGameSettings:GetOnboardingCompleted() , kiểm tra xem có phải hoàn thành onboarding hay không
Tham Số
ID onboarding để đặt là hoàn thành.
Lợi Nhuận
Sự Kiện
FullscreenChanged
Kích hoạt nếu chế độ màn hình đầy đủ của người dùng được thay đổi. Sự kiện sẽ chỉ kích hoạt trên các thiết bị desktop mà có thể bật/tắt chế độ màn hình đầy đủ. Game sẽ luôn ở trong màn hình đầy đủ trên các thiết bị mobile và máy chủ.
Tham Số
Mẫu mã
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
Được kích hoạt khi client của người dùng chuyển giữa chế độ studio và chế độ trong game. Điều này được kích hoạt theo thời gian thực tế trong Roblox Studio khi một phiên bắt đầu.