# Resolução de Problemas

## Obter suporte

Existem várias formas de obter ajuda com o &kplayer;. Se quiser fazer uma pergunta, vá ao canal #kplayer no IRC da FreeNode ou coloque-a no fórum de usuários é o melhor local para a publicar, uma vez que outros usuários conseguirão vê-la, assim como o programador que está, obviamente, subscrito para receber e-mail sempre que uma mensagem é aí publicada. O canal de IRC e o fórum de usuários é também um bom local para publicar um problema que você não tenha de fato certeza se é um erro.

Os erros deverão ser relatados através do sistema de registro de erros, seguindo as instruções no micro-HOWTO de relato de erros. Existem também seções especiais no projeto &kplayer; no SourceForge para pedidos de suporte, pedidos de funcionalidades e correções de código.

## Problemas comuns

### A maior parte dos comandos do menu e barra de ferramentas não estão visíveis

O arquivo `kplayerui.rc` foi colocado no local errado durante a instalação, e o &kplayer; não o consegue encontrar. Se o instalou através de um pacote binário, queixe-se ao responsável pela manutenção do pacote. Ao compilar a partir do código-fonte, certifique-se de que segue as instruções no micro-HOWTO de compilação, especialmente a parte sobre o `kde-config`. Antes de começar, execute

``kde-config` `--prefix``

na linha de comando para garantir que ele retorna o local de base do &kde;.

### Após uma atualização do &kplayer; faltam algumas funcionalidades novas

Você poderá ter um arquivo chamado `kplayerui.rc` no `~/.kde/share/apps/kplayer`. Se o remover poderá obter os menus novos, mas irá também remover os atalhos de teclado que possa ter alterado na janela de Atalhos de Teclado.

### O &kplayer; não aparece no submenu Multimídia do &kmenu;

O arquivo `kplayer.desktop` necessita ser instalado no local correto, tanto sob a pata `share/applnk/Multimedia` ou `share/applications/kde` da pasta global do &kde;.

Poderá também existir um arquivo chamado `kde-kplayer.desktop` em `~/.local/share/applications`. Se o remover irá atualizar automaticamente o menu Multimídia, quando instalar ou desinstalar o &kplayer;, mas irá também inicializar as alterações que tenha feito às associações do &kplayer; aos tipos multimídia na página de Associações de Arquivos na janela de configuração do &konqueror; ou no &kcontrolcenter;.

A página de Conteúdo do &khelpcenter; deverá também listar o &kplayer; na seção Multimídia dos Manuais das Aplicações.

### Não foi possível iniciar o &mplayer;

Se obtiver este erro ao tentar reproduzir um arquivo, necessitará instalar o &mplayer; antes de poder usar o &kplayer;. Este erro também poderá acontecer se o nome do seu executável do &mplayer; não for `mplayer` ou se não estiver na PATH atual. Nesse caso, vá à página Avançado da Configuração do &kplayer; e indique o nome ou a localização completa do executável no campo Localização do executável.

### 'configure: error: Can't find X includes' (erro: não é possível encontrar os arquivos de inclusão do X)

Isto significa que você não tem os arquivos de inclusão ou não estão acessíveis; eles vêm normalmente no pacote de desenvolvimento do X. Neste caso, procure por um pacote na sua distribuição que tenha arquivos como o X.h ou o XEvent.h. Por exemplo, na Debian, este chama-se `xlibs-dev`.

De forma semelhante, se o `configure` se queixar que faltam os arquivos do Qt, é necessário encontrar e instalar o pacote de desenvolvimento do Qt. Se procurar no arquivo `config.log`, ele irá provavelmente indicar-lhe o nome exato do arquivo que não consegue encontrar, em algum lugar perto do fim do arquivo. O arquivo `config.log` é bastante descritivo, por isso poderá ter que deslocar algumas páginas até ao fim para encontrar o local em que ele indica o erro.

### Não é possível reproduzir nenhum arquivo

Procure no fim do registro de mensagens para ver que erros o &mplayer; dá ao tentar reproduzir os arquivos. Pressione &Ctrl;G se o &kplayer; não mostrar o registro automaticamente.

Tente ler os arquivos com o `mplayer` a partir da linha de comando. Se o &mplayer; conseguir reproduzi-los, compare as opções que usou na linha de comando com as que o &kplayer; passou ao &mplayer;. Defina as opções necessárias na Configuração do &kplayer;. As mais importantes são as do Controlador na seção das páginas de Vídeo e Áudio. Na página Avançado, assinale a opção da Localização do executável para garantir que o &kplayer; consiga encontrar o executável do &mplayer; e, se existirem algumas opções que não constem na janela de Configuração do &kplayer;, coloque-as no campo Argumentos da linha de comando adicionais.

### Não é possível reproduzir um arquivo específico

Procure no fim do registro de mensagens para ver que erros o &mplayer; dá ao tentar reproduzir o arquivo. Pressione &Ctrl;G se o &kplayer; não mostrar automaticamente o registro.

Tente ler o arquivo com o `mplayer` a partir da linha de comando. Se o &mplayer; conseguir reproduzi-los, mas necessitar de opções especiais para reproduzir este arquivo em particular, coloque-as nas Propriedades do Arquivo. Duas opções que poderão ajudar o &mplayer; quando não consegue detectar o tipo de arquivo automaticamente são a `-vc` e a `-ac`, que correspondem ao Codificador na seção das páginas de Vídeo e Áudio das Propriedades do arquivo. Se existirem algumas opções que não constem na janela de Propriedades do arquivo, coloque-as no campo Argumentos da linha de comando adicionais.

Se for um arquivo de lista de reprodução mas não tiver nenhuma das extensões de arquivos de listas, vá à página Geral das Propriedades do Arquivo e ative a opção de Lista de reprodução. Em alguns casos raros, um arquivo que não seja uma lista de reprodução poderá ter uma extensão equivalente. Aí, terá que desligar a opção da Lista de Reprodução. Para mais detalhes, veja a seção dos arquivos de listas de reprodução no micro-HOWTO de listas de reprodução.

### Não é possível reproduzir nenhum arquivo de vídeo

Se o &kplayer; só consegue ler arquivos de áudio mas não consegue fazer o mesmo com os arquivos de vídeo, poderá estar havendo um problema com a saída de vídeo. Por padrão, o &kplayer; usa a extensão XVideo para a saída de vídeo. Se a extensão não estiver ativada ou se estiver sendo usada por outro programa como o Kino, o &kplayer; poderá não ser capaz de usar uma saída diferente. Você tanto poderá ativar a extensão XVideo ou dizer ao &kplayer; para usar outra saída de vídeo. Veja o micro-HOWTO de configuração para mais detalhes.

### O vídeo é exibido perfeitamente mas não há som

Veja no Registro de Mensagens para descobrir porque o &mplayer; não consegue reproduzir o áudio. O problema mais comum é o dispositivo de áudio que está bloqueado por outro programa. Neste caso, o principal suspeito é o `artsd`. Tente executar

``killall` artsd`

na linha de comando. Se isso ajudar, então a solução permanente é ir ao &kcontrolcenter; e desativar o &arts;. O &arts; e tudo o que se baseia nele é de longe a pior parte do &kde;. Felizmente, parecem existir planos para finalmente abandoná-lo no &kde; 4.

Para mais informações sobre a configuração de áudio no &kplayer; veja o micro-HOWTO de configuração.

### O &kplayer; não consegue reproduzir um arquivo que é visto perfeitamente no &mplayer;

Quando o &kplayer; estiver no estado de Execução ou de Visualização, execute

``ps` `auxww``

na linha de comando. Compare as opções da linha de comando que o &kplayer; usa para executar o &mplayer; para ler o arquivo no &mplayer;. Depois comece a adicionar as opções em falta, uma a uma, até que obtenha o mesmo problema que está tendo no &kplayer;. Depois de descobrir a opção que está causando o problema, você poderá abrir a janela de configuração no &kplayer; e remover ou alterar essa opção. Se necessitar de fazer a alteração apenas para esse arquivo, vá às Propriedades do Arquivo.

### Problemas ao voltar do modo de tela cheia

Se você estiver tendo problemas ao tentar voltar ao tamanho de janela normal a partir do modo de tela cheia, como por exemplo, se a janela fica muito grande ou se está vendo muitas intermitências, poderá tentar desligar a opção Redimensionar a janela principal automaticamente na página Geral da Configuração do &kplayer;. Veja também o tópico sobre este problema no fórum de usuários do &kplayer; e procure por atualizações.

### A estação de rádio leva muito tempo para começar a tocar

Por padrão, o &kplayer; escolhe o tamanho de 'cache' ótimo. Ao tocar arquivos multimídia com taxas de 'bits' baixas, como uma estação de rádio, poderá levar bastante tempo para preenchê-la. Você poderá escolher um Tamanho de 'Cache' menor na página Avançado a nível global na Configuração do &kplayer; ou a nível individual nas Propriedades do Arquivo. Indique o tamanho de 'cache' mínimo no campo de Parâmetros adicionais da linha de comando, como por exemplo `-cache-min 5`, ou escolha definir um tamanho para a opção Cache e indique um tamanho em quilobytes. Para mais informações sobre a reprodução multimídia na Internet, veja o micro-HOWTO de transmissões.

### Os arquivos de vídeo grandes levam muito tempo para começar a reproduzir

Você poderá ter definido a opção do Tamanho da 'cache' muito baixa na Configuração do &kplayer;. Se precisa aumentar ou diminuir para um determinado arquivo ou transmissão, poderá fazê-lo na página Avançado das Propriedades do Arquivo.

### Só aparece a área de vídeo no &konqueror;

Se abrir uma página Web com um objeto multimídia incorporado no &konqueror;, só a área de vídeo é apresentada, sem controles. Recomenda-se que clique com o botão direito na área de vídeo e escolha o comando Iniciar o &kplayer;. A reprodução irá então parar e o &kplayer; completo poderá abrir e começar a tocar o arquivo ou URL.

### Os comandos de contraste e brilho não funcionam

Você terá que ativar a extensão XVideo na sua configuração do X11 e certificar-se de que a saída de vídeo XVideo está selecionada na página Vídeo da Configuração do &kplayer;. Contudo, se não puder usar a saída do XVideo, poderá ainda ter os controles de vídeo funcionando se passar a opção `-vf eq2` ou `-vf eq` no campo de Parâmetros adicionais da linha de comando da página Avançado da Configuração do &kplayer;.