advanced.docbook

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

<chapter id="advanced-features">
<title
>Avancerade funktioner i Amarok</title>


<sect1 id="keybd-shortcuts">
<title
>Snabbtangenter</title>

<para
>&amarok; använder snabbtangenter som de flesta andra program. Nedan finns en lista över dessa snabbtangenter och deras olika funktioner. De globala snabbtangenterna kan ställas in genom att högerklicka i spelarfönstret och välja <guimenuitem
>Anpassa globala genvägar...</guimenuitem
> Snabbtangenterna i &amarok; kan anpassas genom att högerklicka i spelarfönstret och välja <guimenuitem
>Anpassa genvägar...</guimenuitem
></para>

<tip
><para
>Du kan tilldela multimediatangenter att fungera som snabbtangenter i &amarok;, för att låta tangentbordet styra &amarok;.</para
></tip>

<para
>De globala genvägarna är:</para>

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

<row>
<entry
>Tangentkombination</entry>
<entry
>Åtgärd</entry>
</row>
</thead>
<tbody>

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

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

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

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>B</keycap
></keycombo
></entry>
<entry
>Nästa spår</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Föregående spår</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Numeriskt tangentbord +</keycap
></keycombo
></entry>
<entry
>Öka volym</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Numeriskt tangentbord -</keycap
></keycombo
></entry>
<entry
>Minska volym</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Skift</keycap
><keycap
>numeriskt +</keycap
></keycombo
></entry>
<entry
>Sök framåt</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Skift</keycap
><keycap
>numeriskt -</keycap
></keycombo
></entry>
<entry
>Sök bakåt</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Lägg till media</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Växla spellista</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>O</keycap
></keycombo
></entry>
<entry
>Aktivera skärmvisning</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Tysta volym</entry>
</row>

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

<para
>Genvägarna i &amarok; är:</para>

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

<row>
<entry
>Tangentkombination</entry>
<entry
>Åtgärd</entry>
</row>
</thead>
<tbody>

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

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Numeriskt tangentbord Enter</keycap
></keycombo
></entry>
<entry
>Gå till nuvarande</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>D</keycap
></keycombo
></entry>
<entry
>Köa markerade spår</entry>
</row>

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

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Skift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Gör om</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Spara spellista</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Markera alla</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Visa menyrad</entry>
</row>

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

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Ångra</entry>
</row>


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


<para
>Spellistebläddrarens genvägar är:</para>

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

<row>
<entry
>Tangentkombination</entry>
<entry
>Åtgärd</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Mellanslag</keycap
></entry>
<entry
>Ladda spellista</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Byt namn på spellista</entry>
</row>

<row>
<entry
><keycap
>Backsteg</keycap
></entry>
<entry
>Ta bort spellista</entry>
</row>

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

</sect1>

<sect1 id="the-dcop-interface">
<title
>DCOP-gränssnittet</title>

<para
>Amaroks DCOP-gränssnitt tillhandahåller ett enkelt sätt att styra Amarok med dina egna skript.</para>

<para
>DCOP-gränssnittet i Amarok har många generella funktioner som också finns i andra KDE-program. Det här avsnittet är uppdelat i sex tabeller och är avsett att beskriva DCOP-anrop för samlingen, sammanhangsbläddraren, spelaren, spellistan, spellistebläddraren och skript. Ett exempel på DCOP-funktionen <quote
>pause</quote
> skulle se ut så här:</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
>DCOP-anrop</entry>
<entry
>Åtgärd</entry>
</row>
</thead>
<tbody>

<row>
<entry
>int totalAlbums()</entry>
<entry
>Returnerar det totala antalet album i samlingen.</entry>
</row>

<row>
<entry
>int totalArtists()</entry>
<entry
>Returnerar det totala antalet artister i samlingen.</entry>
</row>

<row>
<entry
>int totalCompilations()</entry>
<entry
>Returnerar det totala antalet samlingsalbum i samlingen.</entry>
</row>

<row>
<entry
>int totalGenres()</entry>
<entry
>Returnerar det totala antalet genrer i samlingen.</entry>
</row>

<row>
<entry
>int totalTracks()</entry>
<entry
>Returnerar det totala antalet spår i samlingen.</entry>
</row>

<row>
<entry
>QString query( QString sql)</entry>
<entry
>Skickar en fråga till databasen via SQL.</entry>
</row>

<row>
<entry
>QStringList similarArtists( int artister )</entry>
<entry
>Returnera liknande artister som det nuvarande spåret, begränsat till antal givet av artister.</entry>
</row>

<row>
<entry
>void migrateFile( QString gammal_webbadress, QString ny_webbadress )</entry>
<entry
>Flytta en fil i samlingen, och behåll statistiken intakt.</entry>
</row>

<row>
<entry
>void scanCollection()</entry>
<entry
>Sök igenom samlingen.</entry>
</row>

<row>
<entry
>void scanCollectionChanges()</entry>
<entry
>Sök enbart igenom samlingen efter ändringar.</entry>
</row>


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

</sect2>

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

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

<row>
<entry
>DCOP-anrop</entry>
<entry
>Åtgärd</entry>
</row>
</thead>
<tbody>

<row>
<entry
>void showCurrentTrack()</entry>
<entry
>Visa det nuvarande spåret i sammanhangsbläddraren.</entry>
</row>

<row>
<entry
>void showLyrics()</entry>
<entry
>Visa sångtextfliken i sammanhangsbläddraren.</entry>
</row>

<row>
<entry
>void showWiki()</entry>
<entry
>Visa Wikipedia-fliken i sammanhangsbläddraren.</entry>
</row>

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

</sect2>

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

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

<row>
<entry
>DCOP-anrop</entry>
<entry
>Åtgärd</entry>
</row>
</thead>
<tbody>

<row>
<entry
>bool dynamicModeStatus()</entry>
<entry
>Returnera status för dynamiskt läge.</entry>
</row>

<row>
<entry
>bool equalizerEnabled()</entry>
<entry
>Returnera status för equalizern.</entry>
</row>

<row>
<entry
>bool isPlaying()</entry>
<entry
>Returnera sant om något spelas nu.</entry>
</row>

<row>
<entry
>bool randomModeStatus()</entry>
<entry
>Returnera status för slumpmässigt läge</entry>
</row>

<row>
<entry
>bool repeatPlaylistStatus()</entry>
<entry
>Returnera status för upprepning av spellistan.</entry>
</row>

<row>
<entry
>bool repeatTrackStatus()</entry>
<entry
>Returnera status för upprepning av spår.</entry>
</row>

<row>
<entry
>int getVolume()</entry>
<entry
>Returnera volymen i intervallet 0 - 100 %.</entry>
</row>

<row>
<entry
>int sampleRate()</entry>
<entry
>Returnera samplingsfrekvensen för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>int score()</entry>
<entry
>Returnera poängen för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>int status()</entry>
<entry
>Returnera uppspelningsstatus: 0 - stoppad, 1 - paus, 2 - spelar.</entry>
</row>

<row>
<entry
>int trackCurrentTime()</entry>
<entry
>Returnerar nuvarande uppspelningsposition i sekunder.</entry>
</row>

<row>
<entry
>int trackPlayCounter()</entry>
<entry
>Returnerar uppspelningsräknaren för nuvarande sång.</entry>
</row>

<row>
<entry
>int trackTotalTime()</entry>
<entry
>Returnerar spårlängden i sekunder.</entry>
</row>

<row>
<entry
>QString album()</entry>
<entry
>Returnera albumet för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString artist()</entry>
<entry
>Returnera artisten för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString bitrate()</entry>
<entry
>Returnera bithastigheten för spåret som för närvarande spelas (i kilobit per sekund).</entry>
</row>

<row>
<entry
>QString comment()</entry>
<entry
>Returnera kommentaren för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString coverImage()</entry>
<entry
>Returnera den kodade webbadressen till nuvarande spårs skivomslag </entry>
</row>

<row>
<entry
>QString currentTime()</entry>
<entry
>Returnera positionen för spåret som för närvarande spelas (på formatet [t:]mm:ss).</entry>
</row>

<row>
<entry
>QString encodedURL()</entry>
<entry
>Returnera den kodade webbadressen för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString engine()</entry>
<entry
>Returnera nuvarande ljudgränssnitt.</entry>
</row>

<row>
<entry
>QString genre()</entry>
<entry
>Returnera genren för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString lyrics()</entry>
<entry
>Returnera sångtexten för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString lyricsByPath( QString sökväg )</entry>
<entry
>Returnera sångtext för ett spår enligt sökväg.</entry>
</row>

<row>
<entry
>QString nowPlaying()</entry>
<entry
>Titeln på det medium som nu spelas.</entry>
</row>

<row>
<entry
>QString path()</entry>
<entry
>Returnera den okodade sökvägen för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString setContextStyle( QString )</entry>
<entry
>Ställ in CSS-stilen för sammanhangsbläddraren.</entry>
</row>

<row>
<entry
>QString title()</entry>
<entry
>Returnera titeln för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>QString totalTime()</entry>
<entry
>Returnera totala längden för spåret som för närvarande spelas (på formatet [t:]mm:ss).</entry>
</row>

<row>
<entry
>QString track()</entry>
<entry
>Returnera spårnumret.</entry>
</row>

<row>
<entry
>QString type()</entry>
<entry
>Returnera filtypen.</entry>
</row>

<row>
<entry
>QString year()</entry>
<entry
>Returnera året för spåret som för närvarande spelas.</entry>
</row>

<row>
<entry
>void configEqualizer()</entry>
<entry
>Växla equalizerns inställningsdialogruta.</entry>
</row>

<row>
<entry
>void enableDynamicMode(bool aktivera)</entry>
<entry
>Sätt på eller stäng av dynamiskt läge.</entry>
</row>

<row>
<entry
>void enableOSD(bool aktivera)</entry>
<entry
>Sätt på eller stäng av skärmmeddelanden.</entry>
</row>