de.umass.lastfm
Class Radio

java.lang.Object
  de.umass.lastfm.Radio

public class Radio
extends java.lang.Object

Provides access to the Last.fm radio streaming service.
Note that you have to be a subscriber (or have a special API key) to use this API. Official documentation can be found here http://www.last.fm/api/radio

Author:

Janni Kovacs

Nested Class Summary

static class

Radio.RadioStation

Method Summary

Playlist	getPlaylist() Fetches a new radio playlist.
Playlist	getPlaylist(boolean discovery, boolean rtp) Fetches a new radio playlist.
java.lang.String	getStationName()
java.lang.String	getStationUrl()
java.lang.String	getType()
int	playlistExpiresIn() Returns the playlist expiration value for the last playlist fetchet, or -1 if no playlist has been fetched yet.
boolean	supportsDiscovery()
static Radio	tune(Radio.RadioStation station, java.util.Locale locale, Session session) Tune in to a Last.fm radio station.
static Radio	tune(Radio.RadioStation station, Session session) Tune in to a Last.fm radio station.
static Radio	tune(java.lang.String station, java.util.Locale locale, Session session) Tune in to a Last.fm radio station.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getType

public java.lang.String getType()

getStationName

public java.lang.String getStationName()

getStationUrl

public java.lang.String getStationUrl()

supportsDiscovery

public boolean supportsDiscovery()

playlistExpiresIn

public int playlistExpiresIn()

Returns the playlist expiration value for the last playlist fetchet, or -1 if no playlist has been fetched yet.

Returns:

playlist expiration in seconds

tune

public static Radio tune(Radio.RadioStation station,
                         Session session)

Tune in to a Last.fm radio station.

Parameters:

station - An instance of Radio.RadioStation

session - A Session instance

Returns:

a Radio instance

tune

public static Radio tune(Radio.RadioStation station,
                         java.util.Locale locale,
                         Session session)

Tune in to a Last.fm radio station.

Parameters:

station - An instance of Radio.RadioStation

locale - The language you want the radio's name in

session - A Session instance

Returns:

a Radio instance

tune

public static Radio tune(java.lang.String station,
                         java.util.Locale locale,
                         Session session)

Tune in to a Last.fm radio station.

Parameters:

station - A lastfm radio URL

locale - The language you want the radio's name in

session - A Session instance

Returns:

a Radio instance

getPlaylist

public Playlist getPlaylist()

Fetches a new radio playlist.

Returns:

a new Playlist

getPlaylist

public Playlist getPlaylist(boolean discovery,
                            boolean rtp)

Fetches a new radio playlist.

Parameters:

discovery - Whether to request last.fm content with discovery mode switched on

rtp - Whether the user is scrobbling or not during this radio session (helps content generation)

Returns:

a new Playlist