<sect1 id="howto-troubleshooting">
<title
>Resolución de problemas</title>

<sect2 id="howto-troubleshooting-support">
<title
>Obtener soporte</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 comunes</title>

<sect3>
<title
>Faltan la mayor parte de las órdenes de menú y de la barra de herramientas</title>

<para
>El archivo <filename
>kplayerui.rc</filename
> se colocó mal durante la instalación, y &kplayer; no puede encontrarlo. Si lo ha instalado utilizando un paquete binario, pregunte al responsable de mantener el paquete. Cuando se compila desde las fuentes, asegúrese de seguir las instrucciones del <link linkend="howto-compilation"
>micro CÓMO sobre compilación</link
>, especialmente la parte sobre <command
>kde-config</command
>. Antes de comenzar, ejecute</para>

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

<para
>desde la línea de órdenes para asegurarse que devuelve el prefijo de la ruta de &kde;.</para>

</sect3>

<sect3>
<title
>Después de aumentar la versión de &kplayer; faltan características nuevas</title>

<para
>Existe un archivo llamado <filename
>kplayerui.rc</filename
> en <filename
>~/.kde/share/apps/kplayer</filename
>. Eliminándolo obtendrá los menús nuevos, pero también reiniciará cualquier acceso rápido de teclado que haya cambiado en el diálogo de <link linkend="configuration-shortcuts"
>asociación de teclas</link
>.</para>

</sect3>

<sect3>
<title
>&kplayer; no se muestra en el submenú <guisubmenu
>Multimedia</guisubmenu
> del &kmenu;.</title>

<para
>Se necesita instalar el archivo <filename
>kplayer.desktop</filename
> en el lugar correcto, en <filename
>share/applnk/Multimedia</filename
> o <filename
>share/applications/kde</filename
> en el directorio global de &kde;.</para>

<para
>También puede existir un archivo llamado <filename
>kde-player.desktop</filename
> en <filename
>~/.local/share/applications</filename
>. Elíminelo y el menú <guisubmenu
>Multimedia</guisubmenu
> se actualizará automáticamente cuando vuelva a instalar o desinstalar &kplayer;, pero reiniciará los cambios que haya hecho a &kplayer; en la página <guilabel
>Asociaciones de archivos</guilabel
> en el diálogo de configuración de &konqueror; o en &kcontrolcenter;.</para>

<para
>La pestaña <guilabel
>Contenidos</guilabel
> en &khelpcenter; debería listarse también en &kplayer; dentro de la sección <guilabel
>Multimedia</guilabel
> en <guilabel
>Manuales de aplicación</guilabel
>.</para>

</sect3>

<sect3>
<title
>No se pudo iniciar &mplayer;</title>

<para
>Si obtiene este error cuando intenta reproducir un archivo, necesitará instalar &mplayer; antes de utilizar &kplayer;. Este error también puede producirse si el nombre de su ejecutable &mplayer; no es <command
>mplayer</command
> o no está en la ruta actual. En este caso vaya a la página <link linkend="settings-advanced"
>Avanzadas</link
> en <guilabel
>Configurar &kplayer;</guilabel
> e introducir el nombre del ejecutable o la ruta completa en el campo <guilabel
>Ruta del ejecutable</guilabel
>.</para>

</sect3>

<sect3>
<title
>configure: error: Can't find X includes (configure: error: No se pudieron encontrar los archivos incluídos de X)</title>

<para
>Esto significa que faltan archivos incluídos de X, que normalmente se incluyen con el paquete de desarrollo de X. Por tanto, busque un paquete en su distribución que tenga archivos como X.h y XEvent.h. Por ejemplo, en Debian se llaman <literal
>xlibs-dev</literal
>.</para>

<para
>De forma similar, si <command
>configure</command
> se queja de que faltan archivos Qt, necesita encontrar e instalar el paquete de desarrollo de Qt. Si busca en el <filename
>config.log</filename
>, probablemente le indicará el nombre exacto del archivo que no pudo encontrar, generalmente cerca del final. El archivo <filename
>config.log</filename
> es muy completo, por tanto pueden desplazarse unas páginas hacia arriba para desde el final del archivo para situarse sobre el informe del error.</para>

</sect3>

<sect3>
<title
>No puede reproducir ningún archivo</title>

<para
>Look at the end of the message log to see what errors &mplayer; gives when trying to play the files. Hit <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> if &kplayer; does not show the log automatically.</para>

<para
>Pruebe a reproducir los archivos con <command
>mplayer</command
> desde la línea de órdenes. Si &mplayer; puede reproducirlo, compare las opciones usadas en la línea de órdenes para que &kplayer; pueda pasárselas a &mplayer;. Establezca las opciones requeridas en <link linkend="settings"
>Configurar &kplayer;</link
>. Lo más importante son las opciones del <guilabel
>Controlador</guilabel
> en las páginas <link linkend="settings-video"
>Vídeo</link
> y <link linkend="settings-audio"
>Audio</link
>. En la <link linkend="settings-advanced"
>página Avanzadas</link
> compruebe la opción <guilabel
>Ruta de ejecutable</guilabel
> para asegurar de que &kplayer; sea capaz de encontrar el ejecutable &mplayer;, y si existen opciones que no se encuentren en el diálogo <guilabel
>Configurar &kplayer;</guilabel
>, colóquelas en el campo <guilabel
>Parámetros adicionales de línes de comandos</guilabel
>.</para>

</sect3>

<sect3>
<title
>No se puede reproducir un archivo específico</title>

<para
>Look at the end of the message log to see what errors &mplayer; gives when trying to play the file. Hit <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> if &kplayer; does not show the log automatically.</para>

<para
>Pruebe a reproducir el archivo con <command
>mplayer</command
> desde la línea de órdenes. Si &mplayer; puede reproducirlo, pero requiere una opción especial para este archivo en particular, colóquela en las <link linkend="properties"
>Propiedades del archivo</link
> para este archivo. Algunas veces pueden ayudarle dos opciones de &mplayer; si no puede detectar el tipo de archivo automáticamente que son <option
>-vc</option
> y <option
>-ac</option
>, que se corresponden con las opciones del <guilabel
>Codificador</guilabel
> en las páginas <link linkend="properties-video"
>Vídeo</link
> y <link linkend="properties-audio"
>Audio</link
> en <guilabel
>Propiedades del archivo</guilabel
>. Si existen opciones que no se encuentren en el diálogo <guilabel
>Propiedades del archivo</guilabel
>, colóquelas en el campo <guilabel
>Parámetros adicionales de línes de comandos</guilabel
>.</para>

<para
>Si es una lista de reproducción pero no tiene una de las extensiones estándar de los archivos de lista de reproducción, vaya a la <link linkend="properties-general"
>página General</link
> en las <guilabel
>Propiedades del archivo</guilabel
> y cambie la opción <guilabel
>Lista de reproducción</guilabel
> a <guilabel
>si</guilabel
>. En extrañas ocasiones un archivo que no es una lista de reproducción tendrá una extensión de lista de reproducción. Si se da este caso, cambie la propiedad <guilabel
>Lista de reproducción</guilabel
> a <guilabel
>no</guilabel
>. Para obtener más detalles consulte la sección <link linkend="howto-playlist-files"
>Archivos de listas de reproducción</link
> en el micro CÓMO de listas de reproducción.</para>

</sect3>

<sect3>
<title
>No se puede reproducir ningún archivo de vídeo</title>

<para
>Si &kplayer; solo reproduce archivos de audio pero no archivos de vídeo, puede haber problemas con la salida de vídeo. De forma predeterminada &kplayer; utiliza la <link linkend="howto-installation-xvideo"
>extensió XVideo</link
> para la salida de vídeo. Si la extensión no está disponible o está utilizándola otro programa como <application
>Kino</application
>, &kplayer; puede no ser capaz de utilizar una salida de vídeo diferente. Puede bien activar la extensión XVideo o decirle a &kplayer; que use otra salida de vídeo. Consulte el <link linkend="howto-configuration"
>micro CÓMO sobre configuración</link
> para obtener detalles.</para>

</sect3>

<sect3>
<title
>El vídeo se ve bien, pero el sonido no se oye</title>

<para
>Consulte el <link linkend="parts-message-log"
>Registro de mensajes</link
> para ver por qué &mplayer; no puede reproducir audio. El problema más común es que el dispositivo de audio esté bloqueado por otro programa. En este caso el principal sospechoso es <command
>artsd</command
>. Pruebe a ejecutar</para>

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

<para
>desde la línea de órdenes. Si esto funciona, la solución permanente es ir al &kcontrolcenter; y desactivar &arts;. &arts; y todo lo que se basa en él es de lejos la peor parte de &kde;. Afortunadamente parece que existen planes para deshacerse de él finalmente en &kde; 4.</para>

<para
>Para obtener más información en la configuración de audio en &kplayer; consulte el <link linkend="howto-configuration-audio"
>micro CÓMO sobre configuración</link
>.</para>

</sect3>

<sect3>
<title
>&kplayer; no puede reproducir un archivo correctamente con &mplayer;</title>

<para
>Cuando &kplayer; esté en el estado de <guilabel
>Ejecución</guilabel
> o de <guilabel
>Reproducción</guilabel
>, ejecute</para>

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

<para
>desde la línea de orden. Compare las opciones de la línea de órdenes que &kplayer; utiliza para ejecutar &mplayer; con las que esté utilizando para reproducir el archivo con &mplayer;. A continuación comience a añadir las opciones que faltan una por una hasta que obtenga el mismo problema que obtuvo con &kplayer;. Después de que haya descubierto que opción es la que provoca el problema puede abrir el <link linkend="settings"
>diálogo de configuración</link
> en &kplayer; y eliminar o cambiar esta opción. Si necesita hacer el cambio solo para un archivo, vaya a las <link linkend="properties"
>Propiedades del archivo</link
>.</para>

</sect3>

<sect3>
<title
>Problemas volviendo desde el modo de pantalla completa</title>

<para
>Si está teniendo problemas cuando intenta volver al tamaño de ventana normal desde el modo de pantalla completa, por ejemplo la ventana es demasiado grande o está viendo un parpadeo sin fin, puede quitar la selección de la opción <guilabel
>Redimensionar pantalla principal automáticamente</guilabel
> en la <link linkend="settings-general"
>página General</link
> en <guilabel
>Configurar &kplayer;</guilabel
>. También puede leer el hilo sobre este problema en el <ulink url="http://sourceforge.net/forum/forum.php?thread_id=1122221&amp;forum_id=244388"
>foto de usuarios de &kplayer;</ulink
> y ver sus actualizaciones.</para>

</sect3>

<sect3>
<title
>Las estaciones de radio tardan mucho tiempo en comenzar a reproducir</title>

<para
>By default &kplayer; lets &mplayer; choose an optimal cache size. When playing low bitrate media like a radio station, it may take a long time to fill the cache if it is too big. If that happens, you can either choose a lower <guilabel
>Cache size</guilabel
> setting or give a lower minimum cache size on the <guilabel
>Advanced</guilabel
> page either globally in <link linkend="settings-advanced"
>&kplayer; Settings</link
> or in the individual <link linkend="properties-advanced"
>File Properties</link
>. Enter the minimum cache size into the <guilabel
>Additional command line parameters</guilabel
> field, for example <literal
>-cache-min 5</literal
>, or choose <guilabel
>set size</guilabel
> for the <guilabel
>Cache</guilabel
> option and enter a size in kilobytes. For more information on playing online media see the <link linkend="howto-streams"
>Streams micro-HOWTO</link
>.</para>

</sect3>

<sect3>
<title
>Los archivos de vídeo grandes tardan mucho en comenzar a reproducirse</title>

<para
>You may have set the <guilabel
>Cache size</guilabel
> option too low in <link linkend="settings-advanced"
>&kplayer; Settings</link
>. If you need to set it higher or lower for an individual file or stream, you can do so on the <link linkend="properties-advanced"
>Advanced page</link
> in <guilabel
>File Properties</guilabel
>.</para>

</sect3>

<sect3>
<title
>Only the video area is shown in &konqueror;</title>

<para
>If you open a web page with an embedded multimedia object in &konqueror;, only the video area is displayed, with no controls. Then you should <mousebutton
>right</mousebutton
> click the <link linkend="parts-video-area"
>video area</link
> and choose the <guimenuitem
>Start &kplayer;</guimenuitem
> command. Playback will then stop, and the full &kplayer; will open up and start playing the file or <acronym
>URL</acronym
>.</para>

</sect3>

<sect3>
<title
>Los controles de contraste y brillo no funcionan</title>

<para
>You need to enable the <link linkend="howto-installation-xvideo"
>XVideo extension</link
> in your X11 configuration and make sure the XVideo video output is selected on the <link linkend="settings-advanced"
><guilabel
>Video</guilabel
> page</link
> in <guilabel
>&kplayer; Settings</guilabel
>. However, if you cannot use the XVideo output, you can still make the video controls to work by putting the <literal
>-vf eq2</literal
> or <literal
>-vf eq</literal
> option into the <guilabel
>Additional command line parameters</guilabel
> field on the <link linkend="properties-advanced"
>Advanced page</link
> in <guilabel
>&kplayer; Settings</guilabel
>.</para>

</sect3>

</sect2>

</sect1>