BaseAudioChannel class abstract

BaseAudioChannel

An abstract base that encapsulates shared logic for all audio channels (e.g., BGM, SFX, Voice). Subclasses provide concrete configuration for playerMode and releaseMode.

Core Responsibilities:

• Maintain a single AudioPlayer per channel
• Control playback: play, playFromSource, pause, resume, stop
• Manage volume & mute state with cached target restoration
• Expose reactive isPlaying via onIsPlayingChanged
• Provide tween-based volume fading with custom Curve
• Wrap arbitrary actions in fade-out → action → fade-in via withFade

Configurable:

• Override playerMode and releaseMode
• Swap how paths are resolved via changeSource

Usage Example:

class SfxChannel extends BaseAudioChannel {
  SfxChannel() : super('sfx_channel');

  @override PlayerMode get playerMode => PlayerMode.lowLatency;
  @override ReleaseMode get releaseMode => ReleaseMode.stop;
}

final sfx = SfxChannel();
await sfx.play('assets/sfx/click.mp3');        // assets by default

sfx.changeSource((p) => UrlSource(p));         // swap loader at runtime
await sfx.play('https://example.com/alert.mp3');

await sfx.withFade(() async {                  // wrap any action in fades
  await sfx.play('assets/sfx/alert.wav');
});