How do I develop Silverlight applications that manage profiles?

The information in this article applies to:

• ProfileKit 4

Summary

You can develop Silverlight applications that manage speaker profiles using your favorite Silverlight development tools such as Microsoft Visual csharp .NET and Microsoft Visual Basic .NET.

More Information

To access the ProfileKit Silverlight classes within your application, add them to your project References:

To access the ProfileKit Silverlight classes within your application, add references to the ProfileKit assemblies in your code:

using System;
...
using Chant.ProfileKit.Silverlight;
using Chant.Shared.Silverlight;
                        

Imports Chant.ProfileKit.Silverlight
Imports Chant.Shared.Silverlight
Class MainWindow
...
                        

Out-of-Browser Settings

To run your Silverlight app out-of-browser, set the properties as follows:

1. Within your Silverlight project, select the Silverlight tab under project properties.
2. Select the checkbox: Enable application running out of the browser.
3. Deselect the checkbox: Require elevated trust when running in-browser.
4. Press the Out-of-Browser Settings... button.
5. Select the checkbox: Required elevated trust when running outside the browser.

In-Browser Settings

To run your Silverlight app in-browser, set the properties as follows:

1. Within your Silverlight project, select the Silverlight tab under project properties.
2. Select the checkbox: Require elevated trust when running in-browser.
3. Deselect the checkbox: Enable application running out of the browser.
4. Select the Signing tab under project properties.
5. Select the checkbox: Sign the Xap File.
6. Press one of the three buttons to select a signing certificate:
   1. Select from Store... if you have installed a signing certificate on your system;
   2. Select from File... if you have a signing certificate file your system; or
   3. Create test certificate... if you do not have signing certificate on your system.
7. Press the More Details... button to ensure you have installed Trusted Root and Publisher certificiates:
   1. Press the Install Certificate... button;
   2. Select Automatically ... option if you have Certificate installed in your store or Select Place ... option if you created a temp certificate for testing and press the Browse button;
   3. Select Trusted Root Certification Authorities and press the OK button; and
   4. Press the Next button.
   5. Repeat the process by Pressing the Install Certificate... button;
   6. Select Place ... option and press the Browse button;
   7. Select Trusted Publishers and press the OK button; and
   8. Press the Next button.
8. Run regedit to add a Silverlight registery property AllowElevatedTrustAppsInBrowser with value of 1:
   1. Select the Start menu and enter regedit to launch the Registry Editor;
   2. For Win32 systems, navigate to HKEY_LOCAL_MACHINE\Software\Microsoft\Silverlight\;
   3. For Win64 systems, navigate to HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Silverlight\;
   4. Right click and select New->DWORD (32-bit) Value;
   5. Set the value name to AllowElevatedTrustAppsInBrowser;
   6. Set th value data to 1;
   7. Press the OK button; and
   8. Close the Registry Editor.

Object Instantiation

Declare a global variable for the ChantPM class, instantiate an instance, add the event handler, and set the license and serial properties.

private Chant.ProfileKit.Silverlight.NChantPM NChantPM1;
public MainPage()
{
    InitializeComponent();
    // Instantiate NChantPM object
    NChantPM1 = new NChantPM(this);
    // Setup event callback handler
    NChantPM1.HasEvent += new Chant.ProfileKit.Silverlight.NChantPM.HasEventHandler(this.NChantPM1_HasEvent);
    // Set license properties
    NChantPM1.SetStringProperty(ChantStringProperty.CSPLicense, "LicenseRegistrationNumber");
    NChantPM1.SetStringProperty(ChantStringProperty.CSPSerials, "LicenseSerialNumber");
}
                    

Dim WithEvents NChantPM1 As NChantPM

Private Sub UserControl_Loaded(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs) Handles MyBase.Loaded
    NChantPM1 = New NChantPM(Me)

    ' Set license properties
    NChantPM1.SetStringProperty(ChantStringProperty.CSPLicense, "LicenseRegistrationNumber")
    NChantPM1.SetStringProperty(ChantStringProperty.CSPSerials, "LicenseSerialNumber")

    ...

End Sub
                        

Event Callbacks

Event callbacks are the mechanism in which the component library sends information back to the application such as import/export operation state, training state, or there was an error.

private void NChantPM1_HasEvent(object sender, HasEventArgs e)
{
    // Get the number of events
    int numberOfEvents = NChantPM1.GetResourceCount(ChantSpeechResource.CSREvent, 0, 0);
    for (int i = 0; i < numberOfEvents; i++)
    {
        // Get the event from the event queue
        NChantPMEvent nChantPMEvent = NChantPM1.GetChantPMEvent(0);
        switch (nChantPMEvent.ChantCallback)
        {
            case ChantCallback.CCSRProgress:
                {
                    ...
                    break;
                }
            default:
                break;
        }
        // Remove the event from the event queue
        NChantPM1.RemoveResource(ChantSpeechResource.CSREvent, 0, 0, "");
    }
}
                        

Private Sub NChantPM1_HasEvent(ByVal sender As System.Object, ByVal e As HasEventArgs) Handles NChantPM1.HasEvent
    Dim I As Integer
    Dim numberOfEvents As Integer
    Dim nChantPMEvent As NChantPMEvent
    ' Get the number of events
    numberOfEvents = NChantPM1.GetResourceCount(ChantSpeechResource.CSREvent, 0, 0)
    For I = 0 To numberOfEvents - 1
        ' Get the event from the event queue
        nChantPMEvent = NChantPM1.GetChantPMEvent(0)
        Select Case nChantPMEvent.ChantCallback
            Case ChantCallback.CCSRProgress
                ...
        End Select
        ' Remove the event from the event queue
        NChantPM1.RemoveResource(ChantSpeechResource.CSREvent, 0, 0, "")
    Next
End Sub
                        

Deployment Checklist

When you are ready to deploy your application, you need to ensure you have a valid license, bundle the correct Chant component libraries, and configure your installation properly on the target system. Review the following checklist before deploying your applications:

Sample Projects

Silverlight sample projects are installed at the following location: