Click here to Skip to main content
11,805,316 members (65,523 online)
Click here to Skip to main content

Announcer in C#.NET using Microsoft Agent

, 11 Jun 2003 137K 4K 73
Rate this:
Please Sign up or sign in to vote.
A tool to announce message, sing a song and tell a joke.

I'm Genie

Picture 1. I'm genie

I'm Merlin

Picture 2. I'm Merlin

I'm Peedy

Picture 3. I'm Peedy

I'm Robby

Picture 4. I'm Robby


Microsoft® Agent is a software technology that enables an enriched form of user interaction that can make using and learning to use a computer, easier and more natural. Microsoft® Agent is a set of programmable software services that supports the presentation of interactive animated characters within the Microsoft Windows® interface I'm using Microsoft® Agent to develop this announcer. I have used four type of announcers here. They are Genie, Merlin, Peedy and Robby . More..

This class demonstrates the use of following namespaces.

  • using System.Runtime.InteropServices
  • using System.Reflection
  • AgentServerObjects
  • AgentObjects

Things required, where to get and how to install

  1. You have to add reference AgentObjects.dll and AgentServerObjects.dll. You can get this two DLLs from F:\Program Files\Microsoft Visual Studio .NET\ FrameworkSDK\Samples\Technologies\Interop\Applications\MSAgent\AgentExplorer. Bear in mind, you have installed .NET in F:.

    Or Just go to F:\Program Files\Microsoft Visual Studio .NET\FrameworkSDK\Samples\Technologies\Interop\Applications\MSAgent\Hello1 and take a look at read me.htm file how to get those DLLs. You just give, nmake all. This command will create AgentObjects.dll and AgentServerObjects.dll in hello1 folder.

    Or just use those DLLs from this setup. I have bind these DLLs with this setup.

    Assure those 2 DLLs in bin debug/release folder and add reference to solution explorer in you project.

  2. We have to put .acs in debug or release folder. Announcer will show error if .acs file is not there. You can get four .acs files from There you get genie, Merlin, Peedy and Robby, Microsoft agent character files (.acs)

    and put into release or debug folder.

  3. Just download and open the MicrosoftAgentApplication.sln file to use it.

    Before run this, you have to install Text to speech engine. Download Text-to-Speech Engineer tv_enua.exe American English - 1 MB from here I could not add this with my demo setup due to size restriction.

    Just click tv_enua.exe to install. Then announcer is ready to announce anything, sing a song and tell a joke.

Source code

I have given sample code to use it.

using System.Data;
using System.Drawing;
using System.Reflection; 
using System.Collections;
using System.Windows.Forms;
using System.ComponentModel;
using System.Runtime.InteropServices; 

using AgentObjects;
using AgentServerObjects;

Before we make a function to create an error files, we have to declare some variables that will be used in our function. This is an example of variables declaration and the main function is ErrorRoutine.

  AgentServer Srv = new AgentServer();  //Create a agent server
  //If unable to create show the error
  if (Srv == null) 
    MessageBox.Show("ERROR: Agent Server couldn't be started!");

  IAgentEx SrvEx;

  // The following cast does the QueryInterface to 
  //fetch IAgentEx interface from the IAgent interface,
  //directly supported by the object
  SrvEx = (IAgentEx) Srv;

  // First try to load the default character
  int dwCharID=0, dwReqID=0;
    // null is used where VT_EMPTY variant is expected by the COM object
    String strAgentCharacterFile = null;
    //Check  microsoft agent character filename(.acs)  is empty 
    if (!strFileName.Equals(string.Empty))  
    //Get the acs path
    strAgentCharacterFile = strPath + strFileName;
    MessageBox.Show("Select Style");

    if (!TxtSpeakInput.Text.Equals(string.Empty)) 
    //load the acs file
    SrvEx.Load(strAgentCharacterFile, out dwCharID, out dwReqID);
    MessageBox.Show("Enter Text");
catch (Exception) 
    MessageBox.Show("Failed to load Agent character! Exception details:");

   IAgentCharacterEx CharacterEx=null;
   SrvEx.GetCharacterEx(dwCharID, out CharacterEx);

   // Show the character.  The first parameter tells Microsoft
   // Agent to show the character by playing an animation.
   CharacterEx.Show(0, out dwReqID);

   // Make the character speak
   // Second parameter will be transferred to the COM object as NULL
   CharacterEx.Speak(TxtSpeakInput.Text, null, out dwReqID);

Here, We can select a different announcer and enter different text to speak. Just try it. It is simple to use.

We can create our own character files. Just visit to explore more..


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Ashraf Mohamed
Web Developer
United States United States
I am a system analyst and have been with Microsoft & Sun Technologies for more than 7 years. I have always been fascinated by java and .NET. I take lot of technical articles and writing them.

I am a Sun Certified Java Programmer for Java 2 Platform 1.4 , Web component developer Java 2 Platform - Enterprise Edition 1.4 and Microsoft certified developer using C#.NET in Web Development ASP.NET.

Visit my web site

You may also be interested in...

Comments and Discussions

Questioncan any one give me some presentable eample of stack Pin
sumaira manzoor1-Oct-08 19:10
membersumaira manzoor1-Oct-08 19:10 
QuestionMultiple copies of same agent Pin
krishnakumarp17-Jul-07 20:27
memberkrishnakumarp17-Jul-07 20:27 
Questionerror when manipulating from event handler Pin
scotru224-Jun-07 12:15
memberscotru224-Jun-07 12:15 
AnswerRe: error when manipulating from event handler Pin
scotru224-Jun-07 14:00
memberscotru224-Jun-07 14:00 
GeneralOutofMemoryexception Pin
jasaz2-Feb-07 21:53
memberjasaz2-Feb-07 21:53 
GeneralRe: OutofMemoryexception Pin
Mohamed Ashraf3-Feb-07 0:57
memberMohamed Ashraf3-Feb-07 0:57 
Generalits working!!!! Pin
jasaz4-Feb-07 4:49
memberjasaz4-Feb-07 4:49 
QuestionCatch an event from character Pin
yellow_lucky4-May-06 1:28
memberyellow_lucky4-May-06 1:28 
GeneralI donn't hear anything ... Pin
jmwatte20-Jul-05 10:47
memberjmwatte20-Jul-05 10:47 
GeneralRe: I donn't hear anything ... Pin
lordhairballhome24-Aug-05 19:42
memberlordhairballhome24-Aug-05 19:42 
General.Net compact framework Pin
chad,Yang20-Feb-04 19:36
susschad,Yang20-Feb-04 19:36 
GeneralRe: .Net compact framework Pin
contini16-Feb-05 4:54
membercontini16-Feb-05 4:54 
GeneralRe: .Net compact framework Pin
Eric Van de Kerckhove23-Feb-06 7:06
memberEric Van de Kerckhove23-Feb-06 7:06 
Generalasp agents Pin
Jerry Amadon13-Jan-04 12:19
sussJerry Amadon13-Jan-04 12:19 
GeneralRe: asp agents Pin
Anonymous10-Oct-04 17:53
sussAnonymous10-Oct-04 17:53 
GeneralLoad error.... Pin
ZippyBubbleHead17-Jun-03 18:34
memberZippyBubbleHead17-Jun-03 18:34 
GeneralRe: Load error.... Pin
Mohamed Ashraf23-Jun-03 3:57
memberMohamed Ashraf23-Jun-03 3:57 
General[Message Deleted] Pin
VijayCh12-Jun-03 8:18
memberVijayCh12-Jun-03 8:18 
GeneralRe: Images missing Pin
Mohamed Ashraf12-Jun-03 19:10
memberMohamed Ashraf12-Jun-03 19:10 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.151002.1 | Last Updated 12 Jun 2003
Article Copyright 2003 by Ashraf Mohamed
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid