🎤Microphone

Grant your app access to the device microphone for audio and video recording.

What is the Microphone?

The Microphone feature gives your app access to the device's microphone, which other features rely on to function - Audio Recorder uses it to capture voice recordings, and Camera uses it when recording video with sound. The Microphone itself has no direct SDK - it's a permission gate that other features build on top of.

Requesting microphone access prompts the user for permission the first time it's used, on both iOS and Android.

Prerequisites

This feature is available in any paid plan. See all plans

Natively Dashboard Setup

Microphone is automatically enabled for all new apps. You only need to visit this section if you want to disable it or update the Permission Description.

1. Open your Natively app dashboard and navigate to Features > Microphone.

2. Toggle the feature to Enabled.

3. Enter the Permission Description.

4. Click Save.

5. Rebuild your app(s).

The Permission Description is the text shown to users when the OS asks them to grant microphone access. Explain clearly why your app needs this permission - for example: "We use your microphone to let you record voice messages."

You must rebuild your app for these changes to take effect.

Implementation

Instead of an Initialization/Setup Logic pair, this section lists the features that rely on Microphone access and how each one uses it.

Features that use Microphone

📷Camera🎙️Audio Recorder

How to use

Enable Microphone before implementing either feature

Since neither Audio Recorder nor Camera's video recording can request permission on their own if Microphone is disabled, always confirm Microphone is enabled in the dashboard before building on top of it.

Write one Permission Description that fits every use case in your app

If you use both Audio Recorder and Camera video recording, make sure the Permission Description covers the full scope of why your app needs microphone access, not just one feature's use case.

Test the permission prompt path end-to-end

Trigger whichever dependent feature (Audio Recorder or Camera video) is reachable first in your app's flow, and confirm the system prompt appears with your configured description before relying on it in production.

Troubleshooting

Microphone permission denied

If the user previously denied microphone access, no dependent feature (Audio Recorder, Camera video) will be able to prompt again automatically. Direct them to Open App Settings to manually re-enable the permission.

Permission Description causes App Store rejection

Apple requires a clear, specific explanation for microphone access. Avoid generic text like "we need this to improve the app" - describe the actual use case (e.g., "We use your microphone to let you record voice messages").