@anuradev/capacitor-background-mode

Capacitor plugin to enable background mode

This plugin replace to capacitor-plugin-background-mode

Install

npm install @anuradev/capacitor-background-mode
npx cap sync

Background microphone access

Background microphone access is disabled by default. To enable it, declare the required permissions in the consuming application's AndroidManifest.xml:

<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

Request the microphone permission and enable the foreground service with:

await BackgroundMode.requestMicrophonePermission();
await BackgroundMode.enable({ allowMicrophoneInBackground: true });

API

• enable(...)
• disable()
• updateNotification(...)
• checkNotificationsPermission()
• requestNotificationsPermission()
• checkMicrophonePermission()
• requestMicrophonePermission()
• checkBatteryOptimizations()
• requestDisableBatteryOptimizations()
• enableWebViewOptimizations()
• disableWebViewOptimizations()
• moveToBackground()
• moveToForeground()
• isScreenOff()
• isEnabled()
• isActive()
• wakeUp()
• unlock()
• addListener('appInBackground', ...)
• addListener('appInForeground', ...)
• removeAllListeners()
• Interfaces
• Type Aliases

enable(...)

enable(settings: Partial<ISettings>) => Promise<void>

disable()

disable() => Promise<void>

updateNotification(...)

updateNotification(settings: Partial<ISettings>) => Promise<void>

checkNotificationsPermission()

checkNotificationsPermission() => Promise<NotificationPermissionStatus>

Returns: Promise<NotificationPermissionStatus>

requestNotificationsPermission()

requestNotificationsPermission() => Promise<NotificationPermissionStatus>

Returns: Promise<NotificationPermissionStatus>

checkMicrophonePermission()

checkMicrophonePermission() => Promise<MicrophonePermissionStatus>

Returns: Promise<MicrophonePermissionStatus>

requestMicrophonePermission()

requestMicrophonePermission() => Promise<MicrophonePermissionStatus>

Returns: Promise<MicrophonePermissionStatus>

checkBatteryOptimizations()

checkBatteryOptimizations() => Promise<{ enabled: boolean; }>

Returns: Promise<{ enabled: boolean; }>

requestDisableBatteryOptimizations()

requestDisableBatteryOptimizations() => Promise<{ enabled: boolean; }>

Returns: Promise<{ enabled: boolean; }>

enableWebViewOptimizations()

enableWebViewOptimizations() => Promise<void>

disableWebViewOptimizations()

disableWebViewOptimizations() => Promise<void>

moveToBackground()

moveToBackground() => Promise<void>

moveToForeground()

moveToForeground() => Promise<void>

isScreenOff()

isScreenOff() => Promise<{ isScreenOff: boolean; }>

Returns: Promise<{ isScreenOff: boolean; }>

isEnabled()

isEnabled() => Promise<{ enabled: boolean; }>

Returns: Promise<{ enabled: boolean; }>

isActive()

isActive() => Promise<{ activated: boolean; }>

Returns: Promise<{ activated: boolean; }>

wakeUp()

wakeUp() => Promise<void>

unlock()

unlock() => Promise<void>

addListener('appInBackground', ...)

addListener(eventName: 'appInBackground', listenerFunc: () => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

addListener('appInForeground', ...)

addListener(eventName: 'appInForeground', listenerFunc: () => void) => Promise<PluginListenerHandle>

Returns: Promise<PluginListenerHandle>

removeAllListeners()

removeAllListeners() => Promise<void>

Interfaces

ISettings

NotificationPermissionStatus

MicrophonePermissionStatus

PluginListenerHandle

Type Aliases

Partial

Make all properties in T optional

{ [P in keyof T]?: T[P]; }

PermissionState

'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'