In this MWC/ADC 2013 presentation Steve Robbins, Chief Architect for Nokia Music, explores the features of the Nokia Music Windows Phone API and shows you how to install and use the API. He then describes how to code with the API to quickly add music features to existing apps, and demonstrates how to get music content into your app. For more information see www.developer.nokia.com/windowsphone and http://www.developer.nokia.com/Resources/Library/Lumia/#!nokia-music-apis.html. Find out more about the developer features of Nokia Lumia smartphones in the Lumia App Labs: http://www.developer.nokia.com/Develop/Windows_Phone/Learn/

1. MWC 2013
USING THE NOKIA
MUSIC WINDOWS
PHONE APIS
Steve Robbins
Chief Architect
Nokia Music

2. AGENDA
What is Nokia Music?
Using our App-to-App APIs.
Using our C# API to add music data to your app.

3. NOKIA MUSIC
Instant free music streaming
on Lumia Windows Phones
100s of curated mixes
Create your own artist mixes
Offline caching
Graphic Equalizer
No login, no ads
Gig Finder for live concerts

4. NOKIA MUSIC APP-TO-APP APIS
Nokia Music 3.5 for Windows Phone 8
added App-to-App APIs
In the Windows Phone Store now!

5. NOKIA MUSIC APP-TO-APP APIS
App-to-App protocols allow one
app to launch another with a
specific URI scheme.
Launcher.LaunchUriAsync(
"nokia-­‐music://show/artist/?name=
Rihanna")

6. NOKIA MUSIC APP-TO-APP APIS
Launch App nokia-­‐music://
Search MP3 store nokia-­‐music://search/anything/?term={term}
Show Artist Details nokia-­‐music://show/artist/?name={name}
Play an Artist Mix nokia-­‐music://play/artist/?artist={name}
Show Gigs Around You nokia-­‐music://show/gigs/
Search for Gigs nokia-­‐music://search/gigs/?term={term}
Show Curated Mixes nokia-­‐music://show/mixes/
Play a Curated Mix nokia-­‐music://play/mix/?id={id}
Show Product Details – e.g. an album nokia-­‐music://show/product/?id={id}

7. DEMOS
Create App that Launches Nokia Music
Extend App to search for music
Benefits of App-to-App

8. APP-TO-APP AND NFC
ProximityDevice
device
=
ProximityDevice.GetDefault();
if
(device
!=
null)
{
device.PublishBinaryMessage("WindowsUri:WriteTag",
GetBufferFromUrl("nokia-­‐music://play/mix/?id=35541874"),
UnregisterUponSend);
MessageBox.Show("Tap
NFC
tag
to
write
link");
}
See http://nokia.ly/nfcslides

9. APP-TO-APP IMPLEMENTATION
If you want to learn how to implement app-to-app, watch our //build/
talk at 14mins-22mins
http://nokia.ly/
buildmusicapi

10. NOKIA MUSIC LAUNCHER TASKS
new
ShowArtistTask()
{
ArtistName
=
"Green
Day"
}.Show();

11. WEB FALL-BACK
void
Launch(Uri
appToAppUri,
Uri
webFallbackUri)
{
#if
WINDOWSPHONE8
if
(IsNokiaDevice())
{
Launcher.LaunchUriAsync(appToAppUri);
return;
}
#endif
WebBrowserTask
web
=
new
WebBrowserTask();
web.Uri
=
webFallbackUri;
web.Show();
}

12. NOKIA MUSIC LAUNCHER TASKS
Launch App new
LaunchTask().Show();
new
MusicSearchTask()
{
Search MP3 store
SearchTerms
=
"Rihanna"
}.Show();
new
ShowArtistTask()
{
Show Artist Details
ArtistName
=
"Green
Day”
}.Show();
new
PlayMixTask()
{
Play an Artist or Curated Mix ArtistName
=
"Green
Day"
}.Show();
Show Gigs Around You or Search for Gigs new
ShowGigsTask().Show();
Show Curated Mixes new
ShowMixesTask().Show();

13. DEMOS
API installation with NuGet
Replace URI-based App-to-App with MusicSearchTask
Take an existing Location-based app and add “Gigs Near You” feature

14. NOKIA MUSIC C# API
Makes it easy for you to integrate music
data into your app.
MusicClientAsync
client
=
new
MusicClientAsync(AppId,
AppCode);
var
artists
=
await
client.GetTopArtists();
list.ItemsSource
=
artists.Result;
//
when
user
selects
artist...
artist.PlayMix();

15. NOKIA MUSIC C# API
Search var
items
=
await
client.Search("Green
Day");
Search Artist By Location var
a
=
await
client.GetArtistsAroundLocation(51.45,-­‐2.6);
Get Artist Suggestions var
a
=
await
client.GetArtistSearchSuggestions("Green");
Get Search Suggestions var
a
=
await
client.GetSearchSuggestions("Poker");
Gets charts var
albums
=
await
client.GetTopProducts(Category.Album);
Gets a list of new releases var
tracks
=
await
client.GetNewReleases(Category.Track);
Gets the top artists var
artists
=
await
client.GetTopArtists();
Gets available genres var
genres
=
await
client.GetGenres();
Gets top artists for a genre var
artists
=
await
client.GetTopArtistsForGenre(myGenre);

16. NOKIA MUSIC C# API
Gets products by an artist var
products
=
await
client.GetArtistProducts(myArtist);
Gets similar artists var
artists
=
await
client.GetSimilarArtists(myArtist);
Gets available Mix Groups var
mixGroups
=
await
client.GetMixGroups();
Gets Mixes for a group var
mixes
=
await
client.GetMixes(myMixGroup);

17. DEMOS
Sign up for API Keys
Create application to show artists on map

18. SUMMARY
Source and examples: http://nokia.ly/wpmusicapi
Contact @sr_gb or steve.robbins@nokia.com