<sect1 id="howto-troubleshooting">
<title
>Resolução de Problemas</title>

<sect2 id="howto-troubleshooting-support">
<title
>Obter suporte</title>

<para
>Existem várias formas de obter ajuda com o &kplayer;. Se quiser fazer uma pergunta, vá ao <ulink url="irc://irc.freenode.net/#kplayer"
>canal #kplayer</ulink
> no <acronym
>IRC</acronym
> da FreeNode ou coloque-a no <ulink url="http://sourceforge.net/forum/forum.php?forum_id=244388"
>fórum de usuários</ulink
> é 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 <acronym
>IRC</acronym
> 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.</para>

<para
>Os erros deverão ser relatados através do <ulink url="http://sourceforge.net/tracker/?atid=532182&amp;group_id=71710"
>sistema de registro de erros</ulink
>, seguindo as instruções no <link linkend="howto-bug-reporting"
>micro-HOWTO de relato de erros</link
>. Existem também seções especiais no <ulink url="http://sourceforge.net/projects/kplayer/"
>projeto &kplayer;</ulink
> no SourceForge para <ulink url="http://sourceforge.net/tracker/?atid=532183&amp;group_id=71710"
>pedidos de suporte</ulink
>, <ulink url="http://sourceforge.net/tracker/?atid=532185&amp;group_id=71710"
>pedidos de funcionalidades</ulink
> e <ulink url="http://sourceforge.net/tracker/?group_id=71710&amp;atid=532184"
>correções de código</ulink
>.</para>

</sect2>

<sect2 id="howto-troubleshooting-problems">
<title
>Problemas comuns</title>

<sect3>
<title
>A maior parte dos comandos do menu e barra de ferramentas não estão visíveis</title>

<para
>O arquivo <filename
>kplayerui.rc</filename
> 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 <link linkend="howto-compilation"
>micro-HOWTO de compilação</link
>, especialmente a parte sobre o <command
>kde-config</command
>. Antes de começar, execute</para>

<para
><userinput
><command
>kde-config</command
> <option
>--prefix</option
></userinput
></para>

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

</sect3>

<sect3>
<title
>Após uma atualização do &kplayer; faltam algumas funcionalidades novas</title>

<para
>Você poderá ter um arquivo chamado <filename
>kplayerui.rc</filename
> no <filename
>~/.kde/share/apps/kplayer</filename
>. Se o remover poderá obter os menus novos, mas irá também remover os atalhos de teclado que possa ter alterado na <link linkend="configuration-shortcuts"
>janela de Atalhos de Teclado</link
>.</para>

</sect3>

<sect3>
<title
>O &kplayer; não aparece no submenu <guisubmenu
>Multimídia</guisubmenu
> do &kmenu;</title>

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

<para
>Poderá também existir um arquivo chamado <filename
>kde-kplayer.desktop</filename
> em <filename
>~/.local/share/applications</filename
>. Se o remover irá atualizar automaticamente o menu <guisubmenu
>Multimídia</guisubmenu
>, 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 <guilabel
>Associações de Arquivos</guilabel
> na janela de configuração do &konqueror; ou no  &kcontrolcenter;.</para>

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

</sect3>

<sect3>
<title
>Não foi possível iniciar o &mplayer;</title>

<para
>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 <command
>mplayer</command
> ou se não estiver na PATH atual. Nesse caso, vá à página <link linkend="settings-advanced"
>Avançado</link
> da <guilabel
>Configuração do &kplayer;</guilabel
> e indique o nome ou a localização completa do executável no campo <guilabel
>Localização do executável</guilabel
>.</para>

</sect3>

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

<para
>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 <literal
>xlibs-dev</literal
>.</para>

<para
>De forma semelhante, se o <command
>configure</command
> se queixar que faltam os arquivos do Qt, é necessário encontrar e instalar o pacote de desenvolvimento do Qt. Se procurar no arquivo <filename
>config.log</filename
>, 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 <filename
>config.log</filename
> é bastante descritivo, por isso poderá ter que deslocar algumas páginas até ao fim para encontrar o local em que ele indica o erro.</para>

</sect3>

<sect3>
<title
>Não é possível reproduzir nenhum arquivo</title>

<para
>Procure no fim do registro de mensagens para ver que erros o &mplayer; dá ao tentar reproduzir os arquivos. Pressione <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> se o &kplayer; não mostrar o registro automaticamente.</para>

<para
>Tente ler os arquivos com o <command
>mplayer</command
> 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 <link linkend="settings"
>Configuração do &kplayer;</link
>. As mais importantes são as do <guilabel
>Controlador</guilabel
> na seção das páginas de <link linkend="settings-video"
>Vídeo</link
> e <link linkend="settings-audio"
>Áudio</link
>. Na <link linkend="settings-advanced"
>página Avançado</link
>, assinale a opção da <guilabel
>Localização do executável</guilabel
> 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 <guilabel
>Configuração do &kplayer;</guilabel
>, coloque-as no campo <guilabel
>Argumentos da linha de comando adicionais</guilabel
>.</para>

</sect3>

<sect3>
<title
>Não é possível reproduzir um arquivo específico</title>

<para
>Procure no fim do registro de mensagens para ver que erros o &mplayer; dá ao tentar reproduzir o arquivo. Pressione <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> se o &kplayer; não mostrar automaticamente o registro.</para>

<para
>Tente ler o arquivo com o <command
>mplayer</command
> 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 <link linkend="properties"
>Propriedades do Arquivo</link
>. Duas opções que poderão ajudar o &mplayer; quando não consegue detectar o tipo de arquivo automaticamente são a <option
>-vc</option
> e a <option
>-ac</option
>, que correspondem ao <guilabel
>Codificador</guilabel
> na seção das páginas de <link linkend="properties-video"
>Vídeo</link
> e <link linkend="settings-audio"
>Áudio</link
> das <guilabel
>Propriedades do Arquivo</guilabel
>. Se existirem algumas opções que não constem na janela de <guilabel
>Configuração do &kplayer;</guilabel
>, coloque-as no campo <guilabel
>Argumentos da linha de comando adicionais</guilabel
>.</para>

<para
>Se for um arquivo de lista de reprodução mas não tiver nenhuma das extensões de arquivos de listas, vá à <link linkend="properties-general"
>página Geral</link
> das <guilabel
>Propriedades do Arquivo</guilabel
> e ative a opção de <guilabel
>Lista de reprodução</guilabel
>. 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 <guilabel
>Lista de Reprodução</guilabel
>. Para mais detalhes, veja a seção dos <link linkend="howto-playlist-files"
>arquivos de listas de reprodução</link
> no micro-HOWTO de listas de reprodução.</para>

</sect3>

<sect3>
<title
>Não é possível reproduzir nenhum arquivo de vídeo</title>

<para
>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 <link linkend="howto-installation-xvideo"
>extensão XVideo</link
> 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 <application
>Kino</application
>, 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 <link linkend="howto-configuration"
>micro-HOWTO de configuração</link
> para mais detalhes.</para>

</sect3>

<sect3>
<title
>O vídeo é exibido perfeitamente mas não há som</title>

<para
>Veja no <link linkend="parts-message-log"
>Registro de Mensagens</link
> 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 <command
>artsd</command
>. Tente executar</para>

<para
><userinput
><command
>killall</command
> artsd</userinput
></para>

<para
>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>

<para
>Para mais informações sobre a configuração de áudio no &kplayer; veja o <link linkend="howto-configuration-audio"
>micro-HOWTO de configuração</link
>.</para>

</sect3>

<sect3>
<title
>O &kplayer; não consegue reproduzir um arquivo que é visto perfeitamente no &mplayer;</title>

<para
>Quando o &kplayer; estiver no estado de <guilabel
>Execução</guilabel
> ou de <guilabel
>Visualização</guilabel
>, execute</para>

<para
><userinput
><command
>ps</command
> <option
>auxww</option
></userinput
></para>

<para
>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 <link linkend="settings"
>janela de configuração</link
> no &kplayer; e remover ou alterar essa opção. Se necessitar de fazer a alteração apenas para esse arquivo, vá às <link linkend="properties"
>Propriedades do Arquivo</link
>.</para>

</sect3>

<sect3>
<title
>Problemas ao voltar do modo de tela cheia</title>

<para
>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 <guilabel
>Redimensionar a janela principal automaticamente</guilabel
> na <link linkend="settings-general"
>página Geral</link
> da <guilabel
>Configuração do &kplayer;</guilabel
>. Veja também o tópico sobre este problema no <ulink url="http://sourceforge.net/forum/forum.php?thread_id=1122221&amp;forum_id=244388"
>fórum de usuários do &kplayer;</ulink
> e procure por atualizações.</para>

</sect3>

<sect3>
<title
>A estação de rádio leva muito tempo para começar a tocar</title>

<para
>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 <guilabel
>Tamanho de 'Cache'</guilabel
> menor na página <guilabel
>Avançado</guilabel
> a nível global na <link linkend="settings-advanced"
>Configuração do &kplayer;</link
> ou a nível individual nas <link linkend="properties-advanced"
>Propriedades do Arquivo</link
>. Indique o tamanho de 'cache' mínimo no campo de <guilabel
>Parâmetros adicionais da linha de comando</guilabel
>, como por exemplo <literal
>-cache-min 5</literal
>, ou escolha <guilabel
>definir um tamanho</guilabel
> para a opção <guilabel
>Cache</guilabel
> e indique um tamanho em quilobytes. Para mais informações sobre a reprodução multimídia na Internet, veja o <link linkend="howto-streams"
>micro-HOWTO de transmissões</link
>.</para>

</sect3>

<sect3>
<title
>Os arquivos de vídeo grandes levam muito tempo para começar a reproduzir</title>

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

</sect3>

<sect3>
<title
>Só aparece a área de vídeo no &konqueror;</title>

<para
>Se abrir uma página Web com um objeto multimídia incorporado no &konqueror;, só a área de vídeo é apresentada, sem controles. O mesmo acontece ao antever os arquivos parcialmente transferidos no &kmldonkey;. Recomenda-se que clique com o botão <mousebutton
>direito</mousebutton
> na <link linkend="parts-video-area"
>área de vídeo</link
> e escolha o comando <guimenuitem
>Iniciar o &kplayer;</guimenuitem
>. A reprodução irá então parar e o &kplayer; completo poderá abrir e começar a tocar o arquivo ou <acronym
>URL</acronym
>.</para>

</sect3>

<sect3>
<title
>Os comandos de contraste e brilho não funcionam</title>

<para
>Você terá que ativar a <link linkend="howto-installation-xvideo"
>extensão XVideo</link
> na sua configuração do X11 e certificar-se de que a saída de vídeo XVideo está selecionada na página <link linkend="settings-advanced"
><guilabel
>Vídeo</guilabel
></link
> da <guilabel
>Configuração do &kplayer;</guilabel
>. 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 <literal
>-vf eq2</literal
> ou <literal
>-vf eq</literal
> no campo de <guilabel
>Parâmetros adicionais da linha de comando</guilabel
> da <link linkend="properties-advanced"
>página Avançado</link
> da <guilabel
>Configuração do &kplayer;</guilabel
>.</para>

</sect3>

</sect2>

</sect1>
