setBrightness method

void setBrightness(
  1. double brightness
)

设置亮度

Set the brightness level of the player.

brightness The target brightness value, clamped between 0 and 1.

Implementation

void setBrightness(double brightness) {
  final value = clampDouble(brightness, 0, 1);
  /**
   * TODO: 亮度调节功能需由使用方自行实现
   * aliplayer_widget 当前仅提供亮度状态管理(brightnessNotifier),未内置实际的屏幕亮度调节逻辑。
   * 原因:Flutter 官方尚未提供统一的系统级亮度控制 API,实现该功能需依赖平台特定的原生插件(如 screen_brightness),
   * 而此类插件可能引入版本兼容性问题(如 Flutter、JDK、CocoaPods 等环境差异),影响组件的跨平台稳定性。
   * 建议:请根据您的项目环境,自行集成合适的亮度控制插件,并在此处调用其 API 完成实际亮度设置。
   * 您可通过插件 README 中“开源与源码获取”部分提供的源码依赖方式,对本组件进行二次扩展。
   */
  logi("setBrightness: ${brightnessNotifier.value} -> $value");

  brightnessNotifier.value = value;
}