Class: LastFM::Radio

Inherits:
Object
  • Object
show all
Defined in:
lib/lastfm/radio.rb

Class Method Summary collapse

Class Method Details

.get_playlist(params) ⇒ Object

Fetch new radio content periodically in an XSPF format.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :discovery (Boolean, optional) —

    whether to request last.fm content in discovery mode

  • :rtp (Boolean, optional) —

    whether the user is scrobbling or not during this session (helps content generation)

  • :buylinks (Boolean, optional) —

    whether the response should contain links for purchase/download

  • :speed_multiplier (String, optional) —

    the rate at which to provide the stream (supported multipliers are 1.0 and 2.0)

  • :bitrate (String, optional) —

    what bitrate to stream content at, in kbps (supported bitrates are 64 and 128)

See Also:



13
14
15
16
 
# File 'lib/lastfm/radio.rb', line 13

def get_playlist( params )
  LastFM.requires_authentication
  LastFM.get( "radio.getPlaylist", params, :secure )
end

.search(params) ⇒ Object

Resolve the name of a resource into a station depending on which resource it is most likely to represent.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :name (String, required) —

    the tag or artist name to resolve

See Also:



23
24
25
 
# File 'lib/lastfm/radio.rb', line 23

def search( params )
  LastFM.get( "radio.search", params )
end

.tune(params) ⇒ Object

Tune in to a Last.fm radio station.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :station (String, required) —

    a ‘lastfm://…’ radio url

  • :lang (String, optional) —

    the language to return the station name in, expressed as an ISO 639 alpha-2 code

See Also:



32
33
34
35
 
# File 'lib/lastfm/radio.rb', line 32

def tune( params )
  LastFM.requires_authentication
  LastFM.post( "radio.tune", params )
end