Added the translated Brazilian Portuguese FAQ
Bruno M
parent
bd1dcfa8ae
commit
86a48eb21d
313
FAQ.pt-br.md
Normal file
313
FAQ.pt-br.md
Normal file
@ -0,0 +1,313 @@
|
||||
_Apenas o [FAQ] original é garantido estar atualizado._
|
||||
|
||||
[FAQ]: https://github.com/Genymobile/scrcpy/blob/master/FAQ.md
|
||||
|
||||
# Perguntas Frequentes
|
||||
|
||||
Aqui ficam os problemas mais comuns reportados e seus estados.
|
||||
|
||||
Se você encontrar algum erro, o primeiro passo é atualizar para a última versão.
|
||||
|
||||
## Problemas com `adb`
|
||||
|
||||
`scrcpy` executa comandos `adb` para iniciar a conexão com o dispositivo.
|
||||
Se o `adb` falhar, então scrpcpy não irá funcionar.
|
||||
|
||||
Isso normalmente não é um bug no _scrcpy_, mas um problema em seu ambiente.
|
||||
|
||||
### `adb` não encontrado
|
||||
|
||||
Você precisa do `adb` acessível de seu `PATH`.
|
||||
|
||||
No Windows, o diretório atual está em seu `PATH`, e `adb.exe` está
|
||||
incluso no release, então deve funcionar sem esforço.
|
||||
|
||||
### Dispositivo não detectado
|
||||
|
||||
> ERRO: Não foi possível encontrar nenhum dispositivo ADB
|
||||
|
||||
Certifique-se que você habilitou corretamente a [Depuração USB][enable-adb].
|
||||
|
||||
Seu dispositivo deve ser detectado por `adb`:
|
||||
|
||||
```
|
||||
adb devices
|
||||
```
|
||||
|
||||
Se seu dispositivo não foi detectado, você pode precisar de alguns [drivers] (on Windows). Há um [Driver USB para dispositivos Google] [google-usb-driver].
|
||||
|
||||
[enable-adb]: https://developer.android.com/studio/command-line/adb.html#Enabling
|
||||
[drivers]: https://developer.android.com/studio/run/oem-usb.html
|
||||
[google-usb-driver]: https://developer.android.com/studio/run/win-usb
|
||||
|
||||
|
||||
### Dispositivo não autorizado
|
||||
|
||||
> ERRO: Dispositivo não autorizado:
|
||||
> ERROR: --> (usb) 0123456789abcdef não autorizado
|
||||
> ERROR: Um popup deve abrir no dispositivo para pedir a autorização.
|
||||
|
||||
Quando estiver conectando, um popup deve abrir no dispositivo. Você deve autorizar a depuração USB.
|
||||
|
||||
Se não abrir, verifique [stackoverflow][device-unauthorized]
|
||||
|
||||
[device-unauthorized]: https://stackoverflow.com/questions/23081263/adb-android-device-unauthorized
|
||||
|
||||
|
||||
### Diversos dispositivos conectados
|
||||
|
||||
Se houver diversos dispositivos conectados, você vai receber esse erro:
|
||||
|
||||
ERRO: Múltiplos (2) dispositivos ADB:
|
||||
ERRO: --> (usb) 0123456789abcdef dispositivo Nexus_5
|
||||
ERRO: --> (tcpip) 192.168.1.5:5555 dispositivo GM1913
|
||||
ERRO: Selecione um dispositivo via -s (--serial), -d (--select-usb) ou -e (--select-tcpip)
|
||||
|
||||
Neste caso, você pode tanto fornecer o identificador do dispositivo que quer espelhar:
|
||||
|
||||
```bash
|
||||
scrcpy -s 0123456789abcdef
|
||||
```
|
||||
|
||||
Ou solicitar o único dispositivo USB (ou TCP/IP):
|
||||
|
||||
```bash
|
||||
scrcpy -d # dispositivo USB
|
||||
scrcpy -e # dispositivo TCP/IP
|
||||
```
|
||||
|
||||
Note que se seu dispositivo estiver conectado por TCP/IP, você pode receber essa mensagem:
|
||||
|
||||
> adb: erro: mais de um dispositivo/emulador
|
||||
> ERRO: "adb reverse" retornou com valor 1
|
||||
> AVISO: 'adb reverse' falhou, voltando para 'adb forward'
|
||||
|
||||
Isso é esperado (devido a um bug em versões antigas do Android, veja [#5]), mas nesse caso,
|
||||
scrcpy tenta um método diferente, que deve funcionar.
|
||||
|
||||
[#5]: https://github.com/Genymobile/scrcpy/issues/5
|
||||
|
||||
|
||||
### Conflitos entre versões do adb
|
||||
|
||||
> versão do servidor adb (41) é diferente do cliente (39); finalizando...
|
||||
|
||||
Esse erro ocorre quando você usa diversas versões do `adb` simultaneamente.
|
||||
Você deve encontrar o programa que está utilizando uma versão diferente do `adb`, e utilizar a mesma para tudo.
|
||||
|
||||
Você pode subscrever o binário do `adb` no outro programa, ou informar ao _scrcpy_ para utilizar um binário específico do `adb`, ao configurar a variável do ambiente:
|
||||
|
||||
```bash
|
||||
# no bash
|
||||
export ADB=/caminho/para/o/adb
|
||||
scrcpy
|
||||
```
|
||||
|
||||
```cmd
|
||||
:: no cmd
|
||||
set ADB=C:\caminho\para\o\adb.exe
|
||||
scrcpy
|
||||
```
|
||||
|
||||
```powershell
|
||||
# no PowerShell
|
||||
$env:ADB = 'C:\caminho\para\o\adb.exe'
|
||||
scrcpy
|
||||
```
|
||||
|
||||
|
||||
### Dispositivo desconectado
|
||||
|
||||
Se o _scrcpy_ parar com um aviso "Dispositivo desconectado", então a conexão com o `adb` foi finalizada.
|
||||
|
||||
Tente outro cabo USB ou conecte em outra porta USB. Veja [#281] e
|
||||
[#283].
|
||||
|
||||
[#281]: https://github.com/Genymobile/scrcpy/issues/281
|
||||
[#283]: https://github.com/Genymobile/scrcpy/issues/283
|
||||
|
||||
|
||||
|
||||
## Problema com os controles
|
||||
|
||||
### Mouse e teclado não funcionam
|
||||
|
||||
Em alguns dispositivos, você pode precisar habilitar uma opção para permitir [simular entradas][simulating_input].
|
||||
Nas opções de desenvolvedor, habilite:
|
||||
|
||||
> **Depuração USB (Config. de segurança)**
|
||||
> _Conceder permissões de acesso e simulação de entrada via depuração USB_
|
||||
|
||||
[simulating_input]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323
|
||||
|
||||
|
||||
### Caracteres especiais não funcionam
|
||||
|
||||
O método padrão de injeção de texto é [limitado a caracteres ASCII][text-input].
|
||||
Um truque permite injetar alguns [caracteres acentuados][accented-characters],
|
||||
mas isso é tudo. Veja [#37].
|
||||
|
||||
Desde scrcpy v1.20 no Linux, é possível simular um [teclado
|
||||
físico][hid] (HID).
|
||||
|
||||
[text-input]: https://github.com/Genymobile/scrcpy/issues?q=is%3Aopen+is%3Aissue+label%3Aunicode
|
||||
[accented-characters]: https://blog.rom1v.com/2018/03/introducing-scrcpy/#handle-accented-characters
|
||||
[#37]: https://github.com/Genymobile/scrcpy/issues/37
|
||||
[hid]: README.md#physical-keyboard-simulation-hid
|
||||
|
||||
|
||||
## Problemas no cliente
|
||||
|
||||
### Está com baixa qualidade
|
||||
|
||||
Se a definição da janela do seu cliente é menor que a tela de seu dispositivo,
|
||||
então você pode ter baixa qualidade, especialmente visível em texto (veja [#40]).
|
||||
|
||||
[#40]: https://github.com/Genymobile/scrcpy/issues/40
|
||||
|
||||
Esse problema deve ser resolvido no scrcpy v1.22: **atualize para a última versão**.
|
||||
|
||||
Em versões anteriores, você deve configurar o [comportamento de escala]:
|
||||
|
||||
> `scrcpy.exe` > Propriedades > Compatibilidade > Alterar configurações de DPI alto >
|
||||
> Substituir o ajuste de DPI > Ajuste executado por: _Aplicativo_.
|
||||
|
||||
[scaling behavior]: https://github.com/Genymobile/scrcpy/issues/40#issuecomment-424466723
|
||||
|
||||
Também, para melhorar a qualidade do downscaling, o filtro trilinear é habilitado
|
||||
automaticamente se o renderizador for OpenGL e se ele suporta mipmapping.
|
||||
|
||||
No Windows, você pode querer forçar o OpenGL a habilitar mipmapping:
|
||||
|
||||
```
|
||||
scrcpy --render-driver=opengl
|
||||
```
|
||||
|
||||
|
||||
### Problemas com Wayland
|
||||
|
||||
Por padrão, o SDL utiliza x11 no Linux. O [driver de vídeo][video-driver] pode ser alterado pela
|
||||
variável de ambiente `SDL_VIDEODRIVER`:
|
||||
|
||||
[video-driver]: https://wiki.libsdl.org/FAQUsingSDL#how_do_i_choose_a_specific_video_driver
|
||||
|
||||
```bash
|
||||
export SDL_VIDEODRIVER=wayland
|
||||
scrcpy
|
||||
```
|
||||
|
||||
Em algumas distribuições (pelo menos em Fedora), o pacote `libdecor` precisa ser
|
||||
instalado manualmente.
|
||||
|
||||
Veja os problemas [#2554] e [#2559].
|
||||
|
||||
[#2554]: https://github.com/Genymobile/scrcpy/issues/2554
|
||||
[#2559]: https://github.com/Genymobile/scrcpy/issues/2559
|
||||
|
||||
|
||||
### Compositor KWin crashando
|
||||
|
||||
No Plasma Desktop, o compositor é desabilitado enquanto _scrcpy_ estiver rodando.
|
||||
|
||||
Como gambiarra, [desabilite "Composição de blocos"][kwin].
|
||||
|
||||
[kwin]: https://github.com/Genymobile/scrcpy/issues/114#issuecomment-378778613
|
||||
|
||||
|
||||
## Crash
|
||||
|
||||
### Exceção
|
||||
|
||||
Pode haver diversas razões. A causa mais comum é de que o codificador de hardware
|
||||
de seu dispositivo não está conseguindo codificar dada a seguinte definição:
|
||||
|
||||
> ```
|
||||
> ERROR: Exception on thread Thread[main,5,main]
|
||||
> android.media.MediaCodec$CodecException: Error 0xfffffc0e
|
||||
> ...
|
||||
> Exit due to uncaughtException in main thread:
|
||||
> ERROR: Could not open video stream
|
||||
> INFO: Initial texture: 1080x2336
|
||||
> ```
|
||||
|
||||
ou
|
||||
|
||||
> ```
|
||||
> ERROR: Exception on thread Thread[main,5,main]
|
||||
> java.lang.IllegalStateException
|
||||
> at android.media.MediaCodec.native_dequeueOutputBuffer(Native Method)
|
||||
> ```
|
||||
|
||||
Tente com uma definição menor:
|
||||
|
||||
```
|
||||
scrcpy -m 1920
|
||||
scrcpy -m 1024
|
||||
scrcpy -m 800
|
||||
```
|
||||
|
||||
Desde o scrcpy v1.22, o scrcpy automaticamente tenta com uma menor definição
|
||||
antes de falhar. Esse comportamento pode ser desabilitado com `--no-downsize-on-error`.
|
||||
|
||||
Você também pode tentar outro [codificador](README.md#encoder).
|
||||
|
||||
Se você encontrar essa exceção no Android 12, apenas atualize para o scrcpy >= 1.18 (veja [#2129]):
|
||||
|
||||
```
|
||||
> ERROR: Exception on thread Thread[main,5,main]
|
||||
java.lang.AssertionError: java.lang.reflect.InvocationTargetException
|
||||
at com.genymobile.scrcpy.wrappers.SurfaceControl.setDisplaySurface(SurfaceControl.java:75)
|
||||
...
|
||||
Caused by: java.lang.reflect.InvocationTargetException
|
||||
at java.lang.reflect.Method.invoke(Native Method)
|
||||
at com.genymobile.scrcpy.wrappers.SurfaceControl.setDisplaySurface(SurfaceControl.java:73)
|
||||
... 7 more
|
||||
Caused by: java.lang.IllegalArgumentException: displayToken must not be null
|
||||
at android.view.SurfaceControl$Transaction.setDisplaySurface(SurfaceControl.java:3067)
|
||||
at android.view.SurfaceControl.setDisplaySurface(SurfaceControl.java:2147)
|
||||
... 9 more
|
||||
```
|
||||
|
||||
[#2129]: https://github.com/Genymobile/scrcpy/issues/2129
|
||||
|
||||
|
||||
## Linha de comando no Windows
|
||||
|
||||
Desde a v1.22, um "atalho" foi adicionado para abrir um terminal diretamente
|
||||
no diretório de seu scrcpy. Dê um duplo clique em `open_a_terminal_here.bat`, então digite seu
|
||||
comando. Por exemplo:
|
||||
|
||||
```
|
||||
scrcpy --record file.mkv
|
||||
```
|
||||
|
||||
Você também pode abrir o terminal e ir para a pasta do scrpcpy manualmente:
|
||||
|
||||
1. Pressione <kbd>Windows</kbd>+<kbd>r</kbd>, isso abre a caixa de diálogo.
|
||||
2. Digite `cmd` e pressione <kbd>Enter</kbd>, isso abre um terminal.
|
||||
3. Vá para o diretório do _scrcpy_, digitando (altere o caminho):
|
||||
|
||||
```bat
|
||||
cd C:\Users\user\Downloads\scrcpy-win64-xxx
|
||||
```
|
||||
|
||||
e pressione <kbd>Enter</kbd>
|
||||
4. Digite seu comando. Por exemplo:
|
||||
|
||||
```bat
|
||||
scrcpy --record file.mkv
|
||||
```
|
||||
|
||||
Se você planeja utilizar sempre os mesmos argumentos, crie um arquivo `myscrcpy.bat`
|
||||
(habilite [Extensões de nome de arquivos][show-file-extensions] para evitar confusão) no diretório do `scrcpy`, contendo seu comando. Por exemplo:
|
||||
|
||||
```bat
|
||||
scrcpy --prefer-text --turn-screen-off --stay-awake
|
||||
```
|
||||
|
||||
E então dê um duplo clique no arquivo.
|
||||
|
||||
Você também pode editar (a cópia de) `scrcpy-console.bat` ou `scrcpy-noconsole.vbs`
|
||||
para adicionar alguns argumentos.
|
||||
|
||||
[show-file-extensions]: https://www.howtogeek.com/205086/beginner-how-to-make-windows-show-file-extensions/
|
||||
Loading…
x
Reference in New Issue
Block a user