Flutter_background_service：UI与后台线程的通信方法问询

1. 先完成后台服务初始化 #

首先在main.dart中配置后台服务的启动逻辑，同时在后台回调里设置消息监听：

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  _initBackgroundService();
  runApp(const MyApp());
}

void _initBackgroundService() async {
  final service = FlutterBackgroundService();
  await service.configure(
    iosConfiguration: IosConfiguration(
      autoStart: true,
      onForeground: _onBackgroundServiceStart,
      onBackground: _iosBackgroundHandler,
    ),
    androidConfiguration: AndroidConfiguration(
      onStart: _onBackgroundServiceStart,
      autoStart: true,
      isForegroundMode: true,
    ),
  );
}

// 后台服务启动后的核心逻辑
void _onBackgroundServiceStart(ServiceInstance service) async {
  // 监听UI发送到"ui_to_background"通道的消息
  service.on("ui_to_background").listen((receivedData) {
    print("后台收到UI消息：$receivedData");
    // 收到消息后给UI回复
    service.invoke("background_to_ui", {"reply": "已接收UI消息：${receivedData["content"]}"});
  });

  // 后台主动给UI发消息的示例（比如定时推送）
  Timer.periodic(const Duration(seconds: 8), (timer) {
    service.invoke("background_to_ui", {"update": "后台定时更新：${DateTime.now().toString()}"});
  });
}

// iOS后台模式回调（可选）
bool _iosBackgroundHandler(ServiceInstance service) {
  WidgetsFlutterBinding.ensureInitialized();
  return true;
}

2. UI层实现消息收发 #

在UI页面中，通过invoke给后台发消息，同时用on监听后台返回的消息：

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final _backgroundService = FlutterBackgroundService();
  String _backgroundMessage = "";

  @override
  void initState() {
    super.initState();
    // 监听后台发送到"background_to_ui"通道的消息
    _backgroundService.on("background_to_ui").listen((data) {
      setState(() {
        if (data.containsKey("reply")) {
          _backgroundMessage = data["reply"];
        } else if (data.containsKey("update")) {
          _backgroundMessage = data["update"];
        }
      });
    });
  }

  // 给后台发送消息的方法
  void _sendMessageToBackground() async {
    await _backgroundService.invoke("ui_to_background", {"content": "这是UI发送的测试消息"});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("后台通信测试")),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text("后台消息：$_backgroundMessage"),
            const SizedBox(height: 20),
            ElevatedButton(
              onPressed: _sendMessageToBackground,
              child: const Text("发送消息给后台"),
            ),
          ],
        ),
      ),
    );
  }
}

核心方法说明 #

• service.on(String channel): 监听指定通道的消息流，UI和后台都可以用这个方法接收对方的消息，通过listen处理接收到的键值对数据。
• service.invoke(String channel, [Map<String, dynamic>? data]): 向指定通道发送消息，channel必须和对方监听的通道名完全一致，data仅支持可序列化的基本类型（字符串、数字、布尔等），复杂对象需要先转为Map。

注意事项 #

• 通道名要在UI和后台保持统一，否则无法完成消息传递。
• Android平台需要在AndroidManifest.xml中添加后台权限配置，iOS需要在Xcode中开启对应后台模式（如Background Fetch）。
• 避免在后台线程中直接操作UI，所有UI更新必须通过消息传递到UI层后调用setState处理。

内容的提问来源于stack exchange，提问作者May