====== scrcpy ======

Aplicación que permite ver y controlar un dispositivo Android.

  * [[https://github.com/Genymobile/scrcpy|Repositorio oficial]] (GitHub)
  * [[https://github.com/Genymobile/scrcpy/wiki|Wiki]]

===== Preparativos =====

En el dispositivo Android que vayamos a controlar debemos activar las **opciones de desarrollador**. Normalmente esto se consigue pulsando 7 veces sobre **Número de compilación** (dentro de Ajustes de Sistema -> //Acerca del teléfono//)

<WRAP center round important 60%>
El dispositivo Android a controlar debe ser Android 5.0 o superior.
</WRAP>


===== Instalación =====

==== Arch Linux ====

A través del paquete ''scrcpy''.


===== Uso =====

''scrcpy'' permite el control por cable o de forma inalámbrica.

==== Conexión por cable ====

Conectamos el dispositivo Android al ordenador mediante cable USB y ejecutamos en el ordenador:

<code>
scrcpy
</code>

Si todo ha ido bien, se abrirá una ventana mostrando la pantalla del dispositivo Android. Desde esa pantalla podremos interactuar como si estuviésemos en la propia pantalla del dispositivo.

==== Conexión inalámbrica ====

Esto solo es posible si está habilitado el modo TCP/IP de **adb** (herramienta en línea de comandos que permite la comunicación con dispositivos Android).

<code>
scrcpy --tcpip=<IP_DISPOSITIVO_ANDROID>:5555
</code>

Si no somos root en el dispositivo Android y queremos habilitar este modo, tenemos que conectar el dispositivo por USB y ejecutar:

<code>
scrcpy --tcpip
</code>

''scrcpy'' buscará el dispositivo y habilitará el modo TCP/IP. Desde ese momento, podremos desconectar el cable y lanzar ''scrcpy'' mediante:

<code>
scrcpy --tcpip=<IP_DISPOSITIVO_ANDROID>:5555
</code>

===== Amazon Fire TV  =====

El dispositivo Fire TV de Amazon incluye Android y permite el uso de scrcpy de **forma inalámbrica** de fábrica, pero primero hay que seguir unos pasos.

Activar las opciones de desarrollador: desde el menú vamos a **Mi Fire TV** -> **Acerca de**,  nos ponemos en la opción **Fire TV Stick**' y la pulsamos 7 veces seguidas. Habrá aparecido un elemento más en el menú anterior (**Mi Fire TV**) llamado **Opciones para desarrolladores**.

Dentro de **Opciones para desarrolladores** activamos **Depurado ADB** e **Instalar apps desconocidas**.

Desde el equipo donde tengamos ''scrcpy'', vamos a habilitar la conexión ADB:

<code>
adb connect 192.168.0.13:5555
</code>

Nos aparecerá una ventana en el Fire TV solicitando permiso para acceder desde este equipo. Una vez se lo concedamos, ya podremos usar ''scrcpy'' para ver y controlar remotamente el Fire TV:

<code>
scrcpy --tcpip=<IP_FIRE_TV>
</code>

Podemos optimizar la conexión limitando la transmisión de la imagen:

<code>
scrcpy --tcpip=<IP_FIRE_TV> -m 1024 -b 2M --max-fps 15
</code>

  * ''-m | %%--%%max-size'': reduce el tamaño /resolución de la imagen
  * ''-b | %%--%%bit-rate'': cambia el bitrate (por defecto, son 8M)
  * ''%%--%%max-fps'': limita el la tasa de fotogramas

  * [[https://developer.amazon.com/es/docs/fire-tv/connecting-adb-to-device.html|Connect to Fire TV Through ADB (Fire TV)]]

==== Copiar y pegar ====

Para copiar texto y pegarlo en el Fire TV, tenemos que iniciar ''scrcpy'' con la opción ''--legacy-paste'':

<code>
scrcpy --tcpip=<IP_FIRE_TV> --legacy-paste
</code>

Desde ese momento, lo que hubiésemos copiado en nuestro equipo, podremos pegarlo en el Fire TV con <key>C</key>+<key>%%v%%</key>

===== Recursos =====

  * [[https://blog.rom1v.com/2018/03/introducing-scrcpy/|Introducing scrcpy]]