Flutter音乐应用audio_manager包播放崩溃问题求助

Hey there, let's dig into why your music app is crashing when you tap the play button with the audio_manager package. I’ve gone through your code snippets, and here are the most probable issues and fixes to get your audio playing smoothly:

1. Fix the File URI Format #

Your current code adds file:// to ${song.uri}, but this can create invalid paths if song.uri already includes a scheme (like file:// or content://) or is an absolute file path (e.g., /storage/emulated/0/Music/song.mp3).

• First, print song.uri directly to see its actual value—this will help you spot if you’re double-adding the file:// prefix.
• Use this adjusted logic to generate a valid URI:

String audioUri;
if (song.uri.startsWith(RegExp(r'[a-z]+://'))) {
  // If the URI already has a scheme (like file:// or content://), use it as-is
  audioUri = song.uri;
} else {
  // For absolute file paths, add the correct file:// prefix with three slashes
  audioUri = 'file:///${song.uri}';
}

2. Ensure Required Permissions Are Granted #

Playing audio from external storage requires platform-specific permissions, and missing them is a common cause of crashes:

• Android: For Android 12 and below, add READ_EXTERNAL_STORAGE to your AndroidManifest.xml. For Android 13+, use READ_MEDIA_AUDIO instead.
• iOS: Add NSAppleMusicUsageDescription and NSMicrophoneUsageDescription to your Info.plist (with a brief explanation for users).
• Don’t forget to request permissions at runtime using a package like permission_handler:

import 'package:permission_handler/permission_handler.dart';

// Call this before attempting playback
final permissionStatus = await Permission.audio.request();
if (!permissionStatus.isGranted) {
  print("Audio permission not granted—playback will fail!");
  // Show a dialog to prompt the user to enable permissions
  return;
}

3. Confirm AudioManager Is Properly Initialized #

If you haven’t initialized the AudioManager instance before calling start(), this can lead to immediate crashes. Make sure you run initialization code early (e.g., in your main() function or page initState()):

import 'package:audio_manager/audio_manager.dart';

// Inside main() or initState()
await AudioManager.instance.init();
// Some versions may require additional config for notifications, check the package docs

4. Improve Error Handling to Diagnose the Crash #

Your current catchError might not capture all exceptions, especially if the crash happens synchronously before the Future completes. Switch to a try-catch block to get full error details, including a stack trace:

onTap: () async {
  try {
    print("Attempting to play: ${song.uri}");
    // Use the corrected audioUri from point 1
    await cubit.audioManager.start(
      audioUri,
      "title",
      desc: "desc",
      cover: "assets/image/noaudio.png"
    );
  } catch (error, stackTrace) {
    print("Playback failed with error: $error");
    print("Full stack trace:\n$stackTrace");
    // The stack trace will tell you exactly where the crash occurs—super helpful!
  }
}

5. Verify the Audio File Exists and Is Accessible #

Before trying to play, confirm the file at song.uri actually exists and is readable:

import 'dart:io';

onTap: () async {
  // Check if it's a local file path
  if (song.uri.startsWith('/')) {
    final audioFile = File(song.uri);
    if (!await audioFile.exists()) {
      print("Error: Audio file does not exist at ${song.uri}");
      return;
    }
  }
  // Proceed with playback logic
}

Start with checking the URI format and adding proper error handling—those are the quickest wins to identify the root cause.

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