flutter_ringtone_player

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein leichtgewichtiger Flutter-Paket, der die Wiedergabe von Systemstandardtonen, Alarmen und Benachrichtigungen auf Android- und iOS-Geräten ermöglicht. Es bietet eine einfache API zum Zugriff und Abspielen eingebetteter Soundressourcen ohne externe Dateiverarbeitung. Ideal für Apps, die gerätespezifische Audiohinweise wie Erinnerungen, Warnungen oder Benachrichtigungstöne auslösen müssen. Das Paket integriert sich nahtlos in die native Audio-Systeme der Plattformen und unterstützt beide Plattformen mit minimaler Konfiguration.

Anwendungsfälle

Systemtonrufe in Erinnerungs-Apps abspielen
Alarmgeräusche in Aufgabenverwaltungstools auslösen
Benachrichtigungstöne in Messaging-Apps nachahmen
Simulieren von Gerätealarmtönen in Nutzungsanwendungen
Stummschaltung-Fallbacks mit Klingelton-Wiedergabe aktivieren

Hauptmerkmale

Zugriff auf Standardtonfolgen des Systems
Unterstützung für Android und iOS
Minimale Einrichtung und Integration
Plattformübergreifende Kompatibilität
Einfache Playback-Steuerungs-API

Geeignet für

Entwickler von Erinnerungs- oder Warnungsanwendungen
Apps, die native Benachrichtigungstöne erfordern
Nützliche Tools, die Audiogrückmeldung vom Gerät benötigen
Mobile Apps für Android und iOS

Hinweise

Erforderliche Plattformberechtigungen
Beschränkt auf systembereitgestellte Audioressourcen
Keine Unterstützung für benutzerdefinierte Klingeltöne
Das Verhalten kann sich zwischen Android und iOS leicht unterscheiden
Abhängig von der Verfügbarkeit des nativen System-Audios

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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,
);

Pakete, Repositories und App-Kategorien suchen