UserGameSettings
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
KullanıcıOyunAyarları, UserSettings tekil içinde bulunan bir tek sınıf sınıfıdır.Kullanıcının kamerasını ve karakterini nasıl kontrol etmek istediğiyle ilgili çeşitli kalıcı ayarları tutar.
Bu nesneye LocalScript aracılığıyla erişebilirsiniz:
Bu nesne yalnızca istemci üzerinde kullanılmak üzere tasarlanmıştır, çünkü sunucuda hiçbir amaç için kullanılmaz.Roblox Studio'da test sırasında kendi ayarlarınız da yansıtılacaktır.
Kod Örnekleri
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)Özet
Özellikler
Mevcut masaüstünde müşteri tarafından kullanılan kamera hareket modu.
Müşterinin masaüstünde kullandığı kontrol türü.
Müşterinin Fare Kilitleme Değişim modunu kullanıp kullanamayacağını değiştirir.
Bir oyun kolu kullanırken kameranın ne kadar hassas olduğunu tanımlar.
oyunmüşterisinin hacmini temsil eden 0 ile 1 arasında bir float.
Müşterinin kamerasının hassasiyetini temsil eden 0 ile 4 arasında bir yüzük.
Müşterinin karakterinin nasıl döndürüleceğini kontrol eder.
Client tarafından ayarlanan grafik kalite seviyesi.
Bir mobil cihazda bulunurken müşteri tarafından kullanılan kamera türü.
Mobil cihazda müşteri tarafından kullanılan kontrol türü.
Yöntemler
Kameranın Y-invert değerini döndürür.
Eğitimin tamamlandığını kontrol eder.
Kullanıcının Roblox penceresi tam ekran modundaysa gerçek döndürür.
Müşterinin oyun oturumu Roblox Studio'da ise gerçek döndürür.
Çağrıldığında, Roblox kullanıcının kamera eksenini tersine çevirmek için menü seçeneğini değiştirir.
Çağrıldığında, Roblox, kameranın hassasiyetini gamepadlerle kontrol etmek için menü seçeneğini değiştirir.
Onboarding'i tamamlandı olarak ayarlar.
Etkinlikler
Kullanıcının bütün ekran modu değiştirildiğinde ateş eder.
Kullanıcının istemcisi Studio modundan oyun moduna geçtiğinde ateş edilir. Bu, bir oturum başladığında Roblox Studio'da düzenli olarak ateş edilir.
Özellikler
AllTutorialsDisabled
CameraMode
ChatVisible
ComputerCameraMovementMode
Mevcut masaüstünde müşteri tarafından kullanılan kamera hareket modu.
ControlMode
Müşterinin Fare Kilitleme Değişim modunu kullanıp kullanamayacağını değiştirir.
Fullscreen
GamepadCameraSensitivity
Bir oyun kolu kullanırken kameranın ne kadar hassas olduğunu tanımlar.
GraphicsOptimizationMode
GraphicsQualityLevel
HasEverUsedVR
MasterVolumeStudio
MaxQualityEnabled
OnboardingsCompleted
PartyVoiceVolume
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
TouchCameraMovementMode
Bir mobil cihazda bulunurken müşteri tarafından kullanılan kamera türü.
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
Yöntemler
GetOnboardingCompleted
Verilen onboarding'in henüz tamamlandığını kontrol eder, bu da onboarding animasyonunu tekrar göstermekten kaçınmak için yararlıdır.
OnboardingId kabul edilen kimliklerden biri değilse bir hata atılır.
Onboarding süreci tek yönlüdür. Bu, bir geliştirici olarak, onboarding sürecini bitirmeye zorlayabileceğiniz, ancak sıfırlayamayacağınız anlamına gelir.
Ayrıca bakın:
- UserGameSettings:SetOnboardingCompleted() , eğitimi tamamlandı olarak ayarlar
Parametreler
Sorgulanacak onboarding kimliği.
Dönüşler
Özellikle eğitimin henüz bitip bitmediği.
InFullScreen
Kullanıcının Roblox penceresi tam ekran modundaysa gerçek döndürür.
Dönüşler
SetCameraYInvertVisible
Çağrıldığında, Roblox kullanıcının kamera eksenini tersine çevirmek için menü seçeneğini değiştirir.
Dönüşler
SetGamepadCameraSensitivityVisible
Çağrıldığında, Roblox, kameranın hassasiyetini gamepadlerle kontrol etmek için menü seçeneğini değiştirir.
Dönüşler
SetOnboardingCompleted
Verilen onboarding'i tamamlandı olarak ayarlar, böylece bir sonraki oynarken kullanıcıya tekrar gösterilmez.
Şu anda, bu işlev yalnızca DynamicThumbstick kabul ediyor ve oyuncunun Dynamic Thumbstick kontrol düzeneği için eğitimi bitirdiğini sürekli olarak izlemek için kullanılıyor.OnboardingId kabul edilen kimliklerden biri değilse bir hata atılır.
Onboarding süreci tek yönlüdür. Bu, bir geliştirici olarak, onboarding sürecini bitirmeye zorlayabileceğiniz, ancak sıfırlayamayacağınız anlamına gelir.
Ayrıca bakın:
- UserGameSettings:GetOnboardingCompleted() , eğitimin tamamlandığını kontrol eder
Parametreler
Tamamlandı olarak ayarlanacak eğitim kimliği.
Dönüşler
Etkinlikler
FullscreenChanged
Kullanıcının bütün ekran modu değiştirildiğinde ateş eder.Etkinlik yalnızca bütün ekran moduna geçebilen masaüstü cihazlarda ateşlenecektir.Oyun daima mobil cihazlarda ve konsollarda bütün ekranda olacaktır.
Parametreler
Kod Örnekleri
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
Kullanıcının istemcisi Studio modundan oyun moduna geçtiğinde ateş edilir. Bu, bir oturum başladığında Roblox Studio'da düzenli olarak ateş edilir.