Requesting App Permissions

Before you start

• Required permissions enabled in App Settings
• A rebuilt APK containing the manifest entries

Configure and verify

1. Enable only needed permissions

   Configure camera, microphone, location, Firebase notifications, file downloads, or audio controls in the dashboard.

2. Choose natural timing

   Prefer requesting a permission immediately before the user starts the related action. Firebase can also request notification permission at first launch.

3. Call the helper

   Use webtoapp.requestPermissions() from a user gesture when manual timing is selected.

4. Handle denial

   Keep the website usable when permission is denied. Explain why it is needed and provide a route to device settings after permanent denial.

5. Test Android versions

   Test Android 13+ notification permission and an older supported Android release because permission behavior differs.

Example

button.addEventListener("click", function () {
  if (window.webtoapp) webtoapp.requestPermissions();
});

Web API prompts

WebView camera, microphone, geolocation, and file chooser flows can also request permission when the website invokes their browser APIs.

Test before release

• Permission is declared in dashboard
• Request follows a user action
• Denied state is usable
• Permanent denial is explained
• No unrelated permission is requested