Voices - RunAnywhere Documentation

final voices = await RunAnywhere.tts.voices();

Signature

Future<List<Voice>> voices()

The list reflects the loaded speech model, so call it after the model is in place rather than at launch. Load a different TTS model and the list changes.

Selecting one

RunAnywhere.tts.speak(
  'Hello',
  options: TtsOptions(voice: 'en_US-amy-medium'),
);

With voice unset, the model’s own default is used.

Language and voice are separate

language sets the language code; voice picks a speaker. A multi-voice model exposes several speakers for one language, and a single-voice model ignores voice entirely.

TtsOptions(
  voice: 'en_US-amy-medium',
  language: 'en-US',
  speed: 1.0,
  pitch: 1.0,
)

Letting a person choose

class VoicePicker extends StatefulWidget {
  const VoicePicker({super.key});

  @override
  State<VoicePicker> createState() => _VoicePickerState();
}

class _VoicePickerState extends State<VoicePicker> {
  List<Voice> _voices = const [];
  String? _selected;

  @override
  void initState() {
    super.initState();
    RunAnywhere.tts.voices().then((voices) {
      if (mounted) setState(() => _voices = voices);
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        for (final voice in _voices)
          RadioListTile<String>(
            value: voice.toString(),
            groupValue: _selected,
            title: Text(voice.toString()),
            onChanged: (value) {
              setState(() => _selected = value);
              RunAnywhere.tts.speak(
                'This is how I sound.',
                options: TtsOptions(voice: value),
              );
            },
          ),
      ],
    );
  }
}

The mounted check matters: voices() is async and the widget may be gone by the time it resolves.