Description:

sound mode

sound_mode #
You can get the sound mode status on IOS & Android!
On Android you can also manage the device's sound mode.
Features #

Detect device's current sound mode (both IOS & Android)
Able to toggle between Normal, Silent & Vibrate mode (only Android)
Grant Do No Disturb permissions for devices above platform version Android 6.0 (API 23) (only Android)

Android Usage #
Add sound_mode as a dependency in your pubspec.yaml file
Add the following permission to AndroidManifest.xml for the app to appear in the 'Do Not Disturb Access' list
<manifest ... >
<uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY"/>

<application ... >
...
</manifest>
copied to clipboard
Example #
To get the device's current sound mode:
String ringerStatus = await SoundMode.ringerModeStatus;
print(ringerStatus);
copied to clipboard
To change the device's sound mode:
import 'package:sound_mode/utils/ringer_mode_statuses.dart';

// Handle Platform Exceptions for devices running above Android 6.0
try {
await SoundMode.setSoundMode(RingerModeStatus.silent);
} on PlatformException {
print('Please enable permissions required');
}
copied to clipboard
For Android 6.0 and above
For devices with Android 6.0 and above, it is required for the user to grant Do No Disturb Access to set their device's sound mode.
To check if the user has granted the permissions and prompt for approval
import 'package:sound_mode/permission_handler.dart';

bool isGranted = await PermissionHandler.permissionsGranted;

if (!isGranted) {
// Opens the Do Not Disturb Access settings to grant the access
await PermissionHandler.openDoNotDisturbSetting();
}
copied to clipboard
iOS Usage #
WARNING: This only works on real IOS devices. Not in the simulator.
Currently, it is possible to get the device's ringer mode status.
For iOS, the following lines of code can be added to use it in flutter.
Example #
RingerModeStatus ringerStatus = RingerModeStatus.unknown;

// The one second delay is needed to get accurate results on IOS...
Future.delayed(const Duration(seconds: 1), () async {
try {
ringerStatus = await SoundMode.ringerModeStatus;
} catch (err) {
ringerStatus = RingerModeStatus.unknown;
}
print(ringerStatus);
});
copied to clipboard
List of RingerModeStatus statuses #



Status
Description




RingerModeStatus.unknown
Don't know the status


RingerModeStatus.normal
Device is in normal mode


RingerModeStatus.silent
Device is in silent mode


RingerModeStatus.vibrate
Device is in vibrate mode



Contributing #
Feel free to edit the plugin and submit a pull request or open an issue on github to leave a feedback
License #
MIT

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Share

• Share on Facebook
• Share on Twitter