> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas de cámara en Android y WebView

> Causas y soluciones cuando la cámara no se abre en dispositivos Android o navegadores dentro de la aplicación (WebView), y cómo continuar la verificación en un navegador estándar.

En algunos dispositivos Android (especialmente ROMs personalizadas de fabricantes chinos) o navegadores dentro de la aplicación (WebView), la cámara puede no abrirse en la pantalla "Captura de ID > Inicializando cámara…". Verifique las causas y soluciones a continuación en orden y, si la cámara sigue fallando dentro de un WebView, use la **ruta de omisión para continuar en un navegador estándar**.

## Comprensión del problema

Cuando la cámara no se abre en un entorno WebView o Android, generalmente se debe a una de las siguientes causas.

* **Cámara bloqueada en el navegador dentro de la aplicación (WebView)**: Algunos navegadores dentro de aplicaciones y navegadores predeterminados de dispositivos chinos bloquean el acceso a la cámara (`getUserMedia`) dentro del WebView. Si llega a la pantalla de la cámara pero **no aparece ningún icono de cámara en uso en la parte superior**, la cámara está bloqueada en ese entorno.
* **Android System WebView desactualizado**: En un entorno APK WebView, una versión antigua de Android System WebView puede impedir que `getUserMedia` funcione, por lo que la cámara nunca se inicializa.
* **Permiso no concedido**: Si el permiso del dispositivo (sistema operativo) o el permiso del navegador (sitio) está desactivado, la cámara no se iniciará. En los dispositivos chinos, **ambos** permisos deben concederse por separado.
* **Otros factores del entorno**: Varias pestañas abiertas en el mismo navegador mientras la cámara está en uso, o una aplicación de seguridad/MDM instalada en el dispositivo que restringe el uso de la cámara.

## Soluciones

### 1. Espere un momento si la inicialización de la cámara es lenta

Al cambiar a la pantalla de captura de ID, la inicialización de la cámara puede retrasarse unos segundos según el rendimiento del dispositivo. Aunque la pantalla no aparezca de inmediato, espere un momento y continuará al siguiente paso normalmente.

### 2. Use un navegador estándar como Chrome

Los navegadores dentro de aplicaciones (WebView) y algunos navegadores predeterminados de dispositivos chinos pueden bloquear la cámara. Si no aparece ningún icono de cámara en la parte superior de la pantalla de la cámara, vuelva a abrir la página en el navegador **Chrome** y continúe.

<Tip>
  La cámara también puede fallar en navegadores abiertos desde dentro de aplicaciones como KakaoTalk, Facebook o Instagram. En ese caso, siga la guía [Continuar en un navegador estándar](#7-continuar-en-un-navegador-estándar-omisión-de-webview) a continuación.
</Tip>

### 3. Verifique los permisos de cámara (dispositivo + navegador)

En Android, incluidos los dispositivos chinos, tanto el **permiso del dispositivo (sistema operativo)** como el **permiso del navegador (sitio)** deben estar permitidos para que la cámara se inicie. Si alguno está desactivado, la cámara no se inicializará. Para los pasos detallados para volver a habilitar los permisos, consulte [Cómo habilitar el permiso de cámara](/es/idcheck/getting-started/camera-permission).

### 4. Mantenga abierta solo una pestaña del navegador

Si hay dos o más pestañas abiertas en el mismo navegador mientras la cámara está en uso, es posible que la cámara no funcione correctamente. Cierre todas las demás pestañas, mantenga solo una e intente de nuevo.

### 5. Verifique las aplicaciones que bloquean la cámara

Una aplicación de seguridad corporativa o una aplicación MDM (Mobile Device Management) puede restringir el uso de la cámara. Las aplicaciones de seguridad internas de algunos fabricantes son un ejemplo común. Desactive la aplicación e intente de nuevo.

### 6. Actualice Android System WebView (APK WebView)

Si la cámara no se inicializa en un entorno APK WebView, actualice **Android System WebView** y **Chrome** a la última versión desde Google Play y luego intente de nuevo.

<Note>
  Esto es especialmente probable en dispositivos con una versión de sistema operativo/WebView fija, como los dispositivos de banco de pruebas. La compatibilidad con `getUserMedia` depende de la versión de WebView, por lo que la actualización por sí sola a menudo lo resuelve.
</Note>

### 7. Continuar en un navegador estándar (omisión de WebView)

Si la cámara sigue sin abrirse dentro del navegador de la aplicación (WebView) después de los pasos anteriores, puede finalizar la verificación **abriendo el mismo enlace de ID Check en un navegador estándar**.

<Steps>
  <Step title="Obtenga el enlace de ID Check del servicio">
    Pida al servicio (su proveedor) que reenvíe el enlace de ID Check (LiveForm) por SMS, correo electrónico, etc. Si la pantalla de la aplicación ofrece una opción **«Abrir en el navegador predeterminado»**, puede usarla en su lugar.
  </Step>

  <Step title="Ábralo en un navegador estándar como Chrome / Safari">
    Pegue el enlace en la barra de direcciones del navegador predeterminado del teléfono (Android: **Chrome**, iOS: **Safari**) y ábralo.
  </Step>

  <Step title="Complete la verificación">
    Finalice la verificación (captura de ID, selfie, etc.) hasta el final. El resultado se refleja en el servicio igual que antes.
  </Step>
</Steps>

<Info>
  **Para integradores (el proveedor)**

  * Para gestionar a los usuarios que se quedan atascados en la cámara dentro de una aplicación (WebView), proporcione una ruta para **entregar el enlace de ID Check a un navegador externo** (por ejemplo, reenvío por SMS/correo electrónico, un botón «Abrir en el navegador predeterminado» o un código QR).
  * Al volver a abrir externamente, use siempre el **navegador predeterminado del sistema**. Volver a abrir en un **navegador integrado como Custom Tabs o SFSafariViewController puede reproducir el mismo problema de cámara.**
  * El resultado de la verificación se entrega a través de [Webhook](/es/idcheck/webhooks/overview) y la [Return URL](/es/idcheck/getting-started/liveform-url/return-url-guide) (`kycStatus` / `errorCode`), por lo que su servicio aún recibe el resultado incluso cuando el usuario completa la verificación en un navegador externo.
</Info>

<Warning>
  **Precaución al usar enlaces de un solo uso (token)**

  Un enlace con [`tokenId` (Private Mode)](/es/idcheck/getting-started/liveform-url/querystring-and-token-guide) o `startValidUntil` **caduca 3 minutos después del primer uso, o una vez que ya existe un envío con un resultado de KYC decidido (aprobado/rechazado/pendiente)**: volver a abrir el mismo enlace en un navegador enviará al usuario a una página de error. En ese caso, el proveedor debe **emitir un nuevo enlace para el reintento en el navegador**. Un enlace `?pid=` simple se vuelve a abrir normalmente como un nuevo envío. Si necesita mantener la misma identidad de usuario, vuelva a emitirlo con los mismos parámetros, como `userid` / `cf1`.
</Warning>

## Si el problema persiste

Si los métodos anteriores no resuelven el problema:

1. **Reinicie el dispositivo**: Apague el dispositivo por completo y vuelva a encenderlo.
2. **Pruebe otro navegador estándar**: Intente de nuevo en otro navegador estándar como Chrome o Safari.
3. **Contacte a soporte**: Si el problema persiste, contacte a soporte al cliente.

<Note>
  Para el rango de dispositivos/navegadores verificados, consulte [Navegadores y Dispositivos Recomendados](/es/idcheck/getting-started/recommended-browsers-and-devices). Los dispositivos con **Android inferior a 9** no son compatibles.
</Note>
