react-native-ringer-mode 

React Native Ringer Mode - Get and set ringer mode on Android devices.

> ⚠️ This package only supports Android. All functions will return undefined on non-Android devices. See https://github.com/reyhankaplan/react-native-ringer-mode/issues/3.

Installation

``sh
npm install react-native-ringer-mode
`

Usage

$3

`js
import React from 'react';

import { View, Text, Button } from 'react-native';
import { useRingerMode, RINGER_MODE } from 'react-native-ringer-mode';

const modeText = {
[RINGER_MODE.silent]: 'Silent',
[RINGER_MODE.normal]: 'Normal',
[RINGER_MODE.vibrate]: 'Vibrate',
};

export default function App() {
const { mode, error, setMode } = useRingerMode();

return (

Ringer Mode: {mode !== undefined ? modeText[mode] : null}


setMode(RINGER_MODE.silent)} />
setMode(RINGER_MODE.normal)} />
setMode(RINGER_MODE.vibrate)} />


{error?.message}


);
}
`

$3

getRingerMode is an async function and resolves the current ringer mode of the device.
(Resolves undefined on non-Android devices.)

`js
import React, { useEffect, useState } from 'react';

import { View, Text } from 'react-native';
import {
RINGER_MODE,
getRingerMode,
RingerModeType,
} from 'react-native-ringer-mode';

const modeText = {
[RINGER_MODE.silent]: 'Silent',
[RINGER_MODE.normal]: 'Normal',
[RINGER_MODE.vibrate]: 'Vibrate',
};

export default function App() {
const [mode, setMode] = useState();

useEffect(() => {
(async () => {
try {
const currentMode = await getRingerMode();
setMode(currentMode);
} catch (error) {
console.error(error);
}
})();
}, []);

return (

Ringer Mode: {mode !== undefined ? modeText[mode] : null}

);
}

`

$3

setRingerMode is an async function that sets the given ringer mode to the device and resolves the mode if it is set.
(Resolves undefined on non-Android devices.)

`js
import React from 'react';

import { View, Button } from 'react-native';
import {
setRingerMode,
RINGER_MODE,
RingerModeType,
} from 'react-native-ringer-mode';

export default function App() {
const setMode = (mode: RingerModeType) => {
try {
setRingerMode(mode);
} catch (error) {
console.error(error);
}
};
return (



setMode(RINGER_MODE.silent)} />
setMode(RINGER_MODE.normal)} />
setMode(RINGER_MODE.vibrate)} />

);
}
`

$3

From N onward, ringer mode adjustments that would toggle Do Not Disturb are not allowed unless the app has been granted Do Not Disturb Access. See AudioManager#setRingerMode).

If you want to change the ringer mode from Silent mode or to Silent mode, you may run into the Not allowed to change Do Not Disturb state error. The example below checks the DND access and if user hasn't given the access opens the settings for it.

First you need to add the line below to your AndroidManifest.xml to be able to see your app in the settings.

`xml

`

And you can check and request permission before setting the ringer mode. Example code below:

`js
import React from 'react';
import { View, Button } from 'react-native';

import {
useRingerMode,
RINGER_MODE,
checkDndAccess,
requestDndAccess,
RingerModeType,
} from 'react-native-ringer-mode';

export default function App() {
const { mode, setMode } = useRingerMode();

const changeMode = async (newMode: RingerModeType) => {
// From N onward, ringer mode adjustments that would toggle Do Not Disturb
// are not allowed unless the app has been granted Do Not Disturb Access.
// @see https://developer.android.com/reference/android/media/AudioManager#setRingerMode(int)
if (newMode === RINGER_MODE.silent || mode === RINGER_MODE.silent) {
const hasDndAccess = await checkDndAccess();
if (hasDndAccess === false) {
// This function opens the DND settings.
// You can ask user to give the permission with a modal before calling this function.
requestDndAccess();
return;
}
}

setMode(newMode);
};

return (



changeMode(RINGER_MODE.silent)} />
changeMode(RINGER_MODE.normal)} />
changeMode(RINGER_MODE.vibrate)} />

);
}
``

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT