audioplayers_watchos

The watchOS implementation of audioplayers.

Playback is driven by AVPlayer (AVFoundation) through dart:ffi — the supported plugin model on watchOS. One native player is kept per playerId; play/pause/seek/volume/rate/release-mode are applied natively, and the event stream (prepared, duration, seekComplete, complete, errors) is derived by polling a lock-guarded native state snapshot.

Usage

This is a federated plugin implementation. Apps that already depend on audioplayers and target watchOS only need to add this package alongside it:

dependencies:
  audioplayers: ^6.8.1
  audioplayers_watchos: ^0.1.0

No other change: use AudioPlayer as on iOS. What differs on the watch is listed under "watchOS notes" and "Not supported on watchOS" below. Asset sources go through audioplayers' own AudioCache, which uses path_provider; add path_provider_watchos alongside it the same way.

watchOS notes

• Balance (setBalance) is not supported — AVPlayer has no per-channel balance. Calls emit a log event instead of throwing, matching the upstream iOS behaviour.
• Player mode (setPlayerMode) is a no-op; watchOS has no low-latency AVAudioPlayer pool.
• Audio context: the AudioContextIOS category and the mixWithOthers / duckOthers options map onto the watch AVAudioSession. iOS-only options with no watchOS equivalent (e.g. defaultToSpeaker) are ignored — the watch routes output itself (Bluetooth headphones or speaker).
• Bytes sources (setSourceBytes) are spooled to a temporary file and played from there; pass mimeType so the container format is known.
• On a real watch, background/long-form playback is subject to the system audio-session policy; short UI sounds and foreground playback behave as on iOS.

Example on the watch screen

The bundled example is the upstream audioplayers example, verbatim. It is a phone-designed multi-tab UI, so its runner sets FlutterWatchOSContentScale in Info.plist to render it scaled-to-fit on the watch. See the example README for details.

Not supported on watchOS

These members of audioplayers_platform_interface 7.2.0 throw or fail on watchOS. PORTING_REPORT.md lists every member under "Interface coverage".

License

The FlutterWatch Authors under a BSD-3-Clause license. See LICENSE for the full text.