de.umass.lastfm
Class Radio

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

public class Radio
extends 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.
 String getStationName()
           
 String getStationUrl()
           
 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, 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(String station, 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 String getType()

getStationName

public String getStationName()

getStationUrl

public 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,
                         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(String station,
                         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