Javascript-Bibliothek zur Benutzung der laut.fm API.

Achtung: Beta-Software. Bei Problemen bitte Issue öffnen oder im laut.fm Forum melden.

• Sämtliche API-Call gehen über CORS (Cross Origin Resource Sharing). Die Unterschiede zwischen den Internet-Explorern und modernen Browsern gleichen die laut.fm API Tools aus.
• Uhrzeiten werden in Javascript Time-Objekte konvertiert.
• Einzel-Stations-Infos und Song-Infos können automatisch wiederholt abgerufen werden.
• Uhrzeit-Unterschiede zwischen Server und Client werden erkannt und die nötigen Offsets automatisch eingerechnet.
• Keine weiteren Abhängigkeiten

• Der Array-Prototyp wird mit forEach() erweitert. (siehe tutorialspoint.com).
• Zeiten haben humanTimeShort() und humanTimeLong() für Uhrzeiten ala “12:34” und “12:34:56”.

CALLBACK_OR_OPTIONS ist die Funktion, mit der jeweils die Antwort verarbeitet werden soll.

Ab Version 0.3.0: Experimentell kann CALLBACK_OR_OPTIONS auch ein Options-Hash sein:

{container:CONTAINER, template:TEMPLATE, callback:CALLBACK}

CONTAINER und TEMPLATE können Dom-Elemente oder HTML IDs sein. TEMPLATE kann auch ein String als Template sein. Ein CALLBACK ist dann optional.

Eine komplette Einbindung des gerade laufenden Songs per Template inklusive Autoupdate sieht dann z.B. so aus:

<div id="song"></div>

<script type="text/html" id="song_template" charset="utf-8">
  <%= this.title %> - <%= this.artist.name %> (<%= this.started_at.humanTimeLong() %> - <%= this.ends_at.humanTimeLong() %>)
</script>

<script type="text/javascript" charset="utf-8">
  laut.fm.station('maxeinsdreissig').current_song({container:'song', template:'song_template'}, true);
</script>

Im Template gibt es zwei Tags: <%= ... %> (für Ausgabe) und <% ... %> für stille Auswertung. Ein Template für die letzen gespielten Songs sieht also z.B. so aus:

<script type="text/html" id="songs_template" charset="utf-8">
  <% this.forEach(function(song){ %>
    <li><%= song.started_at.humanTimeLong() %> <%= song.title %> - <%= song.artist.name %></li>
  <% }); %>
</script>

laut.fm.server_status(CALLBACK_OR_OPTIONS)

• Demo (API URL)

laut.fm.letters(CALLBACK_OR_OPTIONS)

• Demo (API URL)

laut.fm.genres(CALLBACK_OR_OPTIONS)

• Demo (API URL)

laut.fm.station_names(CALLBACK_OR_OPTIONS)

• Demo (API URL)

laut.fm.listeners(CALLBACK_OR_OPTIONS)

• Demo (API URL)

Alle Stations-Auflistungen funktionieren mit Optionen zur Paginierung:

OPTIONS: limit und/oder offset

laut.fm.stations.all(CALLBACK_OR_OPTIONS[, OPTIONS])

• Demo (API URL)
• Demo mit limit (API URL)
• Demo mit limit und offset (API URL)

laut.fm.stations.letter(LETTER, CALLBACK_OR_OPTIONS[, OPTIONS])

• Demo (API URL)
• Demo mit limit (API URL)
• Demo mit limit und offset (API URL)
• Demo mit Zahl (API URL)

laut.fm.stations.numbers(CALLBACK_OR_OPTIONS[, OPTIONS])

• Demo (API URL)

laut.fm.stations.genre(GENRE, CALLBACK_OR_OPTIONS[, OPTIONS])

GENRE muss eins der Genres von laut.fm.genres() sein.

• Demo (API URL)
• Demo mit limit (API URL)
• Demo mit limit und offset (API URL)

laut.fm.stations.names(NAMES, CALLBACK_OR_OPTIONS)

NAMES müssen Sendernamen sein, als String Komma-separiert oder als Array.

• Demo (API URL)

laut.fm.station('NAME').info(CALLBACK_OR_OPTIONS)

• Demo (API URL)

laut.fm.station(NAME).current_song(CALLBACK_OR_OPTIONS)

• Demo (API URL)
• Demo Template Support und Autoupdate

laut.fm.station(NAME).last_songs(CALLBACK_OR_OPTIONS)

• Demo (API URL)
• Demo Template Support und Autoupdate

laut.fm.station(NAME).next_artists(CALLBACK_OR_OPTIONS)

• Demo (API URL)
• Demo mit Autoupdate

laut.fm.station(NAME).playlists(CALLBACK_OR_OPTIONS)

• Demo (API URL)

laut.fm.station(NAME).schedule(CALLBACK_OR_OPTIONS)

• Demo (API URL)

laut.fm.station(NAME).listeners(CALLBACK_OR_OPTIONS)

• Demo (API URL)

Wird den Funktionen info, current_song, last_songs oder next_artists als zweiter parameter ein true übergeben, wird der API-Call und der zugehörige Callback automatisch wiederholt:

laut.fm.station(NAME).current_song(CALLBACK_OR_OPTIONS, true)

• Demo (API URL)

Wechselt man zum Beispiel die current_song-Anzeige zwischen mehreren Stationen, kann man das Autoupdate wieder canceln:

var watchedStation = laut.fm.station(NAME1).current_song(CALLBACK_OR_OPTIONS, true);
  // ...
watchedStation.unwatch();
var watchedStation = laut.fm.station(NAME2).current_song(CALLBACK_OR_OPTIONS, true);

TODO: Doku

• laut.fm.search.stations(QUERY)

• 2019-02-27 0.10.0 removed player (incl. flowplayer) and JSON polyfill
• 2017-01-27 0.9.1 https support all over.
• 2012-10-23 0.8.0 next_arists support. in production on the official laut.fm website.
• 2012-03-26 0.7.0 added auto updates
• 2012-03-26 0.6.0 all listeners bug fix
• 2011-11-23 0.3.0 added experimental templating support. in production on the laut.de website.
• 2011-11-21 0.2.0 first official release