Flutter安卓会话快捷方式插件android_conversation_shortcut的使用

Flutter安卓会话快捷方式插件android_conversation_shortcut的使用

简介

android_conversation_shortcut 是一个简单的插件，用于为消息样式的通知创建安卓会话快捷方式。这样，通知将会在通知的对话部分显示出来。

注意：该插件旨在作为 flutter_local_notifications 插件的增强功能。

使用方法

1. 创建一个 Person 对象 首先，你需要从 flutter_local_notifications 插件的 Person 类中创建一个 Person 对象。

   Person person = Person(
     key: '1',
     name: 'Bob',
     icon: ...,  // 可以是图标资源
     ...
   );
   

2. 创建会话快捷方式 接下来，你可以使用提供的函数来创建会话快捷方式。

   final shortcutId = await AndroidConversationShortcut.createConversationShortcut(person);
   

3. 配置通知 使用 flutter_local_notifications 提供的 AndroidNotificationDetails 属性，你可以指定 shortcutId。此外，styleInformation 应该是一个 MessagingStyleInformation 对象。

   AndroidNotificationDetails(
     channel.id,
     channel.name,
     channel.description,
     icon: '@drawable/is_notification',
     shortcutId: shortcutId,
     styleInformation: MessagingStyleInformation(
       person,
       groupConversation: false,
       messages: messages,
       ...
     ),
     ...
   );
   

完整示例

以下是一个完整的示例，展示了如何使用 android_conversation_shortcut 插件。

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:android_conversation_shortcut/android_conversation_shortcut.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，所以我们需要在一个异步方法中初始化
  Future<void> initPlatformState() async {
    String platformVersion;
    // 平台消息可能会失败，所以我们使用 try/catch 来捕获 PlatformException
    // 我们还需要处理消息可能返回 null 的情况
    try {
      platformVersion =
          await AndroidConversationShortcut.platformVersion ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果小部件在异步平台消息还在飞行时被从树中移除，我们希望丢弃回复而不是调用 setState 来更新我们的非存在的外观
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('运行于: $_platformVersion\n'),
        ),
      ),
    );
  }
}