# 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 utilizadores é o melhor local para a publicar, dado que outros utilizadores 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 utilizadores é também um bom local para publicar um problema que você não tenha de facto certeza se é um erro.

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

## Problemas comuns

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

O ficheiro `kplayerui.rc` foi colocado no sítio 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 de manutenção do pacote. Ao compilar a partir do código-fonte, certifique-se que segue as instruções no micro-HOWTO de compilação, especialmente a parte acerca do `kde-config`. Antes de começar, execute

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

na linha de comandos para garantir que devolve o local de base do &kde;.

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

Você poderá ter um ficheiro 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 ficheiro `kplayer.desktop` necessita ser instalado no local correcto, tanto sob a pata `share/applnk/Multimedia` ou `share/applications/kde` da pasta global do &kde;.

Poderá também existir um ficheiro chamado `kde-kplayer.desktop` em `~/.local/share/applications`. Se o remover irá actualizar 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 Ficheiros 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 secção Multimédia dos Manuais das Aplicações.

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

Se obtiver este erro ao tentar reproduzir um ficheiro, necessitará de 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 actual. 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 ficheiros de inclusão do X)

Isto significa que você não tem os ficheiros de inclusão ou não estão acessíveis; estes vêm normalmente no pacote de desenvolvimento do X. Neste caso, procure por um pacote na sua distribuição que tenha ficheiros 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 ficheiros do Qt, é necessário encontrar e instalar o pacote de desenvolvimento do Qt. Se procurar no ficheiro `config.log`, ele irá provavelmente indicar-lhe o nome exacto do ficheiro que não consegue encontrar, algures perto do fim do ficheiro. O ficheiro `config.log` é bastante descritivo, por isso poderá ter de deslocar algumas páginas até ao fim para encontrar o local em que ele indica o erro.

### Não é possível reproduzir nenhuns ficheiros

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

Tente ler os ficheiros com o `mplayer` a partir da linha de comandos. Se o &mplayer; conseguir reproduzi-los, compare as opções que usou na linha de comandos 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 secçã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 comandos adicionais.

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

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

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

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

### Não é possível reproduzir nenhuns ficheiros de vídeo

Se o &kplayer; só consegue ler ficheiros de áudio mas não consegue fazer o mesmo com os ficheiros de vídeo, poderá estar a haver um problema com a saída de vídeo. Por omissão, o &kplayer; usa a extensão XVideo para a saída de vídeo. Se a extensão não estiver activada ou se estiver a ser usada por outro programa como o Kino, o &kplayer; poderá não ser capaz de usar uma saída diferente. Tanto poderá activar 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 vê-se perfeitamente mas não há som

Veja no Registo 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 comandos. Se isso ajudar, então a solução permanente é ir ao &kcontrolcenter; e desactivar o &arts;. O &arts; e tudo o que se baseia nele é de longe a pior parte do &kde;. Felizmente, parecem existir planos para finalmente deixar de este existir 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 ficheiro que é visto perfeitamente no &mplayer;

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

``ps` `auxww``

na linha de comandos. Compare as opções da linha de comandos que o &kplayer; usa para executar o &mplayer; para ler o ficheiro no &mplayer;. Depois comece a adicionar as opções em falta, uma a uma, até que obtenha o mesmo problema que está a ter no &kplayer;. Depois de descobrir a opção que está a causar o problema, 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 ficheiro, vá às Propriedades do Ficheiro.

### Problemas ao voltar do modo de ecrã completo

Se estiver a ter problemas ao tentar voltar ao tamanho de janela normal a partir do modo de ecrã completo, como por exemplo, se a janela fica demasiado grande ou se está a ver demasiadas 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 utilizadores do &kplayer; e procure por actualizações.

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

Por omissão, o &kplayer; escolhe o tamanho de 'cache' óptimo. Ao tocar ficheiros multimédia com taxas de 'bits' baixas, como uma estação de rádio, poderá levar bastante tempo a enchê-la. 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 Ficheiro. Indique o tamanho de 'cache' mínimo no campo de Parâmetros adicionais da linha de comandos, 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 ficheiros de vídeo grandes levam demasiado tempo a começar a reproduzir

Poderá ter definido a opção do Tamanho da 'cache' demasiado baixo na Configuração do &kplayer;. Se precisa de o aumentar ou diminuir para um dado ficheiro ou transmissão, podê-lo-á fazer na página Avançado das Propriedades do Ficheiro.

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

Se abrir uma página Web com um objecto multimédia incorporado no &konqueror;, só a área de vídeo é apresentada, sem controlos. O mesmo acontece ao antever os ficheiros parcialmente transferidos no &kmldonkey;. Recomenda-se que carregue 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 ficheiro ou URL.

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

Terá de activar a extensão XVideo na sua configuração do X11 e certificar-se que a saída de vídeo XVideo está seleccionada na página Vídeo da Configuração do &kplayer;. Contudo, se não puder usar a saída do XVideo, poderá à mesma ter os controlos de vídeo a funcionar se passar a opção `-vf eq2` ou `-vf eq` no campo de Parâmetros adicionais da linha de comandos da página Avançado da Configuração do &kplayer;.