On This Page
Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source
Page
Library
Module
Module type
Parameter
Class
Class type
Source
package lastfm
Module Lastfm_generic.Radio_genericSource
Generic implementation of the Radio API, independant * from the Http request.
API for using lastfm radios
No protocol documentation avaible for now...
Parameters
Signature
Types
Type for track datas
A track is a list of "field","value" metadatas and an uri
Various errors
Basic API
get uri performs whole process and outputs a list of metadatas,uri from given lastfm uri.
This function cannot handle well multiple anonymous requests.
If you plan to play simultaneously several anonymous radios, you better use the advanced API to keep track of every opened session.
Advanced API
Using this API you shall call:
- parse: get required parts of the uri
- init: initiate a session
- adjust: adjust station
Then you can use any of the following:
- playlist: return the raw xml content of the playlist
- tracks : returns the parsed playlist.
After each of those calls, you shall use *only* one of the songs from the playlist.
The module will cache session informations and avoid redundant requests, so you might always call init and adjust.
If you call playlist, and anything went bad, you have to call clear to remove cached data about this session.
In any case you may also give another try, in case of inconsistent cached session data. See get source for details
parse uri parse the given lastfm:// uri * * returns login,station,options
init login initiate lastfm session * * Returns the session id
adjust id station adjusts lastfm station * for given session ID * * Returns a list of (variable,value) as returned * by the server. Contains settings for adjusted * radio.
playlist id returns the raw xml content of the playlist
tracks id * returns a list of metadatas,uri
clear id closes and clear all * informations about the given session ID
On This Page