iOS random play future timeout

[chrisdrobison]

Checklist

• I read the troubleshooting guide before raising this issue
• I made sure that the issue I am raising doesn't already exist

Current bug behaviour

This is just started showing up after upgrading to Flutter 3.29. We are seeing this error appear randomly. We are able to reproduce it, but not consistently. We play small audio files one right after the other and use the onPlayerComplete stream to drive playing other files after one is complete.

┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────
│ [error] | 9:57:52 253ms | Unhandled exception
│ TimeoutException after 0:00:30.000000: Future not completed
│ StackTrace: #0      Future.timeout.<anonymous closure> (dart:async/future_impl.dart:1025:22)
│ <asynchronous suspension>
│ #1      Future.wait.<anonymous closure> (dart:async/future.dart:528:21)
│ <asynchronous suspension>
│ #2      AudioPlayer._completePrepared (package:audioplayers/src/audioplayer.dart:366:5)
│ <asynchronous suspension>
│ #3      AudioPlayer.setSourceAsset (package:audioplayers/src/audioplayer.dart:423:5)
│ <asynchronous suspension>
│ #4      AudioPlayer.setSource (package:audioplayers/src/audioplayer.dart:349:5)
│ <asynchronous suspension>
│ #5      AudioPlayer.play (package:audioplayers/src/audioplayer.dart:215:5)
│ <asynchronous suspension>
│ #6      StandProctor._playAndSignalNextTest (package:cognuro/providers/stand_proctor_provider.dart:100:5)
│ <asynchronous suspension>
│ #7      StandProctor._onHandleAwaitState (package:cognuro/providers/stand_proctor_provider.dart:91:7)
│ <asynchronous suspension>
│ }
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────

Expected behaviour

No timeout exception

Steps to reproduce

Code sample

static final AudioPlayer _fixedPlayer = AudioPlayer(playerId: 'stand-player')
    ..audioCache = AudioCache(prefix: 'assets/stand_audio/');

_fixedPlayer.onPlayerComplete.take(1).listen((event) {
  await _fixedPlayer.play(AssetSource('${state.nextTestName}.mp3')); // Timeout is randomly happening here
});

await _fixedPlayer.play(AssetSource('10-open-eyes.mp3'));

Affected platforms

iOS

Platform details

This is occurring across a number of iPad devices. The ones we've tried are iPad (4th and 10th gen), iPad Pro (4th gen). All are running iOS 18.3.2.

AudioPlayers Version

6.4.0

Build mode

release

Audio Files/URLs/Sources

No response

Screenshots

No response

Logs

my relevant logs

Full Logs

my full logs or a link to a gist

Flutter doctor:

Output of: flutter doctor -v

Related issues / more information

No response

Working on PR

yeah

[hoangdt84]

Here is my workaround

...
_player.onPlayerComplete.listen((event) => _next());
...

void _next() async {
    _musicIndex++;

    if (_musicIndex >= _paths.length) {
      _musicIndex = 0;
      _paths.shuffle();
    }

    await _player.stop(); // To fix strange bug on iOS
    await _player.play(_getSource(_paths[_musicIndex]));
}

I keep the app running for 30 minutes without any issues. Duration of the music files are around 2~3 minutes.

Hope it help.

[Gustl22]

The stacktrace and example helps a lot. We also experience this in our tests (only 3.29.x).
Glad for any help regarding fixing

[chrisdrobison]

In 3.29 they switched the platform channels from using their own thread to being on the UI thread. I’m guessing that might play into this.

…

________________________________ From: August ***@***.***> Sent: Friday, March 21, 2025 10:32:48 AM To: bluefireteam/audioplayers ***@***.***> Cc: Chris Robison ***@***.***>; Author ***@***.***> Subject: Re: [bluefireteam/audioplayers] iOS random play future timeout (Issue #1914) The stacktrace and example helps a lot. We also experience this in our tests (only 3.29.x). Glad for any help regarding fixing — Reply to this email directly, view it on GitHub<#1914 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AAN3NYPCQJASYLIRFUVUKLD2VQ5LBAVCNFSM6AAAAABZN54X22VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDONBTHA4DOMBQGQ>. You are receiving this because you authored the thread.Message ID: ***@***.***> [Gustl22]Gustl22 left a comment (bluefireteam/audioplayers#1914)<#1914 (comment)> The stacktrace and example helps a lot. We also experience this in our tests (only 3.29.x). Glad for any help regarding fixing — Reply to this email directly, view it on GitHub<#1914 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AAN3NYPCQJASYLIRFUVUKLD2VQ5LBAVCNFSM6AAAAABZN54X22VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDONBTHA4DOMBQGQ>. You are receiving this because you authored the thread.Message ID: ***@***.***>

[chrisdrobison]

@hoangdt84 That work around seems to be working for me.

[moesaid]

having the same problem as well

┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      │ TimeoutException after 0:00:30.000000: Future not completed
      ├┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
      │ #0   Future.timeout.<anonymous closure> (dart:async/future_impl.dart:1025:22)
      │ #1   <asynchronous suspension>
      │ #2   Future.wait.<anonymous closure> (dart:async/future.dart:528:21)
      │ #3   <asynchronous suspension>
      │ #4   AudioPlayer._completePrepared (package:audioplayers/src/audioplayer.dart:366:5)
      │ #5   <asynchronous suspension>
      │ #6   AudioPlayer.setSourceUrl (package:audioplayers/src/audioplayer.dart:389:5)
      │ #7   <asynchronous suspension>
      ├┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
      │ ⛔ TimeoutException after 0:00:30.000000: Future not completed
      └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

[bennv14]

await Future.delayed(const Duration(milliseconds: 10));
await player.play(DeviceFileSource(localPath));

I hate this, but this is the only way that works for me.