Unity-Technologies/UnityCsReference · error · NotSupportedException

PlayerSettings.phoneSplashScreenImageScale240 is deprecated.

Error message

PlayerSettings.phoneSplashScreenImageScale240 is deprecated. Use SetVisualAssetsImage() instead.

What it means

PlayerSettings.WSA.phoneSplashScreenImageScale240 was a string property whose setter assigned the Windows Phone splash screen image at 240% DPI scale. Unity replaced all per-scale visual asset setters with SetVisualAssetsImage(image, WSAImageType, WSAImageScale). The [Obsolete(..., true)] flag makes direct usage a compile error; the runtime NotSupportedException catches reflection-based writes.

Source

Thrown at Editor/Mono/PlayerSettingsWSA.cs:699

                    throw new NotSupportedException("PlayerSettings.phoneSplashScreenImageScale140 is deprecated. Use GetVisualAssetsImage() instead.");
                }
                set
                {
                    throw new NotSupportedException("PlayerSettings.phoneSplashScreenImageScale140 is deprecated. Use SetVisualAssetsImage() instead.");
                }
            }

            [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
            [Obsolete("Use GetVisualAssetsImage()/SetVisualAssetsImage()", true)]
            public static string phoneSplashScreenImageScale240
            {
                get
                {
                    throw new NotSupportedException("PlayerSettings.phoneSplashScreenImageScale240 is deprecated. Use GetVisualAssetsImage() instead.");
                }
                set
                {
                    throw new NotSupportedException("PlayerSettings.phoneSplashScreenImageScale240 is deprecated. Use SetVisualAssetsImage() instead.");
                }
            }

            [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
            [Obsolete("Use GetVisualAssetsImage()/SetVisualAssetsImage()", true)]
            public static string packageLogo140
            {
                get
                {
                    throw new NotSupportedException("PlayerSettings.packageLogo140 is deprecated. Use GetVisualAssetsImage() instead.");
                }
                set
                {
                    throw new NotSupportedException("PlayerSettings.packageLogo140 is deprecated. Use SetVisualAssetsImage() instead.");
                }
            }

            [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]

View on GitHub (pinned to 225b0fbdb5)

Solutions

Replace the setter with PlayerSettings.WSA.SetVisualAssetsImage(path, WSAImageType.SplashScreenImage, WSAImageScale._240)
Migrate to UWP-supported scales (_100, _125, _150, _200) since _240 is deprecated for UWP
Recompile all editor scripts to catch remaining [Obsolete] errors

Example fix

// before
PlayerSettings.WSA.phoneSplashScreenImageScale240 = "Assets/Splash/splash240.png";

// after
PlayerSettings.WSA.SetVisualAssetsImage("Assets/Splash/splash.png", WSAImageType.SplashScreenImage, WSAImageScale._200);

Defensive patterns

Strategy: validation

Validate before calling

var prop = typeof(PlayerSettings.WSA).GetProperty("phoneSplashScreenImageScale240");
if (prop?.GetCustomAttribute<System.ObsoleteAttribute>()?.IsError == true)
    Debug.LogError("Property is obsolete. Use SetVisualAssetsImage() instead.");

Try / catch

try { /* deprecated setter via reflection */ }
catch (NotSupportedException ex) when (ex.Message.Contains("SetVisualAssetsImage"))
{ Debug.LogError("Migrate to SetVisualAssetsImage()."); }

Prevention

Replace all per-scale WSA image setters before Unity upgrade
Use UWP-supported scales (_100, _125, _150, _200) instead of deprecated _240

When it happens

Trigger: Assigning to PlayerSettings.WSA.phoneSplashScreenImageScale240 through reflection, dynamic keyword, or a pre-compiled plugin DLL.

Common situations: Build pipelines configuring WSA splash screen assets for high-DPI Windows Phone devices. Deployment automation scripts from pre-UWP Unity versions. Third-party asset store plugins.

Related errors

AI-assisted analysis of Unity-Technologies/UnityCsReference@225b0fbdb5 (2026-08-13). Data as JSON: /api/errors/c24b47b9e0353322. Report an issue: GitHub.