# Ambient voice recording

## 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 <mark style="color:red;">More ⇒ Permission and select these permission:</mark>

<figure><img src="https://4187053630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjkSePRf5HsNK8f87ZonZ%2Fuploads%2Fgit-blob-c28042426db9ce00e097e826747731ee7f06bf60%2Fimage%20(87).png?alt=media" alt="" width="167"><figcaption></figcaption></figure>

5. **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 <mark style="color:red;">Agent App interface → menu More → Permissions ⇒ "</mark>*<mark style="color:red;">Do not optimize battery usage" like the requirement above</mark>*)
         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.