advanced.docbook

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

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


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

<para
>&amarok; bruger tastaturgenveje ligesom de fleste andre programmer. Nedenfor er der en liste af disse genveje og deres respektive handlinger. De globale genveje kan indstilles ved at højreklikke i afspillervinduet og vælge <guimenuitem
>Indstil globale genveje...</guimenuitem
> &amarok;'s genveje kan indstilles ved at højreklikke i afspillerevinduet og vælge <guimenuitem
>Indstil genveje...</guimenuitem
></para>

<tip
><para
>Du kan knytte dine multimedie-taster til at virke som genveje for &amarok; og derved gøre dit tastatur til et kontrolcenter for &amarok;.</para
></tip>

<para
>De globale genveje er:</para>

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

<row>
<entry
>Tastekombination</entry>
<entry
>Handling</entry>
</row>
</thead>
<tbody>

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

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

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

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>B</keycap
></keycombo
></entry>
<entry
>Næste spor</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Forrige spor</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Højere lydstyrke</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Lavere lydstyrke</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Søg fremad</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Søg tilbage</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Tilføj medie</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Slå spilleliste til og fra</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>O</keycap
></keycombo
></entry>
<entry
>Vis OSD</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Slå lyd fra</entry>
</row>

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

<para
>&amarok;'s genveje er:</para>

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

<row>
<entry
>Tastekombination</entry>
<entry
>Handling</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Kopiér</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>KP_Enter</keycap
></keycombo
></entry>
<entry
>Gå til nuværende</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>D</keycap
></keycombo
></entry>
<entry
>Sæt markerede spor i kø</entry>
</row>

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

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Annullér fortryd</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Gem spilleliste</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Markér alle</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Vis menulinje</entry>
</row>

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

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


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


<para
>Spilleliste-browserens genveje er:</para>

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

<row>
<entry
>Tastekombination</entry>
<entry
>Handling</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Mellemrum</keycap
></entry>
<entry
>Indlæs spilleliste</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Omdøb spilleliste</entry>
</row>

<row>
<entry
><keycap
>Backspace</keycap
></entry>
<entry
>Fjern spilleliste</entry>
</row>

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

</sect1>

<sect1 id="the-dcop-interface">
<title
>DCOP-Grænsefladen</title>

<para
>Amarok's DCOP-grænseflade giver dig en nem måde at kontrollere Amarok med dine hjemmelavede scripter.</para>

<para
>DCOP-grænsefladen for Amarok har mange generiske kald der kan findes i andre af  KDE's programmer. Dette afsnit er opdelt i seks tabeller og er beregnet til at beskrive DCOP-kald for samling, sammenhængsbrowser,  afspiller, spilleliste, spillelistebrowser og scripter. Et eksempel på <quote
>pause</quote
> dcop-kaldet ville se sådan ud:</para>

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

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

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

<row>
<entry
>DCOP-kald</entry>
<entry
>Handling</entry>
</row>
</thead>
<tbody>

<row>
<entry
>int totalAlbums()</entry>
<entry
>Returnerer det totale antal albummer i samlingen.</entry>
</row>

<row>
<entry
>int totalArtists()</entry>
<entry
>Returnerer det totale antal artister i samlingen.</entry>
</row>

<row>
<entry
>int totalCompilations()</entry>
<entry
>Returnerer det totale antal samlingsalbummer i samlingen.</entry>
</row>

<row>
<entry
>int totalGenres()</entry>
<entry
>Returnerer det totale antal genrer i samlingen.</entry>
</row>

<row>
<entry
>int totalTracks()</entry>
<entry
>Returnerer det totale antal spor i samlingen.</entry>
</row>

<row>
<entry
>QString query( QString sql)</entry>
<entry
>Sender en forespørgsel til databasen via SQL.</entry>
</row>

<row>
<entry
>QStringList similarArtists( int artister )</entry>
<entry
>Returnerer lignende artister som det nuværende spor, begrænset til antal givet af artister.</entry>
</row>

<row>
<entry
>void migrateFile( QString gammel_url, QString ny_url )</entry>
<entry
>Flyt en fil i samlingen, og behold statistikken intakt.</entry>
</row>

<row>
<entry
>void scanCollection()</entry>
<entry
>Gennemsøg samlingen.</entry>
</row>

<row>
<entry
>void scanCollectionChanges()</entry>
<entry
>Søg kun gennem samlingen efter ændringer.</entry>
</row>


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

</sect2>

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

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

<row>
<entry
>DCOP-kald</entry>
<entry
>Handling</entry>
</row>
</thead>
<tbody>

<row>
<entry
>void showCurrentTrack()</entry>
<entry
>Vis det nuværende spor i sammenhængsbrowseren.</entry>
</row>

<row>
<entry
>void showLyrics()</entry>
<entry
>Vis sangtekstfanebladet i sammenhængsbrowseren.</entry>
</row>

<row>
<entry
>void showWiki()</entry>
<entry
>Vis Wikipedia-fanebladet i sammenhængsbrowseren.</entry>
</row>

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

</sect2>

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

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

<row>
<entry
>DCOP-kald</entry>
<entry
>Handling</entry>
</row>
</thead>
<tbody>

<row>
<entry
>bool dynamicModeStatus()</entry>
<entry
>Returnér status for dynamisk tilstand.</entry>
</row>

<row>
<entry
>bool equalizerEnabled()</entry>
<entry
>Returnér status for equalizeren.</entry>
</row>

<row>
<entry
>bool isPlaying()</entry>
<entry
>Returnér sand hvis noget spilles nu.</entry>
</row>

<row>
<entry
>bool randomModeStatus()</entry>
<entry
>Returnér status for tilfældig tilstand</entry>
</row>

<row>
<entry
>bool repeatPlaylistStatus()</entry>
<entry
>Returnér status for gentagelse af spillelisten.</entry>
</row>

<row>
<entry
>bool repeatTrackStatus()</entry>
<entry
>Returnér status for gentagelse af spor.</entry>
</row>

<row>
<entry
>int getVolume()</entry>
<entry
>Returnér lydstyrke i intervallet 0 - 100 %.</entry>
</row>

<row>
<entry
>int sampleRate()</entry>
<entry
>Returnerer samplingsfrekvensen for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>int score()</entry>
<entry
>Returnér scoring for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>int status()</entry>
<entry
>Returnér afspilningsstatus: 0 - stoppet, 1 - pause, 2 - spiller.</entry>
</row>

<row>
<entry
>int trackCurrentTime()</entry>
<entry
>Returnerer nuværende afspilningsposition i sekunder.</entry>
</row>

<row>
<entry
>int trackPlayCounter()</entry>
<entry
>Returnerer afspilningstælleren for nuværende sang.</entry>
</row>

<row>
<entry
>int trackTotalTime()</entry>
<entry
>Returnerer sporlængden i sekunder.</entry>
</row>

<row>
<entry
>QString album()</entry>
<entry
>Returnerer albummet for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString artist()</entry>
<entry
>Returnerer artisten for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString bitrate()</entry>
<entry
>Returnér bithastigheden for sporet som for øjeblikket spilles (i kilobit pr sekund).</entry>
</row>

<row>
<entry
>QString comment()</entry>
<entry
>Returnerer kommentaren for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString coverImage()</entry>
<entry
>Returnerer den kodede URL for nuværende spors omslag </entry>
</row>

<row>
<entry
>QString currentTime()</entry>
<entry
>Returnér positionen for sporet som for øjeblikket spilles (i formatet [t:]mm:ss).</entry>
</row>

<row>
<entry
>QString encodedURL()</entry>
<entry
>Returnér den indkodede url for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString engine()</entry>
<entry
>Returnerer nuværende lydgrænseflade.</entry>
</row>

<row>
<entry
>QString genre()</entry>
<entry
>Returnerer genren for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString lyrics()</entry>
<entry
>Returnerer sangteksten for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString lyricsByPath( QString søgesti )</entry>
<entry
>Returnér sangtekst for et spor ifølge søgesti.</entry>
</row>

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

<row>
<entry
>QString path()</entry>
<entry
>Returnér den ikke-indkodede søgesti for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString setContekstStyle( QString )</entry>
<entry
>Indstil CSS-stilen for sammenhængsbrowseren.</entry>
</row>

<row>
<entry
>QString title()</entry>
<entry
>Returnerer titlen for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>QString totalTime()</entry>
<entry
>Returnér den totale længde for sporet som for øjeblikket spilles (i formatet [t:]mm:ss).</entry>
</row>

<row>
<entry
>QString track()</entry>
<entry
>Returnér spornummeret.</entry>
</row>

<row>
<entry
>QString type()</entry>
<entry
>Returnér filtypen.</entry>
</row>

<row>
<entry
>QString year()</entry>
<entry
>Returnerer året for sporet som for øjeblikket spilles.</entry>
</row>

<row>
<entry
>void configEqualizer()</entry>
<entry
>Skift equalizerens indstillingsdialog.</entry>
</row>

<row>
<entry
>void enableDynamicMode(bool aktivere)</entry>
<entry
>Slå dynamisk tilstand til og fra.</entry>
</row>

<row>
<entry
>void enableOSD(bool aktivér)</entry>
<entry
>Slå skærmmeddelelser til og fra.</entry>
</row>