output_route_selector 1.0.6

A Flutter plugin to select audio output routes (speaker, receiver, bluetooth, wired headset) on iOS devices.

Output Route Selector

A Flutter plugin that provides native iOS audio output selection with a system-style UIMenu.

Features

• Native UIMenu - Real iOS system menu with glass/blur effect
• Automatic device detection - Speaker, Receiver, Bluetooth, Wired Headset
• SF Symbols icons - AirPods, speaker, iPhone, headphones icons
• Custom Bluetooth icon - SVG support for non-AirPods devices
• Real-time events - Stream notifications when audio route changes
• Zero Flutter-side management - All device handling is native

Installation

dependencies:
  output_route_selector: ^1.0.5

iOS Setup

Add to your Info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>Required for audio routing</string>

Minimum iOS version: 14.0

Usage

1. Add the Widget

import 'package:output_route_selector/output_route_selector.dart';

// Simple usage
AudioOutputSelector(
  size: 44,
  child: Icon(Icons.volume_up, size: 24),
)

// With custom dimensions
AudioOutputSelector(
  width: 50,
  height: 50,
  child: Icon(Icons.speaker, size: 30, color: Colors.blue),
)

// With AssetGenImage
AudioOutputSelector(
  size: 44,
  child: Assets.icons.speaker.image(width: 24, height: 24),
)

2. Listen to Events

OutputRouteSelector.instance.onAudioRouteChanged.listen((event) {
  print('Event: ${event.event}');
  print('Reason: ${event.reasonDescription}');
  
  if (event.activeDevice != null) {
    print('Active: ${event.activeDevice!.outputName}');
    print('Type: ${event.activeDevice!.deviceType}');
  }
});

Complete Example

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:output_route_selector/output_route_selector.dart';

class AudioDemo extends StatefulWidget {
  @override
  State<AudioDemo> createState() => _AudioDemoState();
}

class _AudioDemoState extends State<AudioDemo> {
  StreamSubscription<AudioRouteChangeEvent>? _subscription;
  String _currentDevice = 'Unknown';

  @override
  void initState() {
    super.initState();
    _subscription = OutputRouteSelector.instance.onAudioRouteChanged.listen((event) {
      setState(() {
        _currentDevice = event.activeDevice?.outputName ?? 'Unknown';
      });
    });
  }

  @override
  void dispose() {
    _subscription?.cancel();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        AudioOutputSelector(
          size: 64,
          child: Container(
            width: 64,
            height: 64,
            decoration: BoxDecoration(
              color: Colors.blue.withOpacity(0.1),
              borderRadius: BorderRadius.circular(32),
            ),
            child: Icon(Icons.volume_up, size: 32, color: Colors.blue),
          ),
        ),
        SizedBox(height: 16),
        Text('Current: $_currentDevice'),
      ],
    );
  }
}

API Reference

AudioOutputSelector

Parameter	Type	Default	Description
child	Widget	required	The widget to display as button
width	double	44	Button width
height	double	44	Button height
size	double?	null	Shorthand for width & height

OutputRouteSelector

Property	Description
instance	Singleton instance
onAudioRouteChanged	Stream of audio route change events

AudioRouteChangeEvent

Property	Type	Description
event	String	Event type
reason	int?	iOS route change reason
activeDevice	AudioModel?	Currently active device
reasonDescription	String	Human-readable reason

AudioModel

Property	Type	Description
title	String	Device identifier
isActive	bool	Whether device is active
deviceType	AudioDeviceType	Type of device
outputName	String	User-friendly name

AudioDeviceType

• speaker - Built-in speaker
• receiver - iPhone earpiece
• wiredHeadset - Wired headphones
• bluetooth - Bluetooth device

Menu Icons

Device	Icon
Speaker	speaker.wave.2.fill
iPhone	iphone
Headphones	headphones
AirPods	airpodspro
Other Bluetooth	Custom SVG / hifispeaker.fill

Platform Support

Platform	Status
iOS	✅ Full support (14.0+)
Android	❌ Not yet
Web	❌ Not applicable

License

MIT License - see LICENSE file