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

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

<para
>There are several ways to get help with &kplayer;. If you want to ask a question, go to the <ulink url="irc://irc.freenode.net/#kplayer"
>#kplayer channel</ulink
> on FreeNode <acronym
>IRC</acronym
> or post it on the <ulink url="http://sourceforge.net/forum/forum.php?forum_id=244388"
>user forum</ulink
> where other users will be able to see it, as well as the developer who is of course subscribed to receive e-mail when a message is posted there. The <acronym
>IRC</acronym
> channel and the user forum are also good places to get help with a problem.</para>

<para
>Bugs should be reported through the <ulink url="http://sourceforge.net/tracker/?atid=532182&amp;group_id=71710"
>bug tracking system</ulink
>, following the instructions in the <link linkend="howto-bug-reporting"
>Bug reporting micro-HOWTO</link
>. Also there are special sections at the <ulink url="http://sourceforge.net/projects/kplayer/"
>&kplayer; project</ulink
> on SourceForge for <ulink url="http://sourceforge.net/tracker/?atid=532183&amp;group_id=71710"
>support requests</ulink
>, <ulink url="http://sourceforge.net/tracker/?atid=532185&amp;group_id=71710"
>feature requests</ulink
> and <ulink url="http://sourceforge.net/tracker/?group_id=71710&amp;atid=532184"
>code patches</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
>The <filename
>kplayerui.rc</filename
> file was misplaced during installation, and &kplayer; cannot find it. If you installed using a binary package, complain to the package maintainer. When compiling from source, be sure to follow the instructions in the <link linkend="howto-compilation"
>Compilation micro-HOWTO</link
>, especially the part about <command
>kde-config</command
>. Before starting, run</para>

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

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

</sect3>

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

<para
>Você poderá ter um ficheiro 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
>The <filename
>kplayer.desktop</filename
> file needs to be installed in the correct place, under either <filename
>share/applnk/Multimedia</filename
> or <filename
>share/applications/kde</filename
> in the global &kde; directory.</para>

<para
>There also may be a file called <filename
>kde-kplayer.desktop</filename
> in <filename
>~/.local/share/applications</filename
>. Removing it will get the <guisubmenu
>Multimedia</guisubmenu
> menu updated automatically again when you install or uninstall &kplayer;, but it will also reset changes you made to &kplayer; associations with media types on the <guilabel
>File Associations</guilabel
> page in &konqueror; configuration dialog or in &kcontrolcenter;.</para>

<para
>A página de <guilabel
>Conteúdo</guilabel
> do &khelpcenter; deverá também listar o &kplayer; na secçã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 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 <command
>mplayer</command
> ou se não estiver na PATH actual. 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 ficheiros de inclusão do X)</title>

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

<para
>De forma semelhante, se o <command
>configure</command
> se queixar que faltam os ficheiros do Qt, é necessário encontrar e instalar o pacote de desenvolvimento do Qt. Se procurar no ficheiro <filename
>config.log</filename
>, ele irá provavelmente indicar-lhe o nome exacto do ficheiro que não consegue encontrar, algures perto do fim do ficheiro. O ficheiro <filename
>config.log</filename
> é bastante descritivo, por isso poderá ter de 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 nenhuns ficheiros</title>

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

<para
>Tente ler os ficheiros com o <command
>mplayer</command
> 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 <link linkend="settings"
>Configuração do &kplayer;</link
>. As mais importantes são as do <guilabel
>Controlador</guilabel
> na secçã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 comandos adicionais</guilabel
>.</para>

</sect3>

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

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

<para
>Tente ler o ficheiro com o <command
>mplayer</command
> 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 <link linkend="properties"
>Propriedades do Ficheiro</link
>. Duas opções que poderão ajudar o &mplayer; quando não consegue detectar o tipo de ficheiro automaticamente são a <option
>-vc</option
> e a <option
>-ac</option
>, que correspondem ao <guilabel
>Codificador</guilabel
> na secção das páginas de <link linkend="properties-video"
>Vídeo</link
> e <link linkend="settings-audio"
>Áudio</link
> das <guilabel
>Propriedades do Ficheiro</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 comandos adicionais</guilabel
>.</para>

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

</sect3>

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

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

</sect3>

<sect3>
<title
>Video plays fine, but there is no sound</title>

<para
>Look in the <link linkend="parts-message-log"
>Message Log</link
> to see why &mplayer; cannot play audio. The most common problem is the audio device being locked by another program. In this case the chief suspect is <command
>artsd</command
>. Try running</para>

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

<para
>from the command line. If that helps then the permanent solution is to go to the &kcontrolcenter; and disable &arts;. &arts; and everything based on it is by far the worst part of &kde;. Fortunately it seems there are plans to finally get rid of it in &kde; 4.</para>

<para
>For more information on audio setup in &kplayer; see the <link linkend="howto-configuration-audio"
>Configuration micro-HOWTO</link
>.</para>

</sect3>

<sect3>
<title
>O &kplayer; não consegue reproduzir um ficheiro 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 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 <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 ficheiro, vá às <link linkend="properties"
>Propriedades do Ficheiro</link
>.</para>

</sect3>

<sect3>
<title
>Problemas ao voltar do modo de ecrã completo</title>

<para
>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 <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 utilizadores do &kplayer;</ulink
> e procure por actualizações.</para>

</sect3>

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

<para
>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 <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 Ficheiro</link
>. Indique o tamanho de 'cache' mínimo no campo de <guilabel
>Parâmetros adicionais da linha de comandos</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 ficheiros de vídeo grandes levam demasiado tempo a começar a reproduzir</title>

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

</sect3>

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

<para
>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 <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 ficheiro ou <acronym
>URL</acronym
>.</para>

</sect3>

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

<para
>Terá de activar a <link linkend="howto-installation-xvideo"
>extensão XVideo</link
> na sua configuração do X11 e certificar-se que a saída de vídeo XVideo está seleccionada 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á à mesma ter os controlos de vídeo a funcionar se passar a opção <literal
>-vf eq2</literal
> ou <literal
>-vf eq</literal
> no campo de <guilabel
>Parâmetros adicionais da linha de comandos</guilabel
> da <link linkend="properties-advanced"
>página Avançado</link
> da <guilabel
>Configuração do &kplayer;</guilabel
>.</para>

</sect3>

</sect2>

</sect1>
