advanced.docbook

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

<chapter id="advanced-features">
<title
>Zaawansowane funkcje programu Amarok</title>


<sect1 id="keybd-shortcuts">
<title
>Skr贸ty klawiszowe</title>

<para
>&amarok-mianownik; tak jak wi臋kszo艣膰 program贸w, wykorzystuje skr贸ty klawiszowe; poni偶ej znajduje si臋 lista tych skr贸t贸w i opis ich dzia艂ania. Aby skonfigurowa膰 skr贸ty globalne, wystarczy klikn膮膰 prawym przyciskiem myszy na oknie odtwarzacza i wybra膰 polecenie <guimenuitem
>Konfiguracja skr贸t贸w globalnych...</guimenuitem
>. Podobnie post臋pujemy chc膮c ustali膰 skr贸ty &amarok-dopelniacz;, tyle, 偶e po klikni臋ciu wybieramy polecenie <guimenuitem
>Konfiguracja skr贸t贸w...</guimenuitem
></para>

<tip
><para
>Mo偶esz przyporz膮dkowa膰 swoim klawiszom multimedialnym skr贸ty &amarok-dopelniacz;. W ten spos贸b zamienisz swoj膮 klawiatur臋 w centrum sterowania programu &amarok-mianownik;.</para
></tip>

<para
>Skr贸ty globalne:</para>

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

<row>
<entry
>Kombinacja klawiszy</entry>
<entry
>Dzia艂anie</entry>
</row>
</thead>
<tbody>

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

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>C</keycap
></keycombo
></entry>
<entry
>Pauza</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
>Nast臋pny utw贸r</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Poprzedni utw贸r</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Podg艂o艣nij</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Przycisz</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Add</keycap
></keycombo
></entry>
<entry
>Wyszukaj do przodu</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>Shift</keycap
><keycap
>KP_Subtract</keycap
></keycombo
></entry>
<entry
>Wyszukaj do ty艂u</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Dodaj media</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>P</keycap
></keycombo
></entry>
<entry
>Prze艂膮cz list臋 odtwarzania</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>O</keycap
></keycombo
></entry>
<entry
>Poka偶 OSD</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Win</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Wycisz</entry>
</row>

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

<para
>Skr贸ty programu &amarok-mianownik;:</para>

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

<row>
<entry
>Kombinacja klawiszy</entry>
<entry
>Dzia艂anie</entry>
</row>
</thead>
<tbody>

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

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>KP_Enter</keycap
></keycombo
></entry>
<entry
>Id藕 do bie偶膮cego utworu</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>D</keycap
></keycombo
></entry>
<entry
>Kolejkuj wybrane utwory</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Q</keycap
></keycombo
></entry>
<entry
>Zako艅cz</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>Shift</keycap
><keycap
>Z</keycap
></keycombo
></entry>
<entry
>Przywr贸膰</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>S</keycap
></keycombo
></entry>
<entry
>Zapisz list臋 odtwarzania jako...</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>A</keycap
></keycombo
></entry>
<entry
>Zaznacz wszystko</entry>
</row>

<row>
<entry
><keycombo
><keycap
>Ctrl</keycap
><keycap
>M</keycap
></keycombo
></entry>
<entry
>Poka偶 pasek menu</entry>
</row>

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

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


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


<para
>Skr贸ty przegl膮darki listy odtwarzania:</para>

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

<row>
<entry
>Kombinacja klawiszy</entry>
<entry
>Dzia艂anie</entry>
</row>
</thead>
<tbody>

<row>
<entry
><keycap
>Spacja</keycap
></entry>
<entry
>Wczytaj list臋 odtwarzania</entry>
</row>

<row>
<entry
><keycap
>F2</keycap
></entry>
<entry
>Zmie艅 nazw臋 listy odtwarzania</entry>
</row>

<row>
<entry
><keycap
>Backspace</keycap
></entry>
<entry
>Usu艅 list臋 odtwarzania</entry>
</row>

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

</sect1>

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

<para
>Interfejs DCOP umo偶liwia 艂atwe zarz膮dzanie programem Amarok, za pomoc膮 samodzielnie stworzonych skrypt贸w.</para>

<para
>Interfejs DCOP programu Amarok posiada wiele standardowych funkcji, wyst臋puj膮cych r贸wnie偶 w innych programach KDE. Sekcja ta jest podzielona na sze艣膰 tabeli i opisuje funkcje interfejsu DCOP odpowiedzialne za kolekcj臋, przegl膮dark臋 kontekstow膮, odtwarzacz, list臋 odtwarzania, przegl膮dark臋 list odtwarzania oraz skrypty. Przyk艂adowe wywo艂anie funkcji dcop <quote
>pause</quote
> b臋dzie mia艂o nast臋puj膮c膮 posta膰:</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
>Funkcja DCOP</entry>
<entry
>Dzia艂anie</entry>
</row>
</thead>
<tbody>

<row>
<entry
>int totalAlbums()</entry>
<entry
>Zwraca ca艂kowit膮 liczb臋 album贸w w kolekcji.</entry>
</row>

<row>
<entry
>int totalArtists()</entry>
<entry
>Zwraca ca艂kowit膮 liczb臋 wykonawc贸w w kolekcji.</entry>
</row>

<row>
<entry
>int totalCompilations()</entry>
<entry
>Zwraca ca艂kowit膮 liczb臋 kompilacji w kolekcji.</entry>
</row>

<row>
<entry
>int totalGenres()</entry>
<entry
>Zwraca ca艂kowit膮 liczb臋 gatunk贸w w kolekcji.</entry>
</row>

<row>
<entry
>int totalTracks()</entry>
<entry
>Zwraca ca艂kowit膮 liczb臋 utwor贸w w kolekcji.</entry>
</row>

<row>
<entry
>QString query( QString sql)</entry>
<entry
>Zapytuje baz臋 danych poprzez SQL</entry>
</row>

<row>
<entry
>QStringList similarArtists( int wykonawcy )</entry>
<entry
>Zwraca wykonawc贸w zbli偶onych do wykonawcy bie偶膮cego utworu; ograniczone do wykonawc贸w.</entry>
</row>

<row>
<entry
>void migrateFile( QString staryURL, QString nowyURL )</entry>
<entry
>Przenosi plik do kolekcji, pozostawiaj膮c statystyki niezmienione.</entry>
</row>

<row>
<entry
>void scanCollection()</entry>
<entry
>Skanuje kolekcj臋.</entry>
</row>

<row>
<entry
>void scanCollectionChanges()</entry>
<entry
>Wyszukuje w kolekcji jedynie zmiany.</entry>
</row>


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

</sect2>

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

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

<row>
<entry
>Funkcja DCOP</entry>
<entry
>Dzia艂anie</entry>
</row>
</thead>
<tbody>

<row>
<entry
>void showCurrentTrack()</entry>
<entry
>Wy艣wietla bie偶膮cy utw贸r w przegl膮darce kontekstowej.</entry>
</row>

<row>
<entry
>void showLyrics()</entry>
<entry
>Wy艣wietla kart臋 tekst贸w w przegl膮darce kontekstowej.</entry>
</row>

<row>
<entry
>void showWiki()</entry>
<entry
>Wy艣wietla kart臋 Wikipedii w przegl膮darce kontekstowej.</entry>
</row>

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

</sect2>

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

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

<row>
<entry
>Funkcja DCOP</entry>
<entry
>Dzia艂anie</entry>
</row>
</thead>
<tbody>

<row>
<entry
>bool dynamicModeStatus()</entry>
<entry
>Zwraca status trybu dynamicznego.</entry>
</row>

<row>
<entry
>bool equalizerEnabled()</entry>
<entry
>Zwraca status equalizera.</entry>
</row>

<row>
<entry
>bool isPlaying()</entry>
<entry
>Zwraca warto艣膰 prawda, je艣li co艣 jest odtwarzane.</entry>
</row>

<row>
<entry
>bool randomModeStatusf()</entry>
<entry
>Zwraca status trybu losowego.</entry>
</row>

<row>
<entry
>bool repeatPlaylistStatus()</entry>
<entry
>Zwraca status trybu powtarzania listy odtwarzania.</entry>
</row>

<row>
<entry
>bool repeatTrackStatus()</entry>
<entry
>Zwraca status trybu powtarzania utworu.</entry>
</row>

<row>
<entry
>int getVolume()</entry>
<entry
>Zwraca si艂臋 g艂osu z przedzia艂u 0-100%.</entry>
</row>

<row>
<entry
>int sampleRate()</entry>
<entry
>Zwraca cz臋stotliwo艣膰 pr贸bkowania aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>int score()</entry>
<entry
>Zwraca ocen臋 aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>int status()</entry>
<entry
>Zwraca status odtwarzania: 0 - stop, 1 - pauza, 2 - odtwarzanie.</entry>
</row>

<row>
<entry
>int trackCurrentTime()</entry>
<entry
>Zwraca bie偶膮c膮 pozycj臋 odtwarzania wyra偶on膮 w sekundach.</entry>
</row>

<row>
<entry
>int trackPlayCounter()</entry>
<entry
>Zwraca liczb臋 odtworze艅 bie偶膮cego utworu.</entry>
</row>

<row>
<entry
>int trackTotalTime()</entry>
<entry
>Zwraca d艂ugo艣膰 utworu w sekundach.</entry>
</row>

<row>
<entry
>QString album()</entry>
<entry
>Zwraca album, z kt贸rego pochodzi aktualnie odtwarzany utw贸r.</entry>
</row>

<row>
<entry
>QString artist()</entry>
<entry
>Zwraca wykonawc臋 aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>QString bitrate()</entry>
<entry
>Zwraca 艣redni膮 bitowa aktualnie odtwarzanego utworu (XX kbps).</entry>
</row>

<row>
<entry
>QString comment()</entry>
<entry
>Zwraca komentarz na temat aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>QString coverImage()</entry>
<entry
>Zwraca kodowany adres URL do obrazu ok艂adki aktualnie odtwarzanego utworu. </entry>
</row>

<row>
<entry
>QString currentTime()</entry>
<entry
>Zwraca pozycj臋 aktualnie odtwarzanego utworu (format [h:]mm:ss).</entry>
</row>

<row>
<entry
>QString encodedURL()</entry>
<entry
>Zwraca kodowany adres URL aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>QString engine()</entry>
<entry
>Zwraca informacj臋 o bie偶膮cym silniku audio.</entry>
</row>

<row>
<entry
>QString genre()</entry>
<entry
>Zwraca informacj臋 o gatunku muzyki, do kt贸rego nale偶y aktualnie odtwarzany utw贸r.</entry>
</row>

<row>
<entry
>QString lyrics()</entry>
<entry
>Zwraca tekst aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>QString lyricsByPath( QString 艣cie偶ka )</entry>
<entry
>Zwraca tekst utworu okre艣lony 艣cie偶k膮.</entry>
</row>

<row>
<entry
>QString nowPlaying()</entry>
<entry
>Nazwa medium w trakcie odtwarzania.</entry>
</row>

<row>
<entry
>QString path()</entry>
<entry
>Zwraca niekodowan膮 艣cie偶k臋 aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>QString setContextStyle( QString )</entry>
<entry
>Ustala styl CCS dla przegl膮darki kontekstowej.</entry>
</row>

<row>
<entry
>QString title()</entry>
<entry
>Zwraca tytu艂 aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>QString totalTime()</entry>
<entry
>Zwraca ca艂kowit膮 d艂ugo艣膰 aktualnie odtwarzanego utworu (format [h:]mm:ss).</entry>
</row>

<row>
<entry
>QString track()</entry>
<entry
>Zwraca numer utworu.</entry>
</row>

<row>
<entry
>QString type()</entry>
<entry
>Zwraca typ pliku.</entry>
</row>

<row>
<entry
>QString year()</entry>
<entry
>Zwraca rok aktualnie odtwarzanego utworu.</entry>
</row>

<row>
<entry
>void configEqualizer()</entry>
<entry
>Prze艂膮cza okno konfiguracyjne equalizera.</entry>
</row>

<row>
<entry
>void enableDynamicMode(bool w艂膮czony)</entry>
<entry
>W艂膮cza lub wy艂膮cza tryb dynamiczny.</entry>
</row>

<row>
<entry
>void enableOSD(bool w艂膮czony)</entry>
<entry
>W艂膮cza lub wy艂膮cza wy艣wietlanie OSD.</entry>
</row>