Revision as of 22:21, 21 November 2012

This article explains how to integrate our application with Nokia Music services and elements using Nokia Music API for Windows Phone. This article lists the URI schemes that can be used to launch Nokia Music and do other things with it.

Note: This is a community entry in the Windows Phone 8 Wiki Competition 2012Q4.

Introduction

Windows Phone 8 platform supports app-to-app protocol for 3rd party applications. It means that we can launch one app from another app by using Launching API for Windows Phone. This article describes how to use Nokia Music app-to-app protocol for Windows Phone 8 in our application to avail Nokia Music service. The Nokia Music Windows Phone API provides Launchers that allow easy integration with Nokia Music. Using this URI Scheme, we can launch Nokia Music app, search for an artist or an album, get details of a particular song or an album, get nearest gigs etc.

What is app-to-app protocol ?

App-to-app protocols allow one app to launch another app with a specific URI Scheme. With Windows Phone 8, we can also register our app as 3rd party application to support app-to-app protocol and can allow other app to open our app and use elements of our app into their app.

But here we will see how to use Nokia Music API Launchers for Windows Phone 8 to use various services of Nokia Music. To call app-to-app protocol, we need to use Launcher.LaunchUriAsync(Uri) method and pass URI schema in it. For example, to launch Nokia Music app from other app, call Launcher.LaunchUriAsync(Uri) with URI Schema nokia-music://

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://”));

Note: This code cant be tested on Windows Phone 8 Emulator due to lack of Nokia Music app but can test only on Nokia Lumia Windows Phone 8 device. If you want to test this code in Emulator, You need .xap file of Nokia music to install Nokia Music app manually.

Nokia Music app-to-app protocol

Here are the list of Nokia Music app-to-app protocol with example.

Launch App

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://”));

Search Artist

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://search/anything/?term=green day”));

Show Artist Details

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“ nokia-music://show/artist/?name=green day”));

Play Artist Mix

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://play/artist/?artist=green day”));

Show Gigs Around You

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://show/gigs”));

Search for Gigs

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://show/gigs”));

Show Curated Mixes

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://show/mixes”));

Play a Curated Mix

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://play/mix/?id=18523926”));

Show Product Details (e.g. Album)

Example:

Windows.System.Launcher.LaunchUriAsync(new Uri(“nokia-music://show/product/?id=36100035”));

See also

• Nokia Music API
• Nokia Music Launchers