Skip to content

mikpiipp/wp-api-client

 
 

Repository files navigation

wp-api-client

This codebase contains the Nokia Music Windows Phone API.

##Overview The Nokia Music Windows Phone API lets you easily integrate your Windows Phone applicaton with Nokia Music on Nokia Lumia phones. The API offers two levels of integration; the simplest and quickest to get going is to use the high-level Launcher Tasks, with more advanced integration available to perform searches and get recommendations within your app.

##License The Nokia Music Windows Phone API is released under the 3-clause license ("New BSD License" or "Modified BSD License") - see https://raw.github.com/nokia-entertainment/wp-api-client/master/LICENSE.txt.

##Usage

##Releases

  • 1.1.0 - A tidy-up release. We have removed optional paging parameters that had incorrectly been included on the GetMixes and GetProduct methods and removed some unneeded properties from the Location type.
  • 1.0.9 - Added Name to Artist Origin object, added AppToAppUri properties to Artist, Mix and Product
  • 1.0.8 - Added GetProduct and GetSimilarProducts
  • 1.0.7 - Added Gzip support
  • 1.0.6 - Fixed MusicSearchTask bug where searching artists with spaces did not work, added LocationConverter for working with Maps control, added exclusiveTag for exclusive mixes
  • 1.0.5 - Added RequestTimeout property to client, fix for location search querystring formatting
  • 1.0.4 - Added Thumb50 property for Artist, Mix and Product types; Added location-based search
  • 1.0.3 - Added Search Suggestions for artists and products
  • 1.0.2 - Initial Release

Launcher Tasks

The launcher APIs in Windows Phone allow an application to integrate with common operating system tasks such as taking a picture, finding an address or a contact, making a call, or saving a ring tone with very little effort.

With the high-level Launchers, you can perform the following using the new app-to-app APIs that Nokia Music supports on Windows Phone 8:

  • Launch the Nokia Music app
  • Search for music
  • Show Artist details
  • Show Gigs nearby
  • Show available mixes
  • Show product details
  • Play a mix

API Methods

With the lower-level API access, you get more control and can perform the following use cases within your app:

  • Search for content
  • Get top artists
  • Get charts
  • Get new releases
  • Get a list of genres
  • Get albums and tracks by an artist
  • Get artist recommendations
  • Get a list of available mixes

Documentation

The documentation for this component is at http://nokia.ly/wpmusicapidoc

Dependencies

We're proud to build on the shoulders of the following giants...

The projects make use of NuGet to install these components at build time.

Tools required to develop

  • Visual Studio 2010 for Windows Phone 7 development
  • Visual Studio 2012 for Windows Phone 8 development

Contributing

If you want to contribute to the project, check out the Issues tab.

You can:

  • Raise an issue
  • Suggest a feature for the application

Feeling like writing some code? Why not take the next step:

  • Fork the repository
  • Make the changes to the codebase
  • Send a pull request once you're happy with it

The team will then review the changes, discuss if anything needs to be addressed, and integrate your changes back into the application.

About

Windows Phone API Client

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 99.9%
  • Shell 0.1%