Ambient voice recording

Troubleshooting – Ambient Voice Recording Not Working

A. Minimum Requirements

1. Target device must have Internet access (Wi-Fi, 3G/4G/5G).

2. Your subscription package must include this feature.

   • Free packages may not support Ambient Recording, or the policy may have changed.

3. Daily and storage limits may apply.

   • For example: ~100 recordings per day, or a limited total MB quota.

   • Solution: Delete older recordings to free up space.

4. Missing Microphone Permission (RECORD_AUDIO)

   1. For example, the recording task fails immediately or shows “Permission denied” or "Missing required permission."

   2. Solution:

      1. Go to Settings → Privacy → Permission Manager → Microphone.

      2. Ensure the Agent app has permission.

      3. On Android 12+, confirm that Mic access in Quick Settings is turned ON.

You can open the Agent app and go to menu More ⇒ Permission and select these permission:

1. Battery Optimization or Background Restriction

   1. Recording stops after a few seconds, or only works with the screen on.

   2. Solution:

      1. Allow Background activity and Autostart for the Agent app.

         1. Turn off Battery optimization:

            • Open Android OS Settings → Apps → [Agent App Name] → Battery → Don’t optimize).

            • (Or you can open Agent App interface → menu More → Permissions ⇒ "Do not optimize battery usage" like the requirement above)

         2. On Xiaomi/OPPO/Vivo/Huawei devices, lock the app in Recents

---

B. Possible Causes and Fixes

1. Microphone Busy or During a Call

• Symptom: “Resource busy” error or empty recording file.

• Fix:

  • Stop other apps from using the mic (Messenger, Meet, Zalo, etc.).

  • Wait until all calls or VOIP sessions end.

2. Privacy Settings Blocking Microphone

• Symptom: The Green mic indicator shows, but the file is silent.

• Fix:

  • Turn off the Mic Off toggle in Quick Settings.

  • Check Privacy → Safety & Emergency, and disable any “mic blocker” apps.

3. Media Server Quota Full

• Symptom: Recording stops immediately or cannot be uploaded.

• Fix:

  • Delete old recordings from the server using the dashboard website where you are using this feature.

4. Outdated Agent or Disabled Ambient Module

• Symptom: No “Ambient” option or constant failure.

• Fix:

  • Update the Agent app to the latest version.

  • Verify DeviceSettings / FeatureControl → Ambient Recording = ON.

5. Consent Missing or Reset

• Symptom: Server refuses the task for missing consent.

• Fix:

  • Open Policy/Consent inside the Agent and reconsent.

  • Ensure consent is successfully saved.

6. Cooldown Between Recordings

• Symptom: First recording works, next one fails instantly.

• Fix:

  • Wait a few minutes before retrying to avoid hitting cooldown limits.

7. Bluetooth or External Audio Routing

• Symptom: Silent recordings while connected to a Bluetooth headset.

• Fix:

  • Turn off Bluetooth or disconnect the headset before recording.

8. Focus / Parental Control / Digital Wellbeing

• Symptom: Recording is disabled at specific times or under focus mode.

• Fix:

  • Check Digital Wellbeing / Focus / Parental Controls, and exclude the Agent app.