Logo Search packages:      
Sourcecode: banshee-community-extensions version File versions  Download package

Banshee::LiveRadio::Plugins::XiphOrgPlugin Class Reference

Inheritance diagram for Banshee::LiveRadio::Plugins::XiphOrgPlugin:

Banshee::LiveRadio::Plugins::LiveRadioBasePlugin Banshee::LiveRadio::Plugins::ILiveRadioPlugin

List of all members.

Detailed Description

LiveRadio plugin to xiph.org internet radio directory.

This plugin downloads the catalog once when the genres are requested and builds a cache for all stations

Definition at line 50 of file XiphOrgPlugin.cs.

Public Member Functions

virtual SafeUri CleanUpUrl (SafeUri url)
 Cleans up any plugin specific data from a track url, such as session data or any other temporary parameters.
virtual void Disable ()
 Method that will disable the plugin. Must set Enabled Property to false and should disable any background tasks.
void ExecuteRequest (LiveRadioRequestType request_type, string query)
 Method capsuling the actual RetrieveRequest worker method with a background worker thread.
virtual void Initialize ()
 Initializes the plugin by retrieving its genre list.
void RaiseErrorReturned (string short_message, string long_message)
 Raises the ErrorReturned event.
void RaiseGenreListLoaded ()
 Raises the GenreListLoaded event.
void RaiseRequestResultRetrieved (LiveRadioRequestType request_type, string query)
 Raises the ResultsRetrieved event.
void RetrieveGenreList ()
 Method capsuling the actual RetrieveGenres worker method with a background worker thread.
override void SaveConfiguration ()
 Saves the configuration for this plugin.
virtual void SetLiveRadioPluginSource (LiveRadioPluginSource source)
 Set the LiveRadioPluginSource of the plugin.
override string ToString ()
 Return a string most likely unique to the plugin, best practice is to return the name of the plugin.
 XiphOrgPlugin ()
 Constructor -- sets configuration entries.

Static Public Attributes

static readonly SchemaEntry
< string > 
static readonly SchemaEntry
< string > 
static readonly SchemaEntry
< string > 

Protected Member Functions

void OnErrorReturned (string short_message, string long_message)
 Method to invoke the ErrorReturned event.
void OnGenreListLoaded ()
 Method to invoke the GenreListLoaded event.
void OnRequestResultRetrieved (LiveRadioRequestType request_type, string query, List< DatabaseTrackInfo > result)
 Method to invoke the RequestResultRetrieved event.
void ParseCatalog (XmlDocument doc)
 Parse the XML catalog and build the sorted genre list and track cache.
override void RetrieveGenres ()
 Retrieve and parse the catalog.
override void RetrieveRequest (LiveRadioRequestType request_type, string query)
 Lookup the query in the cached station track entries.
XmlDocument RetrieveXml (string query)
 Retrieves, reads and returns an XML document from the specified query url using HTTP GET.

Protected Attributes

Dictionary< string, List
< DatabaseTrackInfo > > 
LiveRadioPluginConfigurationWidget configuration_widget
string credentials_password
string credentials_username
List< Genregenres
bool has_login
int http_timeout_seconds
string proxy_url
LiveRadioPluginSource source
bool use_credentials
bool use_proxy


virtual Widget ConfigurationWidget [get]
 Always returns a new standard Configration Widget with all base Properties set.
bool Enabled [get]
 Must truthfully return, if the plugin is enabled. A plugin is enabled, if it has been initialized and not been disabled afterwards.
List< GenreGenres [get]
 Returns the list of genres.
string HttpPassword [get, set]
int HttpTimeout [get, set]
string HttpUsername [get, set]
string IsEnabled [get]
 Should return "Yes" if enabled, and "No" if not enabled.
override string Name [get]
 The name of the plugin -- used as identifier and as label for the source header.
LiveRadioPluginSource PluginSource [get]
 Returns the LiveRadioPluginSource for this plugin.
string ProxyUrl [get, set]
bool UseCredentials [get, set]
bool UseProxy [get, set]
override string Version [get]
 Version of this plugin code.


ErrorReturnedEventHandler ErrorReturned
 Event raised when an Error occurs in a plugin.
GenreListLoadedEventHandler GenreListLoaded
 Event raised when a genre list has been retrieved by the plugin.
RequestResultRetrievedEventHandler RequestResultRetrieved
 Event raised when a query result has been retrieved by the plugin.

Static Private Member Functions

static bool QueryString (DatabaseTrackInfo track, string query)
 Checks if a track's metadata contains the user query.

Private Attributes

const string base_url = "http://dir.xiph.org"
const string catalog_url = "/yp.xml"

The documentation for this class was generated from the following file:

Generated by  Doxygen 1.6.0   Back to index