Promotional Badges
From Winamp Help
(Difference between revisions)
Ashokbania (Talk | contribs) (Created page with 'Category:Winamp =Winamp Launch Gateway= This wiki page will be used to provide insight into the web-based Winamp client launching service (Winamp Launch Gateway) located at …') |
Ashokbania (Talk | contribs) |
||
| (12 intermediate revisions not shown) | |||
| Line 1: | Line 1: | ||
[[Category:Winamp]] | [[Category:Winamp]] | ||
| - | = | + | =Launch URLs= |
| - | This wiki page will be used to provide insight into the web-based Winamp client launching service (Winamp Launch Gateway) located at http://launch.winamp.com/ and high level info on its required browser plug-ins. | + | This wiki page will be used to provide insight into the web-based Winamp client launching service(Winamp Launch Gateway) located at http://launch.winamp.com/ and high level info on its required browser plug-ins. |
| - | + | ||
| - | + | ||
| + | The Winamp Launch Gateway or Winamp Launch URL (''http://launch.winamp.com/'') is a service we've created for third parties or any user really who wish to easily open their online service (or other Winamp plug-ins/features) inside the Winamp client from a link within a web page/email/etc. | ||
==Overview== | ==Overview== | ||
| - | + | You can now promote Online Services, Podcasts and Now Playing pages which rests inside the client right from their webpages. Clicking on these simple Launch URLs in your webpage, a user can: | |
| - | + | *Subscribe – allows user to subscribe to podcast & launches Podcast tab within Winamp Client | |
| + | *Add – this badge allows the user to add content to the Winamp client (e.g. Winamp Online Service: Tour Tracker, Metro Lyrics, 7Digital store, Moviefone HD Trailers, etc.) | ||
| + | *Now Playing in Client – this launches a specific artist page within the Winamp client including deep-linking to sub-tabs such as - | ||
| + | **Biography – band bio/history powered by AMG | ||
| + | **Songs – allows for playback of any available songs | ||
| + | **Photos – powered by AOL Music | ||
| + | **Videos – powered by Truveo | ||
| + | **Radio – powered by SHOUTcast | ||
| + | **News – All News, AOL Music News, & Blog | ||
| + | The simplest example of the launcher is to just open up your web browser (as long as it's either Firefox or IE) and visit: | ||
'''http://launch.winamp.com/''' | '''http://launch.winamp.com/''' | ||
| + | The page first does a quick check to ensure that the proper browser plug-in/dll is installed and that the user is using Winamp version 5.57 or above before it attempts to launch Winamp. Additionally, thanks to two browser plug-ins (one for Firefox, one for Internet Explorer) there is a way to presence check Winamp before attempting to load such a URL. | ||
| - | + | ==Anatomy of an Example Request== | |
| - | The | + | The diagram below explains the specifics of making a Winamp Launch Gateway request. The first and second parameters are optional. |
| - | + | [[File:Winamp_launch_gateway_urls.gif]] | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ==Test Bed== | |
| + | Check out how these URLs work. | ||
| + | *Subscribe to Podcasts: | ||
| + | ** Podcasts Root - http://launch.winamp.com/Podcast/ | ||
| + | ** Subscribe to the Podcast (http://rock-of-ages.podOmatic.com/rss2.xml) in Winamp - http://launch.winamp.com/Podcast/Subscribe?url=http://rock-of-ages.podOmatic.com/rss2.xml | ||
| - | = | + | *Add Online Services: |
| + | **Online Services Root - http://launch.winamp.com/Online%20Services | ||
| + | **Online Services Details Page - http://launch.winamp.com/Online%20Services/go?id=222150 | ||
| - | + | You can pick up the service id (222150 in the example mentioned above) from the Online Services URL in Winamp.com. See screenshot | |
| + | [[File:Online Service URL.JPG]] | ||
| + | *Play in Now Playing: | ||
| + | **Now Playing Root - http://launch.winamp.com/Now%20Playing | ||
| + | **Now Playing Artist Page - http://launch.winamp.com/Now%20Playing/artist/?artistName=Alien%20Ant%20Farm (Notice the %20 in the name. The %20 is nothing but space between words in an artist name) | ||
| - | + | *Play a SHOUTcast station: | |
| + | By placing a promo badge on your site, you can directly launch and open the Winamp player to start playing your station. | ||
| + | ** Launch URL structure for SHOUTcast - http://launch.winamp.com/sc/<station ip>:<port> | ||
| + | ** Example of launch URL for a SHOUTcast station - http://launch.winamp.com/sc/74.63.47.82:8090 | ||
| - | + | ==Winamp Launch URL Promo Badges== | |
| - | + | You can use the following badges or buttons for the launch URLs we mentioned above. Please download the hi-res from http://www.winamp.com/promote. | |
| - | + | ||
| + | *Subscribing to a Podcast | ||
| + | [[File:Feed_46_17.jpg]] | ||
| + | [[File:Subscribe 91 18.jpg]] | ||
| + | [[File:DefaultSubscribe.jpg]] | ||
| - | + | *Adding an Online Service | |
| + | [[File:Add 46 17.jpg]] | ||
| + | [[File:Add 91 18.jpg]] | ||
| + | [[File:Default add.jpg]] | ||
| - | + | *Playing in Now Playing | |
| + | [[File:Play 46 17.jpg]] | ||
| + | [[File:Play 91 18.jpg]] | ||
| + | [[File:DefaultPlay.jpg]] | ||
| - | + | ==Winamp Client Requirements== | |
| + | Version 5.57 and up | ||
| - | == | + | ==Compatible Winamp Plug-ins== |
| - | + | * Online Services | |
| + | * Now Playing | ||
| + | * Podcast Directory | ||
| + | |||
| + | ==Example Fail Case== | ||
| - | + | If you have an older version of Winamp and you attempt to use the Winamp Launch URLs in your website, a user to your website will see the following screenshot. You will need to follow the given instructions in the screenshot below. | |
Screenshot: | Screenshot: | ||
| Line 60: | Line 92: | ||
==Caveats== | ==Caveats== | ||
| - | * | + | * When attempting to launch, if Winamp is already open (hidden behind other windows, for example) or minimized, it will not steal focus. |
* If the user doesn't have Firefox installed at the time of installing Winamp 5.57, then later decides to install Firefox and use the Winamp Launch Gateway, the presence check plug-in will fail because it was not installed (due to the absence of Firefox at install time) and there is currently no way for them to manually install it other than re-installing Winamp. | * If the user doesn't have Firefox installed at the time of installing Winamp 5.57, then later decides to install Firefox and use the Winamp Launch Gateway, the presence check plug-in will fail because it was not installed (due to the absence of Firefox at install time) and there is currently no way for them to manually install it other than re-installing Winamp. | ||
| - | * At this point it is not known what other browsers | + | * At this point it is not known what other browsers, if any, will launch Winamp correctly besides Internet Explorer and Firefox. |
Current revision as of 10:53, 1 June 2010
Contents |
Launch URLs
This wiki page will be used to provide insight into the web-based Winamp client launching service(Winamp Launch Gateway) located at http://launch.winamp.com/ and high level info on its required browser plug-ins.
The Winamp Launch Gateway or Winamp Launch URL (http://launch.winamp.com/) is a service we've created for third parties or any user really who wish to easily open their online service (or other Winamp plug-ins/features) inside the Winamp client from a link within a web page/email/etc.
Overview
You can now promote Online Services, Podcasts and Now Playing pages which rests inside the client right from their webpages. Clicking on these simple Launch URLs in your webpage, a user can:
- Subscribe – allows user to subscribe to podcast & launches Podcast tab within Winamp Client
- Add – this badge allows the user to add content to the Winamp client (e.g. Winamp Online Service: Tour Tracker, Metro Lyrics, 7Digital store, Moviefone HD Trailers, etc.)
- Now Playing in Client – this launches a specific artist page within the Winamp client including deep-linking to sub-tabs such as -
- Biography – band bio/history powered by AMG
- Songs – allows for playback of any available songs
- Photos – powered by AOL Music
- Videos – powered by Truveo
- Radio – powered by SHOUTcast
- News – All News, AOL Music News, & Blog
The simplest example of the launcher is to just open up your web browser (as long as it's either Firefox or IE) and visit:
The page first does a quick check to ensure that the proper browser plug-in/dll is installed and that the user is using Winamp version 5.57 or above before it attempts to launch Winamp. Additionally, thanks to two browser plug-ins (one for Firefox, one for Internet Explorer) there is a way to presence check Winamp before attempting to load such a URL.
Anatomy of an Example Request
The diagram below explains the specifics of making a Winamp Launch Gateway request. The first and second parameters are optional.
Test Bed
Check out how these URLs work.
- Subscribe to Podcasts:
- Podcasts Root - http://launch.winamp.com/Podcast/
- Subscribe to the Podcast (http://rock-of-ages.podOmatic.com/rss2.xml) in Winamp - http://launch.winamp.com/Podcast/Subscribe?url=http://rock-of-ages.podOmatic.com/rss2.xml
- Add Online Services:
- Online Services Root - http://launch.winamp.com/Online%20Services
- Online Services Details Page - http://launch.winamp.com/Online%20Services/go?id=222150
You can pick up the service id (222150 in the example mentioned above) from the Online Services URL in Winamp.com. See screenshot
- Play in Now Playing:
- Now Playing Root - http://launch.winamp.com/Now%20Playing
- Now Playing Artist Page - http://launch.winamp.com/Now%20Playing/artist/?artistName=Alien%20Ant%20Farm (Notice the %20 in the name. The %20 is nothing but space between words in an artist name)
- Play a SHOUTcast station:
By placing a promo badge on your site, you can directly launch and open the Winamp player to start playing your station.
- Launch URL structure for SHOUTcast - http://launch.winamp.com/sc/<station ip>:<port>
- Example of launch URL for a SHOUTcast station - http://launch.winamp.com/sc/74.63.47.82:8090
Winamp Launch URL Promo Badges
You can use the following badges or buttons for the launch URLs we mentioned above. Please download the hi-res from http://www.winamp.com/promote.
- Subscribing to a Podcast
- Adding an Online Service
- Playing in Now Playing
Winamp Client Requirements
Version 5.57 and up
Compatible Winamp Plug-ins
- Online Services
- Now Playing
- Podcast Directory
Example Fail Case
If you have an older version of Winamp and you attempt to use the Winamp Launch URLs in your website, a user to your website will see the following screenshot. You will need to follow the given instructions in the screenshot below.
Screenshot:
Caveats
- When attempting to launch, if Winamp is already open (hidden behind other windows, for example) or minimized, it will not steal focus.
- If the user doesn't have Firefox installed at the time of installing Winamp 5.57, then later decides to install Firefox and use the Winamp Launch Gateway, the presence check plug-in will fail because it was not installed (due to the absence of Firefox at install time) and there is currently no way for them to manually install it other than re-installing Winamp.
- At this point it is not known what other browsers, if any, will launch Winamp correctly besides Internet Explorer and Firefox.
