Creating a Voice-Controlled Windows Phone 8 Music Information app with the Nokia Music API - Revision history

Hamishwillee: Text replace - "[[Category:Silverlight" to "[[Category:XAML"

2013-04-10T01:29:30Z

Text replace - "[[Category:Silverlight" to "[[Category:XAML"

Hamishwillee: Hamishwillee - Add competition winner note

2013-01-22T23:12:35Z

Hamishwillee - Add competition winner note

Jaaura: Jaaura -

2013-01-08T13:30:23Z

Jaaura -

Matthewthepc: Matthewthepc - quick grammatical fix

2012-11-17T00:20:39Z

Matthewthepc - quick grammatical fix

Matthewthepc: Matthewthepc - added links for speech recognition info

2012-11-16T02:49:39Z

Matthewthepc - added links for speech recognition info

Matthewthepc: Matthewthepc - Updated the code to allow for any-artist searching

2012-11-16T02:43:36Z

Matthewthepc - Updated the code to allow for any-artist searching

Show changes

Chintandave er: Chintandave er - articlemetadata - devicecompatability

2012-11-15T14:30:24Z

Chintandave er - articlemetadata - devicecompatability

Hamishwillee: Hamishwillee - Minor subedit

2012-11-15T05:32:12Z

Hamishwillee - Minor subedit

Hamishwillee: Hamishwillee - Subedit for wiki style

2012-11-15T05:02:38Z

Hamishwillee - Subedit for wiki style

Show changes

Hamishwillee: Hamishwillee - Bot update - Fix metadata

2012-11-13T04:14:27Z

Hamishwillee - Bot update - Fix metadata

@@ Line 1: / Line 1: @@
-[[Category:Windows Phone]][[Category:Windows Phone 8]][[Category:Silverlight]][[Category:Nokia Music API]][[Category:Voice/Speech]][[Category:Multimedia]][[Category:Code Examples]]
+[[Category:Windows Phone]][[Category:Windows Phone 8]][[Category:XAML]][[Category:Nokia Music API]][[Category:Voice/Speech]][[Category:Multimedia]][[Category:Code Examples]]
 {{Abstract|This tutorial explains how to combine the Windows Phone 8 voice services with Nokia Music to make a voice-controlled Windows Phone 8 music information app.}}
 {{Note|This article was a winner in the [[Windows Phone 8 Wiki Competition 2012Q4]].}}

@@ Line 1: / Line 1: @@
 [[Category:Windows Phone]][[Category:Windows Phone 8]][[Category:Silverlight]][[Category:Nokia Music API]][[Category:Voice/Speech]][[Category:Multimedia]][[Category:Code Examples]]
 {{Abstract|This tutorial explains how to combine the Windows Phone 8 voice services with Nokia Music to make a voice-controlled Windows Phone 8 music information app.}}
 {{ArticleMetaData <!-- v1.2 -->
 |sourcecode= [http://sdrv.ms/TAapvg Music Info Source Code.zip]

@@ Line 1: / Line 1: @@
 [[Category:Windows Phone]][[Category:Windows Phone 8]][[Category:Silverlight]][[Category:Nokia Music API]][[Category:Voice/Speech]][[Category:Multimedia]][[Category:Code Examples]]
 {{Abstract|This tutorial explains how to combine the Windows Phone 8 voice services with Nokia Music to make a voice-controlled Windows Phone 8 music information app.}}
 {{ArticleMetaData <!-- v1.2 -->
 |sourcecode= [http://sdrv.ms/TAapvg Music Info Source Code.zip]

@@ Line 31: / Line 31: @@
 With Windows Phone 8, apps can register to handle specific commands. For instance, a calculator app could handle the "add," "subtract," "multiply," and "divide" commands to provide instant, easy access from any place in the OS. Windows Phone 8 also provides text to speech capabilities, and Nokia has provided [http://www.developer.nokia.com/Resources/Library/Lumia/#!nokia-music-api.html Nokia Music API for Windows Phone] which can be used to query a web service for music information.
-This article explains how we use these three features to create a voice-controlled music information app. The app will respond verbally to a voice command along the lines of "Music, what are the top songs by Adele?"
+This article explains how we can use these three features to create a voice-controlled music information app. The app will respond verbally to a voice command along the lines of "Music, what are the top songs by Adele?"
 For clarity, the rest of this tutorial has been split up into three parts, Text to Speech, Nokia Music, and Voice Commands.

@@ Line 307: / Line 307: @@
 * [http://social.msdn.microsoft.com/Forums/en-US/wpdevelop/thread/c3ab694d-81da-42a5-8a8b-72ee4a5a8e48/ How to create a PhraseList in a VCD file that includes every word (wildcard)?] (MSDN Forums)
 * [https://github.com/nokia-entertainment/wp-api-client The Nokia Music WP API Client Test App] (Github)
 * [[Voice Commands in Windows Phone 8]] (wiki)

@@ Line 9: / Line 9: @@
 |devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
 |sdk= [http://www.microsoft.com/en-us/download/details.aspx?id=35471 Windows Phone SDK 8.0]
-|platform= Windows Phone 8 and later
+|platform= Windows Phone 8
-|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
+|devicecompatability= Nokia Lumia Phones Only (Phones with Nokia Music app)
 |dependencies= Nokia Music API
 |signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 |capabilities= ID_CAP_MICROPHONE and ID_CAP_SPEECH_RECOGNITION
-|keywords= Windows Phone 8, WP8, Speech, TTS, Text to Speech, Speech Recognition, Music, Nokia Music, Nokia Music API
+|keywords= Windows Phone 8, TTS, Text to Speech, Speech Recognition, Nokia Music API
 |language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 |translated-by= <!-- [[User:XXXX]] -->

@@ Line 29: / Line 29: @@
 == Introduction ==
-With Windows Phone 8, apps can register to handle specific commands. For instance, a calculator app could handle the "add," "subtract," "multiply," and "divide" commands to provide instant, easy access from any place in the OS. Windows Phone 8 also provides text to speech capabilities.
+With Windows Phone 8, apps can register to handle specific commands. For instance, a calculator app could handle the "add," "subtract," "multiply," and "divide" commands to provide instant, easy access from any place in the OS. Windows Phone 8 also provides text to speech capabilities, and Nokia has provided [http://www.developer.nokia.com/Resources/Library/Lumia/#!nokia-music-api.html Nokia Music API for Windows Phone] which can be used to query a web service for music information.
-For the rest of this tutorial, we will create the backend code for a music information app. This app will respond verbally to a voice command along the lines of "Music, what are the top songs by Adele?"
+This article explains how we use these three features to create a voice-controlled music information app. The app will respond verbally to a voice command along the lines of "Music, what are the top songs by Adele?"
-−
-In order to achieve this goal, we will also use the Nokia Music API for Windows Phone to get music information.
 For clarity, the rest of this tutorial has been split up into three parts, Text to Speech, Nokia Music, and Voice Commands.
@@ Line 57: / Line 55: @@
 using Windows.Phone.Speech.VoiceCommands;
 </code>
 == Text to Speech ==
 Our music app will need to be able to respond to the user verbally, and new features in Windows Phone 8 make that extremely easy.
-With Windows Phone 8, Microsoft made speech recognition and synthesization simple with the new Windows.Phone.Speech namespace. Our code for the {{Icode|SpeakText}} function is fairly straightforward:
+With Windows Phone 8, Microsoft made speech recognition and synthesization simple with the new {{Icode|Windows.Phone.Speech}} namespace. Our code for the {{Icode|SpeakText}} function is fairly straightforward:
 <code csharp>
 public async void SpeakText(string TextToSpeak)
+{
-	SpeechSynthesizer synth = new SpeechSynthesizer();
+  SpeechSynthesizer synth = new SpeechSynthesizer();
-	synth.SetVoice(InstalledVoices.Default); //you can change the voice to use here
+  synth.SetVoice(InstalledVoices.Default); //you can change the voice to use here
-	await synth.SpeakTextAsync(TextToSpeak);
+  await synth.SpeakTextAsync(TextToSpeak);
+}
 </code>
 Basically, we're going to create a new SpeechSynthesizer, set it's voice to the default installed voice (if you prefer another voice you can change it with {{Icode|synth.SetVoice()}}), and then await while it speaks whatever text is passed to the function.
@@ Line 77: / Line 78: @@
 Before we begin, you'll need to have signed up for an API key at [http://nokia.ly/apisignup nokia.ly/apisignup].
-=== Begining ===
+=== Creating the music client ===
 We'll start off by creating a blank function that will allow us to respond to an artist's name with that artist's top songs. This function will be called from our voice command handler. Place the below in your '''MainPage.xaml.cs''' file:
 <code csharp>
@@ Line 85: / Line 86: @@
 </code>
-Next, we'll add the code neccessary for the Nokia Music API. Add the following line to the {{Icode|RespondWithTopSongs}} function we just created, filling in the App ID and App Code accordingly:
+Next, we'll add the code necessary for the Nokia Music API. Add the following line to the {{Icode|RespondWithTopSongs}} function we just created, filling in the App ID and App Code accordingly:
 <code csharp>
 MusicClient nmClient = new MusicClient("App ID", "App Code"); //use the App ID and App Code values that you got from signing up at nokia.ly/apisignup
@@ Line 135: / Line 136: @@
    }, artist);
 </code>
 The code will assign the top three returned songs to a string which we will now need to read out to the user. We can use the {{Icode|SpeakText()}} function we created in the previous section to accomplish this:
@@ Line 185: / Line 187: @@
 == Voice Commands ==
 === Anatomy of a Voice Command ===
-Voice commands consist of three parts: the app name, command, and phrase.
+Voice commands consist of three parts: the app name, command, and phrase:
+* App Name: The app name is simply the name of your app. This part of your command is only necessary if the user is not using your app - if they're already in your app, there's no need for them to say the app name.
-==== App Name ====
+* Command: This is the portion of the voice command which actually tells you what the user wants to do. For example, in our app, the command would be "what are the top songs by"
-The app name is simply the name of your app. This part of your command is only necessary if the user is not using your app - if they're already in your app, there's no need for them to say the app name.
+* Phrase: The phrase provides more details about what exactly the user wants to do. In our app the phrase would be "Adele."
-−
-==== Command ====
 This is the portion of the voice command which actually tells you what the user wants to do. For example, in our app, the command would be "what are the top songs by"
-−
-==== Phrase ====
 The phrase provides more details about what exactly the user wants to do. In our app the phrase would be "Adele."
 === Registering a Voice Command ===
@@ Line 264: / Line 260: @@
 * [http://social.msdn.microsoft.com/Forums/en-US/wpdevelop/thread/c3ab694d-81da-42a5-8a8b-72ee4a5a8e48/ How to create a PhraseList in a VCD file that includes every word (wildcard)?] (MSDN Forums)
 * [https://github.com/nokia-entertainment/wp-api-client The Nokia Music WP API Client Test App] (Github)

@@ Line 8: / Line 8: @@
 |installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 |devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
-|sdk=[http://www.microsoft.com/en-us/download/details.aspx?id=35471 Windows Phone SDK 8.0]
+|sdk= [http://www.microsoft.com/en-us/download/details.aspx?id=35471 Windows Phone SDK 8.0]
-|platform=Windows Phone 8 and later
+|platform= Windows Phone 8 and later
 |devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 |dependencies= Nokia Music API
-|signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
+|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 |capabilities= ID_CAP_MICROPHONE and ID_CAP_SPEECH_RECOGNITION
-|keywords=Windows Phone 8, WP8, Speech, TTS, Text to Speech, Speech Recognition, Music, Nokia Music, Nokia Music API
+|keywords= Windows Phone 8, WP8, Speech, TTS, Text to Speech, Speech Recognition, Music, Nokia Music, Nokia Music API
 |language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 |translated-by= <!-- [[User:XXXX]] -->
 |translated-from-title= <!-- Title only -->
 |translated-from-id= <!-- Id of translated revision -->
-|review-by=<!-- After re-review: [[User:username]] -->
+|review-by= <!-- After re-review: [[User:username]] -->
 |review-timestamp= <!-- After re-review: YYYYMMDD -->
 |creationdate= 20121111
-|author=[[User:matthewthepc]]
+|author= [[User:matthewthepc]]
 }}
@@ Line 259: / Line 261: @@
 == Bibliography/See Also ==
-[http://www.developer.nokia.com/Community/Wiki/What%27s_new_in_Windows_Phone_8 What's new in Windows Phone 8] (Nokia Developer Wiki)
+[[What%27s new in Windows Phone 8]] (Nokia Developer Wiki)
 [http://blogs.msdn.com/b/robch/archive/2012/11/06/how-many-lines-of-code-does-it-take-to-build-a-complete-wp8-speech-app.aspx How Many Lines of Code Does it Take to Build a Complete WP8 Speech App] (Rob Chambers Blog)