flutter_ringtone_player

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote leve do Flutter que permite a reprodução de toques padrão do sistema, alarmes e notificações em dispositivos Android e iOS. Ele fornece uma API simples para acessar e reproduzir recursos de som embutidos sem exigir manipulação de arquivos externos. Ideal para aplicativos que precisam disparar sinais sonoros específicos do dispositivo, como lembretes, alertas ou sons de notificação. O pacote se integra perfeitamente aos sistemas de áudio nativos das plataformas e oferece suporte às duas com configuração mínima.

Casos de uso

Reproduzindo toques do sistema em aplicativos de lembrete
Acionar sons de alarme em ferramentas de gerenciamento de tarefas
Reproduzindo tons de notificação em aplicativos de mensagens
Simulando sons de alerta do dispositivo em aplicativos úteis
Habilitar fallbacks em modo silencioso com reprodução de toque

Principais recursos

Acesso aos toques padrão do sistema
Suporte para Android e iOS
Configuração e integração mínimas
Compatibilidade multiplataforma
API simples de controle de reprodução

Indicado para

Desenvolvedores de aplicativos de lembrete ou alerta
Aplicativos que exigem sons de notificação nativos
Ferramentas úteis que precisam de feedback de áudio do dispositivo
Aplicativos móveis direcionados para Android e iOS

Considerações

Requer permissões apropriadas da plataforma
Limitado a recursos de áudio fornecidos pelo sistema
Sem suporte para arquivos de toque personalizados
O comportamento pode variar levemente entre Android e iOS
Depende da disponibilidade de áudio do sistema nativo

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

A simple ringtone, alarm & notification player plugin.

Usage

Add following import to your code:

import 'package:flutter_ringtone_player/flutter_ringtone_player.dart';

Then simply call this to play system default notification sound:

FlutterRingtonePlayer().playNotification();

There's also this generic method allowing you to specify in detail what kind of ringtone should be played:

FlutterRingtonePlayer().play(
  android: AndroidSounds.notification,
  ios: IosSounds.glass,
  looping: true, // Android only - API >= 28
  volume: 0.1, // Android only - API >= 28
  asAlarm: false, // Android only - all APIs
);

Also you can specify a custom ringtone from assets, or provide direct path to file that works for both Android and iOS:

FlutterRingtonePlayer().play(fromAsset: "assets/ringtone.wav");

FlutterRingtonePlayer().play(fromFile: "assets/ringtone.wav");

You can specify a platform specific ringtone and it will override the one from assets:

FlutterRingtonePlayer().play(  
 fromAsset: "assets/ringtone.wav", // will be the sound on Android
 ios: IosSounds.glass 			   // will be the sound on iOS
 );

.play() optional attributes

Attribute	Description
`bool` looping	Enables looping of ringtone. Requires `FlutterRingtonePlayer().stop();` to stop ringing.
`double` volume	Sets ringtone volume in range 0 to 1.0.
`bool` asAlarm	Allows to ignore device's silent/vibration mode and play given sound anyway.

To stop looped ringtone please use:

FlutterRingtonePlayer().stop();

Above works only on Android, and please note that by default Alarm & Ringtone sounds are looped.

Default sounds

Method	Android	iOS
playAlarm	RingtoneManager.TYPE_ALARM	IosSounds.alarm
playNotification	RingtoneManager.TYPE_NOTIFICATION	IosSounds.triTone
playRingtone	RingtoneManager.TYPE_RINGTONE	IosSounds.electronic

Note on iOS sounds

If you want to use any other sound on iOS you can always specify a valid Sound ID and manually construct [IosSound]:

FlutterRingtonePlayer().play(
  android: AndroidSounds.notification,
  ios: const IosSound(1023),
  looping: true,
  volume: 0.1,
);

Buscar pacotes, repositórios e categorias de apps