--- description: Capacitor plugin to detect whether the device is in silent mode, read the ringer mode, and listen for changes on Android and iOS. title: Capacitor Silent Mode Plugin for Android & iOS - Capawesome image: https://capawesome.io/docs/assets/images/social/sdks/capacitor/silent-mode.png --- [Skip to content ](#capacitor-silent-mode-plugin) [πŸ“² Introducing **Build Sharing** β€” get your builds onto testers' devices with a link & QR code. No account required. ](/blog/share-mobile-app-builds-with-testers/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ Gyroscope ](/docs/sdks/capacitor/gyroscope/) * [ Haptics ](/docs/sdks/capacitor/haptics/) * [ Home Indicator ](/docs/sdks/capacitor/home-indicator/) * [ In-App Browser ](/docs/sdks/capacitor/in-app-browser/) * [ Install Referrer ](/docs/sdks/capacitor/install-referrer/) * [ Intercom ](/docs/sdks/capacitor/intercom/) * [ Intune ](/docs/sdks/capacitor/intune/) * [ Keep Awake ](/docs/sdks/capacitor/keep-awake/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Light Sensor ](/docs/sdks/capacitor/light-sensor/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Localization ](/docs/sdks/capacitor/localization/) * [ Mail Composer ](/docs/sdks/capacitor/mail-composer/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Maps Launcher ](/docs/sdks/capacitor/maps-launcher/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ Network ](/docs/sdks/capacitor/network/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ Node.js ](/docs/sdks/capacitor/nodejs/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Passkeys ](/docs/sdks/capacitor/passkeys/) * [ Password Autofill ](/docs/sdks/capacitor/password-autofill/) * [ PDF Generator ](/docs/sdks/capacitor/pdf-generator/) * [ PDF Viewer ](/docs/sdks/capacitor/pdf-viewer/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Permissions ](/docs/sdks/capacitor/permissions/) * [ Phone Dialer ](/docs/sdks/capacitor/phone-dialer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ Photo Manipulator ](/docs/sdks/capacitor/photo-manipulator/) * [ PixLive ](/docs/sdks/capacitor/pixlive/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Privacy Screen ](/docs/sdks/capacitor/privacy-screen/) * [ Proximity Sensor ](/docs/sdks/capacitor/proximity-sensor/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Root Detection ](/docs/sdks/capacitor/root-detection/) * [ Screen Brightness ](/docs/sdks/capacitor/screen-brightness/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screen Reader ](/docs/sdks/capacitor/screen-reader/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Settings Launcher ](/docs/sdks/capacitor/settings-launcher/) * [ Shake ](/docs/sdks/capacitor/shake/) * Silent Mode [ Silent Mode ](/docs/sdks/capacitor/silent-mode/) * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ Silent Mode Detection ](#silent-mode-detection) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) * [ SIM ](/docs/sdks/capacitor/sim/) * [ SMS Composer ](/docs/sdks/capacitor/sms-composer/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ System WebView ](/docs/sdks/capacitor/system-webview/) * [ Tauri ](/docs/sdks/capacitor/tauri/) * [ Text Interaction ](/docs/sdks/capacitor/text-interaction/) * [ Text Zoom ](/docs/sdks/capacitor/text-zoom/) * [ Thermal State ](/docs/sdks/capacitor/thermal-state/) * [ Toast ](/docs/sdks/capacitor/toast/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Volume ](/docs/sdks/capacitor/volume/) * [ Wallet ](/docs/sdks/capacitor/wallet/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ YouTube Player ](/docs/sdks/capacitor/youtube-player/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm, Yarn, or bun ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Notifications * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories * [ API ](#api) * [ Type Aliases ](#type-aliases) * [ Silent Mode Detection ](#silent-mode-detection) * [ FAQ ](#faq) * [ Related Plugins ](#related-plugins) * [ Newsletter ](#newsletter) * [ Changelog ](#changelog) * [ License ](#license) # Capacitor Silent Mode Plugin[ΒΆ](#capacitor-silent-mode-plugin "Permanent link") Capacitor plugin to detect whether the device is in silent mode. [ ![Deliver Live Updates to your Capacitor app with Capawesome Cloud](../../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://cloud.capawesome.io/) ## Features[ΒΆ](#features "Permanent link") * πŸ”‡ **Silent detection**: Check whether the device is currently in silent mode. * πŸ”” **Ringer mode**: Read the exact ringer mode (normal, vibrate or silent) on Android. * πŸ‘‚ **Change events**: Listen for changes to the silent mode state. * 🀝 **Compatibility**: Works alongside the [Audio Session](https://capawesome.io/docs/sdks/capacitor/audio-session/), [Haptics](https://capawesome.io/docs/sdks/capacitor/haptics/) and [Volume](https://capawesome.io/docs/sdks/capacitor/volume/) plugins. * πŸ“¦ **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS. * πŸ” **Up-to-date**: Always supports the latest Capacitor version. Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look! ## Use Cases[ΒΆ](#use-cases "Permanent link") The Silent Mode plugin is typically used to adapt an app's audio behavior to the device's ringer state, for example: * **Respect the mute switch**: Skip sound effects or in-app notification sounds while the device is in silent mode. * **Muted playback defaults**: Start audio or video content muted when the device is silent. * **Sound or vibration**: Use the exact ringer mode on Android to decide between playing a sound and vibrating. * **Live state updates**: React immediately when the user changes the silent mode state using the `silentModeChange` listener. ## Compatibility[ΒΆ](#compatibility "Permanent link") | Plugin Version | Capacitor Version | Status | | -------------- | ----------------- | -------------- | | 0.x.x | \>=8.x.x | Active support | ## Installation[ΒΆ](#installation "Permanent link") You can use our **AI-Assisted Setup** to install the plugin. Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command: `[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-plugins ` Then use the following prompt: `` [](#%5F%5Fcodelineno-1-1) Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-silent-mode` plugin in my project. `` If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below: `[](#%5F%5Fcodelineno-2-1)npm install @capawesome/capacitor-silent-mode [](#%5F%5Fcodelineno-2-2)npx cap sync ` This plugin is only available on **Android** and **iOS**. On the Web, all methods reject as unimplemented. ## Configuration[ΒΆ](#configuration "Permanent link") No configuration required for this plugin. ## Usage[ΒΆ](#usage "Permanent link") The following examples show how to check whether the device is in silent mode, read the exact ringer mode, and listen for silent mode changes. ### Check whether the device is in silent mode[ΒΆ](#check-whether-the-device-is-in-silent-mode "Permanent link") Get the current silent mode state of the device. On Android, the device is considered silent if the ringer mode is not set to normal (that is, either vibrate or silent). On iOS, the state is determined using a heuristic (see [Silent Mode Detection](#silent-mode-detection)). Only available on Android and iOS: `[](#%5F%5Fcodelineno-3-1)import { SilentMode } from '@capawesome/capacitor-silent-mode'; [](#%5F%5Fcodelineno-3-2) [](#%5F%5Fcodelineno-3-3)const isSilent = async () => { [](#%5F%5Fcodelineno-3-4) const { silent } = await SilentMode.isSilent(); [](#%5F%5Fcodelineno-3-5) return silent; [](#%5F%5Fcodelineno-3-6)}; ` ### Read the exact ringer mode[ΒΆ](#read-the-exact-ringer-mode "Permanent link") Read the current ringer mode (`normal`, `vibrate` or `silent`), for example to distinguish between the vibrate and silent modes. Only available on Android: `[](#%5F%5Fcodelineno-4-1)import { SilentMode } from '@capawesome/capacitor-silent-mode'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)const getRingerMode = async () => { [](#%5F%5Fcodelineno-4-4) const { mode } = await SilentMode.getRingerMode(); [](#%5F%5Fcodelineno-4-5) return mode; [](#%5F%5Fcodelineno-4-6)}; ` ### Listen for silent mode changes[ΒΆ](#listen-for-silent-mode-changes "Permanent link") Attach a listener to be notified when the silent mode state changes. The device is only observed while at least one listener is attached. On iOS, the state is polled on a timer while the app is in the foreground: `[](#%5F%5Fcodelineno-5-1)import { SilentMode } from '@capawesome/capacitor-silent-mode'; [](#%5F%5Fcodelineno-5-2) [](#%5F%5Fcodelineno-5-3)const addSilentModeChangeListener = async () => { [](#%5F%5Fcodelineno-5-4) await SilentMode.addListener('silentModeChange', event => { [](#%5F%5Fcodelineno-5-5) console.log('Silent mode changed:', event.silent); [](#%5F%5Fcodelineno-5-6) }); [](#%5F%5Fcodelineno-5-7)}; ` ### Stop listening for changes[ΒΆ](#stop-listening-for-changes "Permanent link") Remove all listeners when you no longer need to observe the silent mode state: `[](#%5F%5Fcodelineno-6-1)import { SilentMode } from '@capawesome/capacitor-silent-mode'; [](#%5F%5Fcodelineno-6-2) [](#%5F%5Fcodelineno-6-3)const removeAllListeners = async () => { [](#%5F%5Fcodelineno-6-4) await SilentMode.removeAllListeners(); [](#%5F%5Fcodelineno-6-5)}; ` ## API[ΒΆ](#api "Permanent link") * [getRingerMode()](#getringermode) * [isSilent()](#issilent) * [addListener('silentModeChange', ...)](#addlistenersilentmodechange-) * [removeAllListeners()](#removealllisteners) * [Interfaces](#interfaces) * [Type Aliases](#type-aliases) ### getRingerMode()[ΒΆ](#getringermode "Permanent link") `[](#%5F%5Fcodelineno-7-1)getRingerMode() => Promise ` Get the current ringer mode of the device. Only available on Android. **Returns:** `Promise<[GetRingerModeResult](#getringermoderesult)>` **Since:** 0.1.0 --- ### isSilent()[ΒΆ](#issilent "Permanent link") `[](#%5F%5Fcodelineno-8-1)isSilent() => Promise ` Get the current silent mode state of the device. On Android, the device is considered silent if the ringer mode is not set to normal (that is, either vibrate or silent). On iOS, there is no public API to read the ring/silent switch. The state is therefore determined using a heuristic that plays a short muted system sound and measures how long it takes to complete. The result may be inaccurate while other audio is playing. Only available on Android and iOS. **Returns:** `Promise<[IsSilentResult](#issilentresult)>` **Since:** 0.1.0 --- ### addListener('silentModeChange', ...)[ΒΆ](#addlistenersilentmodechange "Permanent link") `[](#%5F%5Fcodelineno-9-1)addListener(eventName: 'silentModeChange', listenerFunc: (event: SilentModeChangeEvent) => void) => Promise ` Listen for changes to the silent mode state of the device. The device is only observed while at least one listener is attached. On iOS, the state is polled on a timer while the app is in the foreground and the listener is not called while the app is in the background. Only available on Android and iOS. | Param | Type | | ---------------- | ---------------------------------------------------------------- | | **eventName** | 'silentModeChange' | | **listenerFunc** | (event: [SilentModeChangeEvent](#silentmodechangeevent)) => void | **Returns:** `Promise<[PluginListenerHandle](#pluginlistenerhandle)>` **Since:** 0.1.0 --- ### removeAllListeners()[ΒΆ](#removealllisteners "Permanent link") `[](#%5F%5Fcodelineno-10-1)removeAllListeners() => Promise ` Remove all listeners for this plugin. **Since:** 0.1.0 --- ### Interfaces[ΒΆ](#interfaces "Permanent link") #### GetRingerModeResult[ΒΆ](#getringermoderesult "Permanent link") | Prop | Type | Description | Since | | -------- | ------------------------- | -------------------------------------- | ----- | | **mode** | [RingerMode](#ringermode) | The current ringer mode of the device. | 0.1.0 | #### IsSilentResult[ΒΆ](#issilentresult "Permanent link") | Prop | Type | Description | Since | | ---------- | ------- | ----------------------------------------------- | ----- | | **silent** | boolean | Whether the device is currently in silent mode. | 0.1.0 | #### PluginListenerHandle[ΒΆ](#pluginlistenerhandle "Permanent link") | Prop | Type | | ---------- | ------------------- | | **remove** | () => Promise | #### SilentModeChangeEvent[ΒΆ](#silentmodechangeevent "Permanent link") | Prop | Type | Description | Since | | ---------- | ------- | ----------------------------------------------- | ----- | | **silent** | boolean | Whether the device is currently in silent mode. | 0.1.0 | ### Type Aliases[ΒΆ](#type-aliases "Permanent link") #### RingerMode[ΒΆ](#ringermode "Permanent link") The ringer mode of the device. * `normal`: The device plays sounds and rings for incoming calls. * `silent`: The device is silent and does not vibrate. * `vibrate`: The device is silent but vibrates. `'normal' | 'silent' | 'vibrate'` ## Silent Mode Detection[ΒΆ](#silent-mode-detection "Permanent link") Keep the following platform differences in mind when detecting silent mode: * **Android**: The silent mode state is derived from the [ringer mode](https://developer.android.com/reference/android/media/AudioManager#getRingerMode%28%29). A device is considered silent whenever the ringer mode is not `normal`, which means that the vibrate mode also counts as silent. Use `getRingerMode()` if you need to distinguish between the vibrate and silent modes. * **iOS**: There is no public API to read the state of the ring/silent switch. The plugin therefore relies on a heuristic that plays a short muted system sound and measures how long it takes to complete. As a result, the detection may be inaccurate while other audio is playing or when the audio session category overrides the switch. The `silentModeChange` listener polls this heuristic on a timer while the app is in the foreground and pauses while the app is in the background. ## FAQ[ΒΆ](#faq "Permanent link") ### How is this plugin different from other similar plugins?[ΒΆ](#how-is-this-plugin-different-from-other-similar-plugins "Permanent link") It reports whether the device is in silent mode on both Android and iOS, and on Android it also exposes the exact ringer mode so you can distinguish vibrate from fully silent. A `silentModeChange` listener lets you react the moment the state changes, and the device is only observed while a listener is attached. Everything is delivered through a fully typed API that supports CocoaPods and Swift Package Manager on iOS and tracks the latest Capacitor version. ### How does silent mode detection work on iOS?[ΒΆ](#how-does-silent-mode-detection-work-on-ios "Permanent link") iOS provides no public API to read the state of the ring/silent switch. The plugin therefore relies on a heuristic that plays a short muted system sound and measures how long it takes to complete. As a result, the detection may be inaccurate while other audio is playing or when the audio session category overrides the switch. See [Silent Mode Detection](#silent-mode-detection) for details. ### Why is vibrate mode reported as silent on Android?[ΒΆ](#why-is-vibrate-mode-reported-as-silent-on-android "Permanent link") On Android, the device is considered silent whenever the ringer mode is not set to normal, which includes both the vibrate and silent modes. If you need to distinguish between them, use the `getRingerMode` method, which returns the exact ringer mode. This method is only available on Android. ### Can I detect silent mode changes while the app is in the background?[ΒΆ](#can-i-detect-silent-mode-changes-while-the-app-is-in-the-background "Permanent link") On iOS, no. The `silentModeChange` listener polls the silent mode state on a timer while the app is in the foreground and pauses while the app is in the background. Also note that the device is only observed while at least one listener is attached. ### Is the Silent Mode plugin available on the Web?[ΒΆ](#is-the-silent-mode-plugin-available-on-the-web "Permanent link") No, the plugin is only available on Android and iOS. On the Web, all methods reject as unimplemented, since browsers do not expose the device's ringer state. ### Can I use this plugin with Ionic, React, Vue or Angular?[ΒΆ](#can-i-use-this-plugin-with-ionic-react-vue-or-angular "Permanent link") Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects. ## Related Plugins[ΒΆ](#related-plugins "Permanent link") * [Audio Session](https://capawesome.io/docs/sdks/capacitor/audio-session/): Configure and observe the iOS audio session. * [Haptics](https://capawesome.io/docs/sdks/capacitor/haptics/): Provide haptic feedback such as impacts, notifications, and vibrations. * [Volume](https://capawesome.io/docs/sdks/capacitor/volume/): Control the volume and observe hardware volume button presses. ## Newsletter[ΒΆ](#newsletter "Permanent link") Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/). ## Changelog[ΒΆ](#changelog "Permanent link") See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/silent-mode/CHANGELOG.md). ## License[ΒΆ](#license "Permanent link") See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/silent-mode/LICENSE). July 8, 2026 Back to top ```json {"@context": "https://schema.org", "@graph": [{"@type": "TechArticle", "@id": "https://capawesome.io/docs/sdks/capacitor/silent-mode/#article", "headline": "Capacitor Silent Mode Plugin for Android & iOS", "name": "Capacitor Silent Mode Plugin for Android & iOS", "description": "Capacitor plugin to detect whether the device is in silent mode, read the ringer mode, and listen for changes on Android and iOS.", "inLanguage": "en", "url": "https://capawesome.io/docs/sdks/capacitor/silent-mode/", "mainEntityOfPage": "https://capawesome.io/docs/sdks/capacitor/silent-mode/", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "about": {"@id": "https://capawesome.io/docs/sdks/capacitor/silent-mode/#software"}}, {"@type": "SoftwareSourceCode", "@id": "https://capawesome.io/docs/sdks/capacitor/silent-mode/#software", "name": "Capacitor Silent Mode Plugin for Android & iOS", "description": "Capacitor plugin to detect whether the device is in silent mode, read the ringer mode, and listen for changes on Android and iOS.", "url": "https://capawesome.io/docs/sdks/capacitor/silent-mode/", "programmingLanguage": "TypeScript", "runtimePlatform": "Capacitor", "codeRepository": "https://github.com/capawesome-team", "author": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}, "publisher": {"@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": {"@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg"}}}]} {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "How is this plugin different from other similar plugins?", "acceptedAnswer": {"@type": "Answer", "text": "It reports whether the device is in silent mode on both Android and iOS, and on Android it also exposes the exact ringer mode so you can distinguish vibrate from fully silent. A silentModeChange listener lets you react the moment the state changes, and the device is only observed while a listener is attached. Everything is delivered through a fully typed API that supports CocoaPods and Swift Package Manager on iOS and tracks the latest Capacitor version."}}, {"@type": "Question", "name": "How does silent mode detection work on iOS?", "acceptedAnswer": {"@type": "Answer", "text": "iOS provides no public API to read the state of the ring/silent switch. The plugin therefore relies on a heuristic that plays a short muted system sound and measures how long it takes to complete. As a result, the detection may be inaccurate while other audio is playing or when the audio session category overrides the switch. See Silent Mode Detection for details."}}, {"@type": "Question", "name": "Why is vibrate mode reported as silent on Android?", "acceptedAnswer": {"@type": "Answer", "text": "On Android, the device is considered silent whenever the ringer mode is not set to normal, which includes both the vibrate and silent modes. If you need to distinguish between them, use the getRingerMode method, which returns the exact ringer mode. This method is only available on Android."}}, {"@type": "Question", "name": "Can I detect silent mode changes while the app is in the background?", "acceptedAnswer": {"@type": "Answer", "text": "On iOS, no. The silentModeChange listener polls the silent mode state on a timer while the app is in the foreground and pauses while the app is in the background. Also note that the device is only observed while at least one listener is attached."}}, {"@type": "Question", "name": "Is the Silent Mode plugin available on the Web?", "acceptedAnswer": {"@type": "Answer", "text": "No, the plugin is only available on Android and iOS. On the Web, all methods reject as unimplemented, since browsers do not expose the device's ringer state."}}, {"@type": "Question", "name": "Can I use this plugin with Ionic, React, Vue or Angular?", "acceptedAnswer": {"@type": "Answer", "text": "Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects."}}], "url": "https://capawesome.io/docs/sdks/capacitor/silent-mode/"} ```