Flutter动画与交互插件reflex的使用

Reflex

Flutter插件用于通知读取与回复。

兼容性

✅   Android
❌   iOS (问题: iOS支持reflex)

显示一些爱心并收藏仓库

为什么使用Reflex?

Reflex插件的特点包括:

• 快速、高性能且兼容性强
• 免费且开源
• 生产就绪
• 使应用具备响应能力

特点

以下所有功能都可以在运行时执行：

• 获取通知流
• 读取通知
• 从通知中回复
• 自动回复

演示

快速开始

步骤1：将插件添加到项目中

在 pubspec.yaml 文件中添加依赖：

dependencies:
  reflex: <最新版本>

运行 pub get 获取包。

步骤2：在 AndroidManifest.xml 中添加服务

在 <application> 标签内添加以下服务：

<service
    android:label="notifications"
    android:name="com.devsonflutter.reflex.notification.NotificationListener"
    android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE">
    <intent-filter>
        <action android:name="android.service.notification.NotificationListenerService" />
    </intent-filter>
</service>

对于Android 12及以上版本，添加 android:exported="true" 字段以使其兼容：

<service
    android:label="notifications"
    android:name="com.devsonflutter.reflex.notification.NotificationListener"
    android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE"
    android:exported="true">
    <intent-filter>
        <action android:name="android.service.notification.NotificationListenerService" />
    </intent-filter>
</service>

步骤3：实例化Reflex

只允许实例化一次：

Reflex reflex = Reflex();

示例

前往 pub.dev 的示例部分查看完整的示例代码。

在GitHub中，前往 example/lib/main.dart 查看完整的示例代码。

导入

单个导入即可使用reflex：

import 'package:reflex/reflex.dart';

监听与回复

StreamSubscription<ReflexEvent>? _subscription;
final List<ReflexEvent> _notificationLogs = [];
final List<ReflexEvent> _autoReplyLogs = [];
bool isListening = false;

Reflex reflex = Reflex(
  debug: true,
  packageNameList: ["com.whatsapp", "com.tyup"],
  packageNameExceptionList: ["com.facebook"],
  autoReply: AutoReply(
    packageNameList: ["com.whatsapp"],
    message: "[Reflex] 这是一个自动回复。",
  ),
);

@override
void initState() {
  super.initState();
  initPlatformState();
}

Future<void> initPlatformState() async {
  startListening();
}

void onData(ReflexEvent event) {
  setState(() {
    if (event.type == ReflexEventType.notification) {
      _notificationLogs.add(event);
    } else if (event.type == ReflexEventType.reply) {
      _autoReplyLogs.add(event);
    }
  });
  debugPrint(event.toString());
}

void startListening() {
  try {
    _subscription = reflex.notificationStream!.listen(onData);
    setState(() {
      isListening = true;
    });
  } on ReflexException catch (exception) {
    debugPrint(exception.toString());
  }
}

void stopListening() {
  _subscription?.cancel();
  setState(() => isListening = false);
}

快速指南

调试

调试允许你调试插件的功能，日志会显示在控制台。

默认情况下调试日志已启用。你可以通过在 Reflex 类中使用 debug 字段进行配置：

Reflex reflex = Reflex(
  debug: false,
);

监听通知权限

检查是否已经授予了监听通知的权限：

bool isPermissionGranted = await Reflex.isPermissionGranted;

请求监听通知权限

使用该函数来请求监听通知的权限：

await Reflex.requestPermission();

通知流

使用 reflex 对象获取通知流，以便在Flutter应用中监听通知：

StreamSubscription<ReflexEvent>? _subscription;
_subscription = reflex.notificationStream!.listen((event) {
  // 应用逻辑
});

该流会在收到通知时订阅 ReflexEvent。

Reflex事件

传入的 ReflexEvent 包含以下信息：

• 类型：当收到通知时为 ReflexEventType.notification，当发送自动回复时为 ReflexEventType.reply。
• 包名：接收通知的应用程序的包名。
• 标题：通知标题。
• 消息：包含在通知中的消息及发送回复时的消息。
• 时间戳：通知接收和回复发送的时间戳。

监听特定应用的通知

指定要监听通知的应用程序列表：

如果 packageNameList: null，插件将监听所有包的通知。

Reflex reflex = Reflex(
  debug: true,
  packageNameList: ["com.whatsapp", "com.facebook"],
);

避免特定应用的通知

指定包名异常列表以避免监听某些应用程序的通知：

如果 packageNameExceptionList: null，插件将监听 packageNameList（如果不为空）的通知。

Reflex reflex = Reflex(
  debug: true,
  packageNameExceptionList: ["com.whatsapp"],
);

自动回复

在监听通知时发送自动回复：

AutoReply autoReply = AutoReply(
  message: "[Reflex] 这是一个自动回复。",
),

特定应用的自动回复

在 AutoReply 中指定 packageNameList 以对特定应用进行自动回复：

AutoReply autoReply = AutoReply(
  packageNameList: ["com.whatsapp"],
  message: "[Reflex] 这是一个自动回复。",
),

AutoReply 对象由 Reflex 的 autoReply 字段用于自动回复应用程序。

Reflex reflex = Reflex(
  debug: true,
  packageNameList: ["com.whatsapp", "com.tyup"],
  packageNameExceptionList: ["com.miui.securitycenter"],
  autoReply: AutoReply(
    packageNameList: ["com.whatsapp"],
    message: "[Reflex] 这是一个自动回复。",
  ),
);