How Tos

Last reviewed: 7/15/2011

Article ID: H071140

HOW: Developing Web applications that manage markup

The information in this article applies to:

  • VoiceMarkupKit 4

Summary

The Chant VoiceMarkupKit Web Component Library is for developing web applications that manage voice markup using your favorite JavaScript and VBScript development tools.

More Information

VoiceMarkupKit class methods require enumeration constant values for some of the parameters. These constants are pre-defined in files chant.js and chant.vb. Copy the applicable file to the same folder as your web page from the following installation folder:

Program Files\Chant\VoiceMarkupKit 4\Win32\Web\include.

Access the constant values on your web page by including a reference to the file on your web page. 

<head>
<script type="text/javascript" language="JavaScript" src="chant.js" />
... 
</head>
<body onload="onLoad()">
...
</body>

Object Declaration

Chant VoiceMarkupKit includes a Web component library that can be accessed via script code on a web page.

The ChantVM component can be accessed via JavaScript and VBScript code on a web page. The IE browser caches the component automatically for the web page.

Object Instantiation

The ChantVM class object is automatically instantiated when the web page loads. Access the instance of the ChantVM object from the document object. Set the CSPSerials property with your VoiceMarkupKit license serial number to unlock the component library for this web page. Even though you access the ChantVM object instance from as many functions as your application needs, you only need to set the CSPLicense once on page load. 

<head>
<script type="text/javascript" language="JavaScript"><!--
    function onLoad() {
        // Get the object instance (Win32 and Win64)
        var chantVM = document.getElementById('WChantVM1');
        // Get the object instance (WinCE)
        var chantVM = document.all['WChantVM1'];

        // Set license property
        chantVM.SetStringProperty(CSPSerials,"LicenseSerialNumber");

        ...
    }
//-->
</script>
</head>
<body onload="onLoad()">
...
</body>

Event Callbacks

Event callbacks are the mechanism in which the component library sends information back to the application such as there was an error. 

<script type="text/javascript" language="JavaScript" for="WChantVM1" event="HasEvent"><!--
    var oChantVMEvent;

    var chantVM = document.getElementById('WChantVM1');
    // Get the number of events
    numberOfEvents = chantVM.GetResourceCount(CSREvent);
    for (i = 0; i < numberOfEvents; i++)
    {
        // Get the event from the event queue
        oChantVMEvent = chantVM.GetResource(CSREvent, 0);
        switch (oChantVMEvent.ChantCallback)
        {
            case CCAPIError:
                {
                    ...       
                }
            default:
                break;
        }
        // Remove the event from the event queue
        chantVM.RemoveResource(CSREvent, 0, 0, "");
    }
//-->
</script>

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:

  • You may deploy your web page to any domain with a valid license from the Chant.
  • Update the codebase tag in the <object> declaration with location of the VoiceMarkupKit cab file. This can be the Chant web location or the URL of that location on your website where you copy the licensed cab file.

Sample Projects

Web sample projects are installed at the following location:

  • My Documents\Chant VoiceMarkupKit 4\Win32\Web\JavaScript.