AddRadioStation - Develop Apps

This function is used to add a radio station to Online Radio Player component located on the toolbar.

AddRadioStation(name,

url,

ContantType,

mediaType,

uniqueComponentID)

Parameter	Description	Range	Type
name	The radio station's name	not null or empty	string
url	The URL of the radio station feed	not null or empty	string
ContantType	The type of player: 1. MP- The radio station is Media Player 2. REAL- The radio station is Real Player	not null or empty	string
mediaType	The type of media: 1. STREAM- The URL is a link to a live stream 2. XML_FEED- The URL is a link to an XML feed (e.g. a podcast)	not null or empty	string
uniqueComponentID	The station's unique ID. If the parameter is left empty, a unique ID is automatically created	not null or empty	string

An object that contains the following fields:

Field Name	Description	Type
returnValue	Indicates whether the operation was successful. True - The function adds a radio station to the toolbar successfully False - The radio station is not added to the toolbar. Check the value of the errorCode to determine the specific reason for the function failure	boolean
errorCode	Specific error code. See Error Code Table for additional information.	int

*Notice: API methods must be invoked after the web page has triggered the "onload" event.

The following example contains two buttons. Clicking on the first button will insert a radio station item to the Conduit demo toolbar; clicking on the second button will insert a podcast station to the Conduit demo toolbar.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head>    <title>Conduit Toolbar API - AddRadioStation</title> <!-- Conduit API script declaration --> <script language="javascript" type="text/javascript" src="http://api.conduit.com/ToolbarApi.js"></script>  <script language="javascript" type="text/javascript">
    function AddRadioStationToToolbar(isRadioStation){
        var resultDiv = document.getElementById('result');
        resultDiv.innerHTML = "";
        var oToolbar = new TPI.Toolbar("CT2275160");
        var oResult;
        if(isRadioStation){
            oResult = oToolbar.AddRadioStation("My Radio Station", "http://www.1club.fm/go/asx.aspx?station=classcountry","MP","STREAM");                                                                                                  
        }
        else{
            oResult = oToolbar.AddRadioStation("My Radio Podcast", "http://bernd-schmitz.net/podcast/podcast.php","MP","XML_FEED");                        
        }
        
        var type = isRadioStation ? "Radio" : "Podcast";
        // Check the results
        if(oResult.returnValue){
            if(oResult.errorCode == 1){
                resultDiv.innerHTML += type + " station was added to toolbar id: CT2275160<br/>";                                                    
            }
        }
        else{                                     
            if(oResult.errorCode == 7){
                resultDiv.innerHTML += type + " station already exist on toolbar id: CT2275160<br/>";
            }
            else{
                resultDiv.innerHTML += "Failed to add " + type + " station to toolbar id: CT2275160, ErrorCode = " + oResult.errorCode + "<br/>";               
            }
        }
    }
</script>  </head> <body>  <div><input type="button" value="Add Radio Station" onclick="AddRadioStationToToolbar(true)" /></div> <div><input type="button" value="Add Podcast" onclick="AddRadioStationToToolbar(false)" /></div> <br /> <div id="result"></div> </body> </html>

See code usage
See live demo usage
Live example