Xamarin.Forms iOS端UIScreen.MainScreen.Brightness设置亮度不生效问题

安全阿岳

2026-10-3

问题排查与修复方案

1. 核心生效前提校验

亮度参数取值范围：iOS UIScreen.MainScreen.Brightness 仅接受 **0_{1之间的浮点数**，0代表最低亮度，1代表最高亮度。如果你的输入值是0}100的整数，需要先除以100做归一化处理，超出范围的参数会被系统直接忽略。
调用线程要求：修改屏幕亮度属于UI类操作，必须在iOS主线程执行，跨线程调用会无报错但不生效。
系统设置干扰：如果设备开启了自动亮度调节、原彩显示，系统会在你手动设置亮度后短时间内自动修正亮度，测试时建议先暂时关闭上述系统设置。

2. 修复后的代码实现

（1）输入逻辑优化（增加参数校验与异常处理）

void Entry_Completed(object sender, EventArgs e) {
    var text = ((Entry)sender).Text;
    // 改用TryParse避免非法输入崩溃
    if (float.TryParse(text, out float inputValue))
    {
        // 如果输入是0~100的数值，先归一化到0~1
        float normalizedValue = inputValue > 1 ? inputValue / 100f : inputValue;
        // 限制范围防止越界
        normalizedValue = Math.Clamp(normalizedValue, 0f, 1f);
        var brightnessService = DependencyService.Get<IBrightnessService>();
        brightnessService.SetBrightness(normalizedValue);
    }
}

（2）iOS服务端实现优化（增加主线程调度）

using Xamarin.Forms;
using UIKit;
using Foundation;

[assembly: Dependency(typeof (iOSBrightnessService))]
public class iOSBrightnessService : IBrightnessService
{
    public void SetBrightness(float brightness)
    {
        // 确保在主线程执行UI操作
        DispatchQueue.MainQueue.DispatchAsync(() =>
        {
            UIScreen.MainScreen.Brightness = brightness;
        });
    }
}