Flutter动画渲染插件flarelane_flutter的使用

欢迎来到 FlareLane，这是一个用于在Flutter应用中实现推送通知和应用内消息的强大工具。本文将详细介绍如何使用flarelane_flutter插件。

安装

首先，在你的pubspec.yaml文件中添加依赖：

dependencies:
  flarelane_flutter: ^latest_version

然后运行flutter pub get来安装该插件。

初始化与设置

下面是一个完整的示例代码，展示了如何初始化FlareLane SDK以及如何处理不同的事件回调。

示例代码

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

const FLARELANE_PROJECT_ID = 'YOUR_PROJECT_ID'; // 替换为你的项目ID

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  setupFlareLane();

  runApp(const MyApp());
}

Future<void> setupFlareLane() async {
  await FlareLane.shared.initialize(
    FLARELANE_PROJECT_ID,
    requestPermissionOnLaunch: false, // 是否在启动时请求权限
  );
}

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

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

class _MyAppState extends State<MyApp> {
  String _resState = '';
  String _clickedMessage = '';
  bool _isSetUserId = false;
  bool _isSubscribed = false;
  bool _isSetTags = false;

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

    // 设置点击通知的处理器
    FlareLane.shared.setNotificationClickedHandler((notification) {
      setState(() {
        _clickedMessage =
            '✅ Message of clickedHandler\n${notification.toString()}';
      });
    });

    // 设置前台接收通知的处理器
    FlareLane.shared.setNotificationForegroundReceivedHandler((event) {
      setState(() {
        _clickedMessage =
            '✅ Message of foregroundReceivedHandler\n${event.notification.toString()}';
      });

      if (event.notification.data?["dismiss_foreground_notification"] ==
          "true") {
        return;
      }

      event.display(); // 显示通知
    });

    // 设置应用内消息动作处理器
    FlareLane.shared.setInAppMessageActionHandler((iam, actionId) {
      var message =
          '✅ Message of setInAppMessageActionHandler\n${iam.toString()}\nactionId:${actionId}';
      print(message);
      setState(() {
        _clickedMessage = message;
      });
    });

    // 显示应用内消息
    FlareLane.shared.displayInApp("home");

    setState(() {
      _resState = 'FlareLane initialized.';
    });
  }

  Future<void> toggleUserId() async {
    await FlareLane.shared
        .setUserId(_isSetUserId ? null : "myuser@flarelane.com");
    _isSetUserId = !_isSetUserId;
  }

  Future<void> toggleTags() async {
    if (!_isSetTags) {
      await FlareLane.shared.setTags({"age": 27, "gender": 'men'});
      _isSetTags = true;
    } else {
      await FlareLane.shared.setTags({"age": null, "gender": null});
      _isSetTags = false;
    }
  }

  Future<void> getDeviceId() async {
    print(await FlareLane.shared.getDeviceId());
  }

  Future<void> trackEvent() async {
    await FlareLane.shared.trackEvent("test_event", {"test": "event"});
  }

  Future<void> subscribe() async {
    await FlareLane.shared.subscribe(true, (isSubscribed) {
      print(isSubscribed);
    });
  }

  Future<void> unsubscribe() async {
    await FlareLane.shared.unsubscribe((isSubscribed) {
      print(isSubscribed);
    });
  }

  Future<void> isSubscribed() async {
    final bool isSubscribed = await FlareLane.shared.isSubscribed();
    print(isSubscribed);
  }

  Future<void> displayInApp() async {
    FlareLane.shared.displayInApp("home");
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('FlareLane Example App'),
        ),
        body: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Center(child: Text('$_resState\n\n$_clickedMessage')),
            OutlinedButton(
                onPressed: toggleUserId, child: const Text("TOGGLE USER ID")),
            OutlinedButton(
                onPressed: toggleTags, child: const Text("TOGGLE TAGS")),
            OutlinedButton(
                onPressed: getDeviceId, child: const Text("PRINT DEVICE ID")),
            OutlinedButton(
                onPressed: trackEvent, child: const Text("TRACK EVENT")),
            OutlinedButton(
                onPressed: subscribe, child: const Text("SUBSCRIBE")),
            OutlinedButton(
                onPressed: unsubscribe, child: const Text("UNSUBSCRIBE")),
            OutlinedButton(
                onPressed: isSubscribed, child: const Text("ISSUBSCRIBED")),
            OutlinedButton(
                onPressed: displayInApp, child: const Text("DISPLAY INAPP"))
          ],
        ),
      ),
    );
  }
}