Namespaces

Variants
Actions

Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.

Nokia MixRadio app-to-app protocol for Windows Phone 8

From Wiki
Jump to: navigation, search

This article explains how to access Nokia MixRadio services using the Nokia MixRadio app's published app-to-app protocol.

SignpostIcon XAML 40.png
WP Metro Icon WP8.png
Article Metadata
Tested with
Devices(s): Nokia Lumia devices,
Compatibility
Platform(s):
Windows Phone 8
Dependencies: Nokia Lumia device only, Nokia MixRadio
Article
Created: chintandave_er (15 Nov 2012)
Last edited: hamishwillee (21 Nov 2013)

Contents

Introduction

Windows Phone 8 exposes an app-to-app protocol API for 3rd party applications. This can be used to launch the Nokia MixRadio app with the Launching API for Windows Phone, search for an artist or an album, get details of a particular song or an album, get nearest gigs etc. This article describes how to use Nokia MixRadio app-to-app protocol in an application to access the Nokia MixRadio service.

Tip.pngTip: The protocol relies on the existence of the Nokia MixRadio app, which will not be present on non-Nokia devices. If your code may run on other devices a good approach is to use the Nokia MixRadio API Launchers - not only do these provide the common "launcher" interface, but they also provide fallback-to-web behaviour if Nokia MixRadio app is not present.

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 MixRadio API Launchers for Windows Phone 8 to use various services of Nokia MixRadio . 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 MixRadio app from other app, call Launcher.LaunchUriAsync(Uri) with URI Schema nokia-music://

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

Note.pngNote: This code cant be tested on Windows Phone 8 Emulator due to lack of Nokia MixRadio 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 MixRadio to install Nokia MixRadio app manually.

Nokia MixRadio app-to-app protocol

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

Launch App

Task URI
Launch App nokia-music://

Example:

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

Search Artist

Task URI
Search nokia-music://search/anything/?term={searchtext}

Example:

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

Show Artist Details

Task URI
Show Artist Details By Id nokia-music://show/artist/?id={id}
Show Artist Details By name nokia-music://show/artist/?name={name}

Example:

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

Play Artist Mix

Task URI
Play an Artist Mix nokia-music://play/artist/?artist={name}


Example:

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


Show Gigs Around You

Task URI
Show Gigs Around You nokia-music://show/gigs


Example:

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

Search for Gigs

Task URI
Search for Gigs nokia-music://search/gigs/?term={term}


Example:

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

Show Curated Mixes

Task URI
Show Curated Mixes nokia-music://show/mixes


Example:

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


Play a Curated Mix

Task URI
Play a Curated Mix nokia-music://play/mix/?id={id}


Example:

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


Show Product Details (e.g. Album)

Task URI
Show Product Details (e.g. Album) nokia-music://show/product/?id={id}


Example:

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

See also

This page was last modified on 21 November 2013, at 23:38.
144 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×