FlutterFlow构建的Flutter应用后台定时服务未正常运行问题

问题场景 #

使用FlutterFlow构建的Flutter应用，期望通过后台服务每3分钟播放一次应用资源中的音频，但出现以下问题：

• 应用前台时，首次进入调用mainAction的页面音频正常播放，但后续不再重复执行；
• 应用切后台后，能看到服务通知，但音频从未再次播放。

当前使用的代码：

// Automatic FlutterFlow imports
import '/backend/schema/structs/index.dart';
import '/flutter_flow/flutter_flow_theme.dart';
import '/flutter_flow/flutter_flow_util.dart';
import '/custom_code/actions/index.dart'; // Imports other custom actions
import '/flutter_flow/custom_functions.dart'; // Imports custom functions
import 'package:flutter/material.dart';
// Begin custom action code
// DO NOT REMOVE OR MODIFY THE CODE ABOVE!

import 'dart:io'; // For platform-specific checks
import 'package:flutter_background_service/flutter_background_service.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';

late Function doableAction;

Future mainAction(Future Function() theAction) async {
  doableAction = theAction;
  await initializeService();
}

Future<void> initializeService() async {
  if (Platform.isAndroid) {
    const AndroidNotificationChannel channel = AndroidNotificationChannel(
      'your_notification_channel_id', // id
      'Your Notification Channel', // title
      importance: Importance.high,
    );

    final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
        FlutterLocalNotificationsPlugin();

    await flutterLocalNotificationsPlugin
        .resolvePlatformSpecificImplementation<
            AndroidFlutterLocalNotificationsPlugin>()
        ?.createNotificationChannel(channel);
  }

  final service = FlutterBackgroundService();

  // Configure and start the service
  await service.configure(
    androidConfiguration: AndroidConfiguration(
      onStart: onStart,
      autoStart: true,
      isForegroundMode: true, // Ensure it runs as a foreground service
      notificationChannelId: 'your_notification_channel_id',
      initialNotificationTitle: 'Azan Notify',
      initialNotificationContent: 'Azan notify is running in background',
    ),
    iosConfiguration: IosConfiguration(
      onForeground: onStart,
      autoStart: true,
    ),
  );

  // Start the service
  service.startService();

  // Execute the custom action once after service initialization
  await doTheAction();
}

// This function will run the background task
Future<void> onStart(ServiceInstance service) async {
  if (service is AndroidServiceInstance) {
    service.on('setAsForeground').listen((event) {
      service.setAsForegroundService();
    });

    service.on('setAsBackground').listen((event) {
      service.setAsBackgroundService();
    });

    service.on('onTaskRemoved').listen((event) {
      service.stopSelf();
    });
  }

  // Run the action repeatedly in a loop
  while (true) {
    // Removed the `isRunning` check
    print('Running doTheAction in background...');
    await doTheAction();

    // Wait for 3 minutes before repeating the action
    await Future.delayed(Duration(minutes: 3));
  }
}

Future<void> doTheAction() async {
  try {
    print('Executing doableAction...');
    await doableAction(); // Ensure this is an async function
  } catch (e) {
    print('Error in doTheAction: $e');
  }
}

问题根源 #

1. 跨线程函数传递无效：后台服务运行在独立的隔离线程，无法直接调用UI线程传递的doableAction函数——音频播放依赖UI上下文或平台资源，后台线程没有这些环境。
2. 变量跨线程不可共享：late Function doableAction是UI线程的变量，后台服务的onStart方法无法获取到有效的函数引用，导致循环执行时无实际动作。
3. 音频播放未适配后台环境：普通UI层的音频播放逻辑不支持后台运行，Android/iOS对后台媒体播放有严格权限和配置要求。

修复方案 #

1. 改用支持后台播放的音频库 #

推荐使用just_audio（支持后台播放、权限配置更完善），先在pubspec.yaml添加依赖：

dependencies:
  just_audio: ^0.9.34
  just_audio_background: ^0.0.1-beta.11

2. 配置平台权限 #

Android配置（android/app/src/main/AndroidManifest.xml）

• 添加权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

• 添加服务声明（在<application>标签内）：

<service android:name="com.ryanheise.audioservice.AudioService"
    android:foregroundServiceType="mediaPlayback"
    android:exported="false"/>
<receiver android:name="com.ryanheise.audioservice.MediaButtonReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MEDIA_BUTTON" />
    </intent-filter>
</receiver>

iOS配置（ios/Runner/Info.plist）

添加后台模式权限：

<key>UIBackgroundModes</key>
<array>
    <string>audio</string>
</array>

3. 重构后台服务逻辑 #

去掉跨线程函数传递，直接在后台服务内初始化播放器并处理播放逻辑：

// Automatic FlutterFlow imports
import '/backend/schema/structs/index.dart';
import '/flutter_flow/flutter_flow_theme.dart';
import '/flutter_flow/flutter_flow_util.dart';
import '/custom_code/actions/index.dart';
import '/flutter_flow/custom_functions.dart';
import 'package:flutter/material.dart';
// Begin custom action code
// DO NOT REMOVE OR MODIFY THE CODE ABOVE!

import 'dart:io';
import 'package:flutter_background_service/flutter_background_service.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import 'package:just_audio/just_audio.dart';

// 后台服务内的播放器实例
late AudioPlayer _audioPlayer;

Future mainAction() async {
  await initializeService();
}

Future<void> initializeService() async {
  if (Platform.isAndroid) {
    const AndroidNotificationChannel channel = AndroidNotificationChannel(
      'your_notification_channel_id',
      'Azan Notify Channel',
      importance: Importance.high,
    );

    final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
        FlutterLocalNotificationsPlugin();
    await flutterLocalNotificationsPlugin
        .resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()
        ?.createNotificationChannel(channel);
  }

  final service = FlutterBackgroundService();
  await service.configure(
    androidConfiguration: AndroidConfiguration(
      onStart: onStart,
      autoStart: true,
      isForegroundMode: true,
      notificationChannelId: 'your_notification_channel_id',
      initialNotificationTitle: 'Azan Notify',
      initialNotificationContent: 'Azan notify is running in background',
    ),
    iosConfiguration: IosConfiguration(
      onForeground: onStart,
      autoStart: true,
    ),
  );

  service.startService();
}

Future<void> onStart(ServiceInstance service) async {
  // 初始化后台播放器
  _audioPlayer = AudioPlayer();
  // 替换为你的音频资源路径（需在pubspec.yaml中声明）
  await _audioPlayer.setAsset('assets/audio/azan.mp3');

  if (service is AndroidServiceInstance) {
    service.on('setAsForeground').listen((_) => service.setAsForegroundService());
    service.on('setAsBackground').listen((_) => service.setAsBackgroundService());
    service.on('onTaskRemoved').listen((_) => service.stopSelf());
  }

  // 定时循环播放
  while (true) {
    print('Starting audio playback...');
    await _playAudio();
    await Future.delayed(Duration(minutes: 3));
  }
}

Future<void> _playAudio() async {
  try {
    // 重置播放位置到开头
    await _audioPlayer.seek(Duration.zero);
    // 开始播放
    await _audioPlayer.play();
    // 等待播放完成再进入下一次循环
    await _audioPlayer.playerStateStream.firstWhere(
      (state) => state.processingState == ProcessingState.completed
    );
  } catch (e) {
    print('Audio playback error: $e');
  }
}

4. 验证与注意事项 #

• 确保音频文件已在pubspec.yaml的assets中声明：

flutter:
  assets:
    - assets/audio/azan.mp3

• Android 12+需确保前台服务类型为mediaPlayback，否则会被系统限制；
• iOS后台播放时，设备不能处于静音模式（除非配置了静音下播放的权限）。

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