advanced.docbook

Amarok是一款在LINUX或其他类UNIX操作系统中运行的音频播放器软件。 经过两年开发后

<chapter id="advanced-features">
<title
>Características Avançadas do Amarok</title>


<sect1 id="keybd-shortcuts">
<title
>Atalhos do Teclado</title>

<para
>O &amarok; usa os atalhos do teclado, como a maioria das outras aplicações; em baixo, encontra-se uma listagem desses atalhos e das suas acções respectivas. Os atalhos globais podem ser configurados se carregar com o &RMB; na janela do Leitor e se seleccionar a opção <guimenuitem
>Configurar os Atalhos Globais...</guimenuitem
>. Os atalhos do &amarok; podem ser configurados se carregar com o &RMB; na janela do Leitor e seleccionar a opção <guimenuitem
>Configurar os Atalhos...</guimenuitem
></para>

<tip
><para
>Você poderá atribuir teclas multimédia para funcionarem como atalhos do &amarok;, tornando o seu teclado um centro de controlo do &amarok;.</para
></tip>

<para
>Os atalhos globais são:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Combinação de Teclas</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>X</keycap
></keycombo
></entry>
<entry
>Reproduzir</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Pausa</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>V</keycap
></keycombo
></entry>
<entry
>Parar</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>B</keycap
></keycombo
></entry>
<entry
>Próxima Faixa</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Faixa Anterior</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Aumentar o Volume</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Diminuir o Volume</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Avançar</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Recuar</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Adicionar Média</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Comutar a Lista</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>O</keycap
></keycombo
></entry>
<entry
>Mostrar o OSD</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Volume Silenciado</entry>
</row>

</tbody>
</tgroup>
</informaltable>

<para
>Os atalhos do &amarok; são:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Combinação de Teclas</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Copiar</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>KP_Enter</keycap
></keycombo
></entry>
<entry
>Ir para a Actual</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>D</keycap
></keycombo
></entry>
<entry
>Colocar na Fila as Faixas Seleccionadas</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Q</keycap
></keycombo
></entry>
<entry
>Sair</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Refazer</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Gravar a Lista de Reprodução</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Seleccionar Tudo</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Mostrar o Menu</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>H</keycap
></keycombo
></entry>
<entry
>Baralhar</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Desfazer</entry>
</row>


</tbody>
</tgroup>
</informaltable>


<para
>Os atalhos do Navegador na Lista de Reprodução são:</para>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Combinação de Teclas</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Espaço</keycap
></entry>
<entry
>Carregar Listas</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Mudar o Nome da Lista</entry>
</row>

<row>
<entry
><keycap
>Backspace</keycap
></entry>
<entry
>Remover a Lista</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="the-dcop-interface">
<title
>A Interface DCOP</title>

<para
>A interface de DCOP do Amarok oferece-lhe uma forma simples de controlar o Amarok com os seus próprios programas personalizados.</para>

<para
>A interface de DCOP do Amarok tem várias funções genéricas que poderão ser encontradas noutras aplicações do KDE. Esta secção está dividida em seis tabelas e pretende descrever as funções do DCOP para a colecção, o navegador de contexto, o leitor, a lista, o navegador da lista para os programas. Um exemplo da função de DCOP <quote
>pause</quote
> seria semelhante ao seguinte:</para>

<para
><prompt
>&percnt;</prompt
>dcop amarok player pause</para>

<sect2 id="dcop-collection">
<title
>dcop amarok collection</title>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Chamada DCOP</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>

<row>
<entry
>int totalAlbums()</entry>
<entry
>Devolve o número total de álbuns na sua colecção.</entry>
</row>

<row>
<entry
>int totalArtists()</entry>
<entry
>Devolve o número total de artistas na sua colecção.</entry>
</row>

<row>
<entry
>int totalCompilations()</entry>
<entry
>Devolve o número total de compilações na sua colecção.</entry>
</row>

<row>
<entry
>int totalGenres()</entry>
<entry
>Devolve o número total de géneros musicais na sua colecção.</entry>
</row>

<row>
<entry
>int totalTracks()</entry>
<entry
>Devolve o número total de faixas na sua colecção.</entry>
</row>

<row>
<entry
>QString query( QString sql)</entry>
<entry
>Executa uma pesquisa de SQL na base de dados.</entry>
</row>

<row>
<entry
>QStringList similarArtists( int artistas )</entry>
<entry
>Devolve os artistas semelhantes às faixas actuais, limitando a quantidade a 'artistas'.</entry>
</row>

<row>
<entry
>void migrateFile( QString urlAntigo, QString urlNovo )</entry>
<entry
>Move um ficheiro na colecção, mantendo as estatísticas intactas.</entry>
</row>

<row>
<entry
>void scanCollection()</entry>
<entry
>Pesquisa a colecção.</entry>
</row>

<row>
<entry
>void scanCollectionChanges()</entry>
<entry
>Pesquisa a colecção apenas à procura de alterações.</entry>
</row>


</tbody>
</tgroup>
</informaltable>

</sect2>

<sect2 id="dcop-context">
<title
>dcop amarok contextbrowser</title>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Chamada DCOP</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>

<row>
<entry
>void showCurrentTrack()</entry>
<entry
>Mostra a faixa actual no navegador de contexto.</entry>
</row>

<row>
<entry
>void showLyrics()</entry>
<entry
>Mostra a página das letras no navegador de contexto.</entry>
</row>

<row>
<entry
>void showWiki()</entry>
<entry
>Mostra a página do Wikipedia no navegador de contexto.</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect2>

<sect2 id="dcop-player">
<title
>dcop amarok player</title>

<informaltable>
<tgroup cols="2">
<thead>

<row>
<entry
>Chamada DCOP</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>

<row>
<entry
>bool dynamicModeStatus()</entry>
<entry
>Devolve o estado do modo dinâmico.</entry>
</row>

<row>
<entry
>bool equalizerEnabled()</entry>
<entry
>Devolve o estado do equalizador.</entry>
</row>

<row>
<entry
>bool isPlaying()</entry>
<entry
>Devolve 'true' se algo estiver a tocar de momento.</entry>
</row>

<row>
<entry
>bool randomModeStatus()</entry>
<entry
>Devolve o estado do modo aleatório.</entry>
</row>

<row>
<entry
>bool repeatPlaylistStatus()</entry>
<entry
>Devolve o estado de repetição da lista.</entry>
</row>

<row>
<entry
>bool repeatTrackStatus()</entry>
<entry
>Devolve o estado de repetição da faixa.</entry>
</row>

<row>
<entry
>int getVolume()</entry>
<entry
>Devolve o volume num intervalo de 0-100%.</entry>
</row>

<row>
<entry
>int sampleRate()</entry>
<entry
>Devolve a taxa de amostragem da faixa actualmente em reprodução.</entry>
</row>

<row>
<entry
>int score()</entry>
<entry
>Devolve a pontuação da faixa actual.</entry>
</row>

<row>
<entry
>int status()</entry>
<entry
>Devolve o estado de reprodução: 0 - parado, 1 - pausa, 2 - em reprodução.</entry>
</row>

<row>
<entry
>int trackCurrentTime()</entry>
<entry
>Devolve a posição de reprodução actual em segundos.</entry>
</row>

<row>
<entry
>int trackPlayCounter()</entry>
<entry
>Devolve o contador de reprodução da música actual.</entry>
</row>

<row>
<entry
>int trackTotalTime()</entry>
<entry
>Devolve o tamanho da faixa em segundos.</entry>
</row>

<row>
<entry
>QString album()</entry>
<entry
>Devolve o álbum da música que está a tocar de momento.</entry>
</row>

<row>
<entry
>QString artist()</entry>
<entry
>Devolve o artista da faixa actual.</entry>
</row>

<row>
<entry
>QString bitrate()</entry>
<entry
>Devolve a taxa de amostragem em bits da faixa actual (XX kbps).</entry>
</row>

<row>
<entry
>QString comment()</entry>
<entry
>Devolve o comentário da música a tocar de momento.</entry>
</row>

<row>
<entry
>QString coverImage()</entry>
<entry
>Devolve o URL codificado da imagem de capa da faixa actual. </entry>
</row>

<row>
<entry
>QString currentTime()</entry>
<entry
>Devolve a posição ([h:]mm:ss) da música a tocar de momento.</entry>
</row>

<row>
<entry
>QString encodedURL()</entry>
<entry
>Devolve o URL codificado da faixa actual.</entry>
</row>

<row>
<entry
>QString engine()</entry>
<entry
>Devolve o motor de áudio actual.</entry>
</row>

<row>
<entry
>QString genre()</entry>
<entry
>Devolve o género da música a tocar de momento.</entry>
</row>

<row>
<entry
>QString lyrics()</entry>
<entry
>Devolve as letras da faixa actual.</entry>
</row>

<row>
<entry
>QString lyricsByPath( QString local )</entry>
<entry
>Devolve as letra de uma faixa pela sua localização.</entry>
</row>

<row>
<entry
>QString nowPlaying()</entry>
<entry
>O título da faixa actualmente em reprodução.</entry>
</row>

<row>
<entry
>QString path()</entry>
<entry
>Devolve o local não-codificado da faixa actual.</entry>
</row>

<row>
<entry
>QString setContextStyle( QString )</entry>
<entry
>Define o estilo de CSS para o navegador de contexto.</entry>
</row>

<row>
<entry
>QString title()</entry>
<entry
>Devolve o título da faixa actual.</entry>
</row>

<row>
<entry
>QString totalTime()</entry>
<entry
>Devolve o tamanho total da música a tocar de momento (no formato [h:]mm:ss).</entry>
</row>

<row>
<entry
>QString track()</entry>
<entry
>Devolve o número da faixa.</entry>
</row>

<row>
<entry
>QString type()</entry>
<entry
>Devolve o tipo de ficheiro.</entry>
</row>

<row>
<entry
>QString year()</entry>
<entry
>Devolve o ano da música a tocar de momento.</entry>
</row>

<row>
<entry
>void configEqualizer()</entry>
<entry
>Activa ou desactiva a janela de configuração do equalizador.</entry>
</row>

<row>
<entry
>void enableDynamicMode(bool activar)</entry>
<entry
>Activa ou desactiva o Modo Dinâmico.</entry>
</row>

<row>
<entry
>void enableOSD(bool activar)</entry>
<entry
>Activa ou desactiva a visualização OSD.</entry>
</row>