鸿蒙版Flutter插件开发原创

鸿蒙坚果

发布于 2025-3-11 19:28

浏览

0收藏

1. 项目概述

这是一个Flutter插件平台接口项目，用于统一管理屏幕亮度的相关操作。它定义了与平台无关的接口，具体实现由各个平台（Android、iOS、macOS、Windows等）完成。

2. 核心接口

在ScreenBrightnessPlatform类中定义了以下主要接口：

系统亮度相关
- system: 获取系统亮度（0.0-1.0）
- setSystemScreenBrightness(): 设置系统亮度
- onSystemScreenBrightnessChanged: 监听系统亮度变化
应用亮度相关
- application: 获取应用亮度
- setApplicationScreenBrightness(): 设置应用亮度
- resetApplicationScreenBrightness(): 重置应用亮度
- onApplicationScreenBrightnessChanged: 监听应用亮度变化
- hasApplicationScreenBrightnessChanged: 判断应用亮度是否被修改
其他功能
- isAutoReset: 是否自动重置亮度
- setAutoReset(): 设置自动重置
- isAnimate: 是否启用动画
- setAnimate(): 设置动画
- canChangeSystemBrightness: 是否可以修改系统亮度

3. 实现要点

在鸿蒙侧实现时，需要关注：

MethodChannel通信
- 使用pluginMethodChannel与Flutter端通信
- 方法名定义在method_name.dart中
- 事件通道定义在plugin_channel.dart中
亮度范围
- 亮度值范围：0.0（最暗）到1.0（最亮）
- 超出范围需要抛出RangeError
异常处理
- 平台操作失败时需要抛出PlatformException
- 包含错误代码和描述信息
生命周期管理
- 需要处理应用前后台切换时的亮度恢复
- 实现autoReset功能

4. 鸿蒙侧实现建议

在ScreenBrightnessPlugin.ets中，你可以：

实现ScreenBrightnessPlatform接口
使用鸿蒙的WindowAPI获取和设置亮度
监听系统亮度变化事件
处理应用生命周期事件
实现亮度动画效果

5. 测试参考

可以参考screen_brightness_platform_interface_test.dart中的测试用例，确保实现的功能符合预期。

需要我详细解释某个部分或提供具体实现示例吗？

简单实现

核心的亮度控制功能。

import plugin from '@ohos.ability.plugin';
import window from '@ohos.window';
import { MethodChannel, MethodCall, MethodResult } from '@ohos.ability.plugin';

export default class ScreenBrightnessPlugin {
  private static readonly CHANNEL_NAME = 'github.com/aaassseee/screen_brightness';
  private static readonly METHOD_GET_SYSTEM_BRIGHTNESS = 'getSystemScreenBrightness';
  private static readonly METHOD_SET_SYSTEM_BRIGHTNESS = 'setSystemScreenBrightness';
  private static readonly METHOD_GET_APP_BRIGHTNESS = 'getApplicationScreenBrightness';
  private static readonly METHOD_SET_APP_BRIGHTNESS = 'setApplicationScreenBrightness';
  
  private methodChannel: MethodChannel;
  private window: window.Window | null = null;

  constructor(context: plugin.PluginContext) {
    this.methodChannel = new MethodChannel(context, ScreenBrightnessPlugin.CHANNEL_NAME);
    this.registerMethods();
  }

  private registerMethods() {
    this.methodChannel.setMethodCallHandler({
      onCall: (methodCall: MethodCall): Promise<MethodResult> => {
        switch (methodCall.method) {
          case ScreenBrightnessPlugin.METHOD_GET_SYSTEM_BRIGHTNESS:
            return this.getSystemBrightness();
          case ScreenBrightnessPlugin.METHOD_SET_SYSTEM_BRIGHTNESS:
            return this.setSystemBrightness(methodCall.arguments['brightness']);
          case ScreenBrightnessPlugin.METHOD_GET_APP_BRIGHTNESS:
            return this.getApplicationBrightness();
          case ScreenBrightnessPlugin.METHOD_SET_APP_BRIGHTNESS:
            return this.setApplicationBrightness(methodCall.arguments['brightness']);
          default:
            return Promise.reject('Method not implemented');
        }
      }
    });
  }

  private async getSystemBrightness(): Promise<MethodResult> {
    try {
      const brightness = await window.getSystemBrightness();
      return { code: 0, result: brightness };
    } catch (error) {
      return { code: -1, message: error.message };
    }
  }

  private async setSystemBrightness(brightness: number): Promise<MethodResult> {
    if (brightness < 0 || brightness > 1) {
      return { code: -2, message: 'Brightness out of range' };
    }

    try {
      await window.setSystemBrightness(brightness);
      return { code: 0 };
    } catch (error) {
      return { code: -1, message: error.message };
    }
  }

  private async getApplicationBrightness(): Promise<MethodResult> {
    if (!this.window) {
      return { code: -3, message: 'Window not initialized' };
    }

    try {
      const brightness = await this.window.getBrightness();
      return { code: 0, result: brightness };
    } catch (error) {
      return { code: -1, message: error.message };
    }
  }

  private async setApplicationBrightness(brightness: number): Promise<MethodResult> {
    if (brightness < 0 || brightness > 1) {
      return { code: -2, message: 'Brightness out of range' };
    }

    try {
      if (!this.window) {
        this.window = await window.getLastWindow();
      }
      await this.window.setBrightness(brightness);
      return { code: 0 };
    } catch (error) {
      return { code: -1, message: error.message };
    }
  }
}