advanced.docbook

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

<chapter id="advanced-features">
<title
>Amaroks erweiterte Funktionen</title>


<sect1 id="keybd-shortcuts">
<title
>Tastenkürzel</title>

<para
>&amarok; benutzt wie alle anderen Programme Tastenkürzel. Unten finden Sie eine Liste dieser Kürzel und ihre Funktion. Die globalen Tastenkürzel können Sie einrichten, indem Sie mit der rechten Maustaste in das Player-Fenster klicken und <guimenuitem
>Globale Tastenkürzel einrichten...</guimenuitem
> auswählen. Die &amarok;-spezifischen Tastenkürzel können Sie einrichten, indem Sie mit der rechten Maustaste in das Player-Fenster klicken und <guimenuitem
>Kurzbefehle festlegen...</guimenuitem
> auswählen.</para>

<tip
><para
>Sie können eventuell vorhandene Multimedia-Tasten so einrichten, dass sie als &amarok;-Kurzbefehle funktionieren. Dadurch machen Sie Ihre Tastatur zum &amarok;-Kontrollzentrum.</para
></tip>

<para
>Die globalen Tastenkürzel sind:</para>

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

<row>
<entry
>Tastenkombination</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>X</keycap
></keycombo
></entry>
<entry
>Wiedergabe</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
>Stopp</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>B</keycap
></keycombo
></entry>
<entry
>Nächstes Stück</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Voriges Stück</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Num_Plus</keycap
></keycombo
></entry>
<entry
>Lautstärke erhöhen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Num_Minus</keycap
></keycombo
></entry>
<entry
>Lautstärke senken</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>Num_Plus</keycap
></keycombo
></entry>
<entry
>Vorwärts suchen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>Num_Minus</keycap
></keycombo
></entry>
<entry
>Rückwärts suchen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Hinzufügen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Wiedergabeliste anzeigen/ausblenden</entry>
</row>

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

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Stumm schalten</entry>
</row>

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

<para
>Die &amarok;-spezifischen Kurzbefehle sind:</para>

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

<row>
<entry
>Tastenkombination</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Kopieren</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Num_Eingabe</keycap
></keycombo
></entry>
<entry
>Zum aktuellen Stück springen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>D</keycap
></keycombo
></entry>
<entry
>Ausgewählte Stücke in die Warteschlange einstellen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Q</keycap
></keycombo
></entry>
<entry
>Beenden</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Shift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Wiederholen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Wiedergabeliste speichern</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Alles auswählen</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Blendet die Menüleiste ein/aus.</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>H</keycap
></keycombo
></entry>
<entry
>Zufallsmodus</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Strg</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Rückgängig</entry>
</row>


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


<para
>Die Kurzbefehle für den Wiedergabelisten-Browser sind:</para>

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

<row>
<entry
>Tastenkombination</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Leertaste</keycap
></entry>
<entry
>Wiedergabeliste laden</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Wiedergabeliste umbenennen</entry>
</row>

<row>
<entry
><keycap
>Rücktaste</keycap
></entry>
<entry
>Wiedergabeliste entfernen</entry>
</row>

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

</sect1>

<sect1 id="the-dcop-interface">
<title
>Die DCOP-Schnittstelle</title>

<para
>Mit Hilfe der DCOP-Schnittstelle können Sie Amarok ganz leicht durch eigene Skripte erweitern.</para>

<para
>Die DCOP-Schnittstelle von Amarok hat viele allgemeine Funktionen, die zumeist auch in anderen KDE-Programmen zu finden sind. Dieser Abschnitt besteht aus sechs Teilen und soll die DCOP-Funktionen von Sammlung, Kontext-Browser, Player, Wiedergabeliste, Wiedergabelisten-Browser und Skripten beschreiben. Ein Beispielaufruf für die DCOP-Funktion <quote
>pause</quote
> könnte &zb; so aussehen:</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-Aufruf</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
>int totalAlbums()</entry>
<entry
>Gibt die Gesamtzahl der Alben in der Sammlung zurück.</entry>
</row>

<row>
<entry
>int totalArtists()</entry>
<entry
>Gibt die Gesamtzahl der Interpreten in der Sammlung zurück.</entry>
</row>

<row>
<entry
>int totalCompilations()</entry>
<entry
>Gibt die Gesamtzahl der Zusammenstellungen in der Sammlung zurück.</entry>
</row>

<row>
<entry
>int totalGenres()</entry>
<entry
>Gibt die Gesamtzahl der Genres in der Sammlung zurück.</entry>
</row>

<row>
<entry
>int totalTracks()</entry>
<entry
>Gibt die Gesamtzahl der Stücke in der Sammlung zurück.</entry>
</row>

<row>
<entry
>QString query( QString sql)</entry>
<entry
>Fragt die Datenbank mit Hilfe einer SQL-Abfrage ab.</entry>
</row>

<row>
<entry
>QStringList similarArtists( int artists )</entry>
<entry
>Gibt die ähnlichen Interpreten für das aktuelle Stück zurück - beschränkt auf die Maximalzahl int artists.</entry>
</row>

<row>
<entry
>void migrateFile( QString oldURL, QString newURL )</entry>
<entry
>Verschiebt eine Datei innerhalb der Sammlung und behält dabei die Statistiken bei.</entry>
</row>

<row>
<entry
>void scanCollection()</entry>
<entry
>Durchsucht die Sammlung</entry>
</row>

<row>
<entry
>void scanCollectionChanges()</entry>
<entry
>Durchsucht die Sammlung nur nach Änderungen.</entry>
</row>


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

</sect2>

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

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

<row>
<entry
>DCOP-Aufruf</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
>void showCurrentTrack()</entry>
<entry
>Zeigt das aktuelle Stück im Kontext-Browser an.</entry>
</row>

<row>
<entry
>void showLyrics()</entry>
<entry
>Zeigt das Text-Unterfenster im Kontext-Browser an.</entry>
</row>

<row>
<entry
>void showWiki()</entry>
<entry
>Zeigt das Wikipedia-Unterfenster im Kontext-Browser an.</entry>
</row>

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

</sect2>

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

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

<row>
<entry
>DCOP-Aufruf</entry>
<entry
>Funktion</entry>
</row>
</thead>
<tbody>

<row>
<entry
>bool dynamicModeStatus()</entry>
<entry
>Gibt den Status des dynamischen Modus zurück.</entry>
</row>

<row>
<entry
>bool equalizerEnabled()</entry>
<entry
>Gibt den Status des Equalizers aus.</entry>
</row>

<row>
<entry
>bool isPlaying()</entry>
<entry
>Gibt true zurück, wenn derzeit ein Stück gespielt wird.</entry>
</row>

<row>
<entry
>bool randomModeStatus()</entry>
<entry
>Gibt den Status des Zufallsmodus zurück.</entry>
</row>

<row>
<entry
>bool repeatPlaylistStatus()</entry>
<entry
>Gibt den Status des Wiederholungsmodus für die Wiedergabeliste zurück.</entry>
</row>

<row>
<entry
>bool repeatTrackStatus()</entry>
<entry
>Gibt den Status des Wiederholungsmodus für das Stück zurück.</entry>
</row>

<row>
<entry
>int getVolume()</entry>
<entry
>Gibt die Lautstärke im Bereich zwischen 0-100% zurück.</entry>
</row>

<row>
<entry
>int sampleRate()</entry>
<entry
>Gibt die Abtastrate für das aktuell laufende Stück zurück.</entry>
</row>

<row>
<entry
>int score()</entry>
<entry
>Gibt die Punkte für das aktuell laufende Stück zurück.</entry>
</row>

<row>
<entry
>int status()</entry>
<entry
>Gibt den Wiedergabestatus zurück: 0 = gestoppt, 1 = pausiert, 2 = wiedergabe.</entry>
</row>

<row>
<entry
>int trackCurrentTime()</entry>
<entry
>Gibt die aktuelle Abspielposition in Sekunden zurück.</entry>
</row>

<row>
<entry
>int trackPlayCounter()</entry>
<entry
>Gibt den Wiedergabezähler für das aktuelle Stück zurück.</entry>
</row>

<row>
<entry
>int trackTotalTime()</entry>
<entry
>Gibt die Stücklänge in Sekunden zurück.</entry>
</row>

<row>
<entry
>QString album()</entry>
<entry
>Gibt das Album des derzeit laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>QString artist()</entry>
<entry
>Gibt den Interpreten des aktuellen Stücks zurück.</entry>
</row>

<row>
<entry
>QString bitrate()</entry>
<entry
>Gibt die Bitrate des aktuellen Stücks zurück (XX kbps).</entry>
</row>

<row>
<entry
>QString comment()</entry>
<entry
>Gibt den Kommentar zum aktuell laufenden Stück zurück.</entry>
</row>

<row>
<entry
>QString coverImage()</entry>
<entry
>Gibt die kodierte Adresse zum Cover-Bild des aktuell laufenden Stücks zurück. </entry>
</row>

<row>
<entry
>QString currentTime()</entry>
<entry
>Gibt die Wiedergabeposition des aktuell laufenden Stücks im Format [h:]mm:ss zurück.</entry>
</row>

<row>
<entry
>QString encodedURL()</entry>
<entry
>Gibt die kodierte Adresse des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>QString engine()</entry>
<entry
>Gibt den zur Zeit verwendeten Audio-Treiber zurück.</entry>
</row>

<row>
<entry
>QString genre()</entry>
<entry
>Gibt das Genre des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>QString lyrics()</entry>
<entry
>Gibt den Text des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>QString lyricsByPath( QString path )</entry>
<entry
>Gibt den Text eines im Pfad angegebenen Stücks zurück.</entry>
</row>

<row>
<entry
>QString nowPlaying()</entry>
<entry
>Der Titel des aktuell laufenden Mediums.</entry>
</row>

<row>
<entry
>QString path()</entry>
<entry
>Gibt den unkodierten Pfad zum aktuell laufenden Stück zurück.</entry>
</row>

<row>
<entry
>QString setContextStyle( QString )</entry>
<entry
>Legt den CSS-Stil für den Kontext-Browser fest.</entry>
</row>

<row>
<entry
>QString title()</entry>
<entry
>Gibt den Titel des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>QString totalTime()</entry>
<entry
>Gibt die Gesamtlänge des aktuell laufenden Stücks im Format [h:]mm:ss zurück.</entry>
</row>

<row>
<entry
>QString track()</entry>
<entry
>Gibt die Stück-Nummer zurück.</entry>
</row>

<row>
<entry
>QString type()</entry>
<entry
>Gibt den Dateityp zurück.</entry>
</row>

<row>
<entry
>QString year()</entry>
<entry
>Gibt das Erscheinungsjahr des aktuell laufenden Stücks zurück.</entry>
</row>

<row>
<entry
>void configEqualizer()</entry>
<entry
>Schaltet das Equalizer-Fenster ein/aus.</entry>
</row>

<row>
<entry
>void enableDynamicMode(bool enable)</entry>
<entry
>Schaltet den dynamischen Modus ein/aus.</entry>
</row>

<row>
<entry
>void enableOSD(bool enable)</entry>
<entry
>Schaltet die OSD-Anzeige ein/aus.</entry>
</row>

<row>
<entry
>void enableRandomMode(bool enable)</entry>
<entry
>Schaltet den Zufallsmodus ein/aus.</entry>
</row>

<row>
<entry
>void enableRepeatPlaylist(bool enable)</entry>
<entry
>Schaltet die Wiederholung der Wiedergabeliste ein/aus.</entry>