repo_zf1/documentation/manual/de/module_specs/Zend_Service_Audioscrobbler.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 17133 -->
<!-- Reviewed: no -->
<sect1 id="zend.service.audioscrobbler">

    <title>Zend_Service_Audioscrobbler</title>

    <sect2 id="zend.service.audioscrobbler.introduction">

        <title>Einführung</title>

        <para>
            <classname>Zend_Service_Audioscrobbler</classname> ist eine einfache API für die
            Verwendung des Audioscrobbler REST Web Services. Der Audioscrobbler Web Service bietet
            Zugang zu seinen Datenbanken von Benutzern, Artisten, Albums, Lieder, tags, Gruppen und
            Foren. Die Methoden der <classname>Zend_Service_Audioscrobbler</classname> Klasse
            beginnt mit einem dieser Bezeichner. Der Syntax und der Namensraum des Audioscrobbler
            Web Services sind in <classname>Zend_Service_Audioscrobbler</classname> gespiegelt. Für
            weitere Informationen über das Audioscrobbler REST Web Service, siehe die <ulink
                url="http://www.audioscrobbler.net/data/webservices/">Audioscrobbler Web Service
                Seite</ulink>.
        </para>

    </sect2>

    <sect2 id="zend.service.audioscrobbler.users">

        <title>Benutzer</title>

        <para>
            Um Informationen über einen bestimmten Benutzer zu erhalten, wird zuerst die
            <methodname>setUser()</methodname> Methode verwendet um den Benutzer zu selektieren für
            den Daten empfangen werden sollen. <classname>Zend_Service_Audioscrobbler</classname>
            bietet verschiedene Methoden für das empfangen von Daten eines einzelnen Benutzers:
            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>userGetProfileInformation()</methodname>: Gibt ein SimpleXML
                        Objekt zurück das die aktuellen Profilinformationen des Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetTopArtists()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der aktuell am meisten gelisteten Artisten des
                        Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetTopAlbums()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der aktuell am meisten gelisteten Alben des Benutzer
                        enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetTopTracks()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das das aktuell am meisten gelistete Lied des Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetTopTags()</methodname>: Gibt ein SimpleXML Objekt zurück
                        das eine Liste der Tags enthält die am meisten vom aktuellen Benutzer
                        zugeordnet wurden.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetTopTagsForArtist()</methodname>: Erfordert das ein Artist
                        über <methodname>setArtist()</methodname> gesetzt wurde. Gibt ein SimpleXML
                        Objekt zurück das die Tags enthält die am meisten dem aktuellen Artisten
                        durch den aktuellen Benutzer zugeordnet worden sind.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetTopTagsForAlbum()</methodname>: Erfordert das ein Album
                        über <methodname>setAlbum()</methodname> gesetzt wurde. Gibt ein SimpleXML
                        Objekt zurück das die Tags enthält die am meisten dem aktuellen Album durch
                        den aktuellen Benutzer zugeordnet worden sind.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetTopTagsForTrack()</methodname>: Erfordert das ein Lied
                        über <methodname>setTrack()</methodname> gesetzt wurde. Gibt ein SimpleXML
                        Objekt zurück das die Tags enthält die am meisten dem aktuellen Lied vom
                        aktuellen Benutzer zugeordnet worden sind.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetFriends()</methodname>: Gibt ein SimpleXML Objekt zurück
                        das die Benutzernamen der Freunde des aktuellen Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetNeighbours()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das die Benutzernamen der Personen enthält die ähnliche
                        Unterhaltungs-Gewohnheiten wie der aktuelle Benutzer haben.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetRecentTracks()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der 10 zuletzt gespielten Lieder des aktuellen
                        Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetRecentBannedTracks()</methodname>: Gibt ein SimpleXML
                        Objekt zurück das eine Liste der 10 zuletzt verbannten Lieder des aktuellen
                        Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetRecentLovedTracks()</methodname>: Gibt ein SimpleXML
                        Objekt zurück das eine Liste der 10 zuletzt geliebten Lieder des aktuellen
                        Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetRecentJournals()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der letzten Journaleintröge des aktuellen Benutzers
                        enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetWeeklyChartList()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der Wochen enthält für die ein Wochenchart des
                        aktuellen Benutzers existiert.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetRecentWeeklyArtistChart()</methodname>: Gibt ein
                        SimpleXML Objekt zurück das die letzten wöchentlichen Artistencharts des
                        aktuellen Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetRecentWeeklyAlbumChart()</methodname>: Gibt ein SimpleXML
                        Objekt zurück das die letzten wöchentlichen Albumcharts des aktuellen
                        Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetRecentWeeklyTrackChart()</methodname>: Gibt ein SimpleXML
                        Objekt zurück das die letzten wöchentlichen Liedercharts des aktuellen
                        Benutzers enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetPreviousWeeklyArtistChart($fromDate,
                            $toDate)</methodname>: Gibt ein SimpleXML Objekt zurück das die
                        wöchentliche Artistencharts von <code>$fromDate</code> bis
                        <code>$toDate</code> für den aktuellen Benutzer enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetPreviousWeeklyAlbumChart($fromDate,
                            $toDate)</methodname>: Gibt ein SimpleXML Objekt zurück das die
                        wöchentlichen Albumcharts von <code>$fromDate</code> bis
                        <code>$toDate</code> für den aktuellen Benutzer enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>userGetPreviousWeeklyTrackChart($fromDate,
                            $toDate)</methodname>: Gibt ein SimpleXML Objekt zurück das die
                        wöchentlichen Liedercharts von <code>$fromDate</code> bis
                        <code>$toDate</code> für den aktuellen Benutzer enthält.
                    </para>
                </listitem>
            </itemizedlist>
        </para>

        <example id="zend.service.audioscrobbler.users.example.profile_information">

            <title>Informationen von Benutzerprofilen erhalten</title>

            <para>
                In diesem Beispiel werden die <methodname>setUser()</methodname> und
                <methodname>userGetProfileInformation()</methodname> Methoden verwendet um
                Informationen über ein spezielles Benutzerprofil zu erhalten:
            </para>

            <programlisting language="php"><![CDATA[
$as = new Zend_Service_Audioscrobbler();
// Den Benutzer setzen dessen Profilinformationen man empfangen will
$as->setUser('BigDaddy71');
// Informationen von BigDaddy71's Profil erhalten
$profileInfo = $as->userGetProfileInformation();
// Einige von Ihnen darstellen
print "Informationen für $profileInfo->realname können unter "
    . "$profileInfo->url gefunden werden";
]]></programlisting>

        </example>

        <example id="zend.service.audioscrobbler.users.example.weekly_artist_chart">

            <title>Die wöchentlichen Artistencharts eines Benutzers erhalten</title>

            <programlisting language="php"><![CDATA[
$as = new Zend_Service_Audioscrobbler();
// Den Benutzer setzen dessen wöchentliche Artistencharts man empfangen will
$as->setUser('lo_fye');
// Eine Liste von vorherigen Wochen erhalten in denen Chartdaten vorhanden sind
$weeks = $as->userGetWeeklyChartList();
if (count($weeks) < 1) {
    echo 'Keine Daten vorhanden';
}
sort($weeks); // Die Liste der Wochen sortieren

$as->setFromDate($weeks[0]); // Das Startdatum setzen
$as->setToDate($weeks[0]); // Das Enddatum setzen

$previousWeeklyArtists = $as->userGetPreviousWeeklyArtistChart();

echo 'Artisten Chart für Woche '
   . date('Y-m-d h:i:s', $as->from_date)
   . '<br />';

foreach ($previousWeeklyArtists as $artist) {
    // Artistennamen mit Links zu Ihrem Profil darstellen
    print '<a href="' . $artist->url . '">' . $artist->name . '</a><br />';
}
]]></programlisting>

        </example>

    </sect2>

    <sect2 id="zend.service.audioscrobbler.artists">

        <title>Artisten</title>

        <para>
            <classname>Zend_Service_Audioscrobbler</classname> bietet verschiedene Methoden um Daten
            über einen speziellen Artisten zu empfangen, der über die
            <methodname>setArtist()</methodname> Methode spezifiziert wurde:
            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>artistGetRelatedArtists()</methodname>: Gibt ein SimpleXML
                        Objekt zurück das eine Liste von Artisten enthält die dem aktuellen Artisten
                        ähnlich sind.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>artistGetTopFans()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste von Benutzern enthält die den aktuellen Artisten am
                        meisten hören.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>artistGetTopTracks()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der am meisten gewählten Lieder des aktuellen Artisten
                        enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>artistGetTopAlbums()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der aktuell am meisten gewählten Alben des aktuellen
                        Artisten enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>artistGetTopTags()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der Tags enthält die dem aktuellen Artisten am meisten
                        zugeordnet werden.
                    </para>
                </listitem>
            </itemizedlist>
        </para>

        <example id="zend.service.audioscrobbler.artists.example.related_artists">

            <title>Ähnliche Artisten erhalten</title>

            <programlisting language="php"><![CDATA[
$as = new Zend_Service_Audioscrobbler();
// Den Artisten setzen für den man ähnliche Artisten bekommen will
$as->setArtist('LCD Soundsystem');
// Ähnliche Artisten erhalten
$relatedArtists = $as->artistGetRelatedArtists();
foreach ($relatedArtists as $artist) {
    // Die ähnlichen Artisten anzeigen
    print '<a href="' . $artist->url . '">' . $artist->name . '</a><br />';
}
]]></programlisting>

        </example>

    </sect2>

    <sect2 id="zend.service.audioscrobbler.tracks">

        <title>Lieder</title>

        <para>
            <classname>Zend_Service_Audioscrobbler</classname> bietet zwei Methoden für das
            Empfangen von Daten für ein einzelnes Lied, das über die
            <methodname>setTrack()</methodname> Methode spezifiziert wurde:
            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>trackGetTopFans()</methodname>: Gibt ein SimpleXML Objekt zurück
                        das eine Liste mit den Benutzern enthält die das aktuelle Lied am meisten
                        gehört haben.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>trackGetTopTags()</methodname>: Gibt ein SimpleXML Objekt zurück
                        das eine Liste der Tags enthält die dem aktuellen Tag am meisten hinzugefügt
                        werden.
                    </para>
                </listitem>
            </itemizedlist>
        </para>

    </sect2>

    <sect2 id="zend.service.audioscrobbler.tags">

        <title>Tags</title>

        <para>
            <classname>Zend_Service_Audioscrobbler</classname> bietet verschiedene Methoden für das
            Empfangen von Daten die einem einzelnen Tag zugeordnet sind, welches über die
            <methodname>setTag()</methodname> Methode zugeordnet werden:
            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>tagGetOverallTopTags()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste von Tags enthält die am meisten in Audioscrobbler
                        verwendet werden.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>tagGetTopArtists()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste von Artisten enthält denen das aktuelle Tag am meisten
                        zugeordnet wurden.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>tagGetTopAlbums()</methodname>: Gibt ein SimpleXML Objekt zurück
                        das eine Liste von Alben enthält die dem aktuellen Tag am meisten zugeordnet
                        wurden.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>tagGetTopTracks()</methodname>: Gibt ein SimpleXML Objekt zurück
                        das eine Liste von Liedern enthält die dem aktuellen Tag am meisten
                        zugeordnet wurden.
                    </para>
                </listitem>
            </itemizedlist>
        </para>

    </sect2>

    <sect2 id="zend.service.audioscrobbler.groups">

        <title>Gruppen</title>

        <para>
            <classname>Zend_Service_Audioscrobbler</classname> bietet verschiedene Methoden um Daten
            zu erhalten die einer speziellen Gruppe gehören, die über die
            <methodname>setGroup()</methodname> Methode zugeordnet wurde:
            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>groupGetRecentJournals()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der letzten Journalbeiträge der Benutzer der aktuellen
                        Gruppe enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>groupGetWeeklyChart()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der Wochen enthält für die ein wöchentliches Chart der
                        aktuellen Gruppe existiert.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>groupGetRecentWeeklyArtistChart()</methodname>: Gibt ein
                        SimpleXML Objekt zurück das die letzten wöchentlichen Artistencharts der
                        aktuellen Gruppe enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>groupGetRecentWeeklyAlbumChart()</methodname>: Gibt ein
                        SimpleXML Objekt zurück das die letzten wöchentlichen Albumcharts der
                        aktuellen Gruppe enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>groupGetRecentWeeklyTrackChart()</methodname>: Gibt ein
                        SimpleXML Objekt zurück das die letzten wöchentlichen Liedercharts der
                        aktuellen Gruppe enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>groupGetPreviousWeeklyArtistChart($fromDate,
                            $toDate)</methodname>: Erfordert <methodname>setFromDate()</methodname>
                        und <methodname>setToDate()</methodname>. Gibt ein SimpleXML Objekt zurück
                        das die wöchentlichen Artistencharts vom aktuellen fromDate bis zum
                        aktuellen toDate der aktuellen Gruppe enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>groupGetPreviousWeeklyAlbumChart($fromDate,
                            $toDate)</methodname>: Erfordert <methodname>setFromDate()</methodname>
                        und <methodname>setToDate()</methodname>. Gibt ein SimpleXML Objekt zurück
                        das die wöchentlichen Albumcharts vom aktuellen fromDate bis zum aktuellen
                        toDate der aktuellen Gruppe enthält.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <methodname>groupGetPreviousWeeklyTrackChart($fromDate,
                            $toDate)</methodname>: Gibt ein SimpleXML Objekt zurück das die
                        wöchentlichen Liedercharts vom aktuellen fromDate bis zum aktuellen toDate
                        für die aktuelle Gruppe enthält.
                    </para>
                </listitem>
            </itemizedlist>
        </para>

    </sect2>

    <sect2 id="zend.service.audioscrobbler.forums">

        <title>Foren</title>

        <para>
            <classname>Zend_Service_Audioscrobbler</classname> bietet eine Methode für das Empfangen
            von Daten eines einzelnen Forums, das über die <methodname>setForum()</methodname>
            Methode spezifiziert wurde:
            <itemizedlist>
                <listitem>
                    <para>
                        <methodname>forumGetRecentPosts()</methodname>: Gibt ein SimpleXML Objekt
                        zurück das eine Liste der letzten Beiträge im aktuellen Forum enthält.
                    </para>
                </listitem>
            </itemizedlist>
        </para>

    </sect2>

</sect1>
<!--
vim:se ts=4 sw=4 et:
-->