Microsoft Agent Tutorial Chapter 1

原创 2004年09月10日 23:08:00
Part 1 - Loading the Microsoft Agent Control

The easiest way to load the agent control is to select it from the controls menu in VB and just drop it on your form.

Alternatively you can add a reference to the Microsoft Agent Control 2.0 from the References menu item in Visual Basic and create an object for the control at runtime like this:

     Private WithEvents MSAgent As Agent
     Set MSAgent = New Agent

For the purposes of this text we will assume the name of the Agent Control is called "MSAgent".



Part 2 - Loading a Character

A Character file defines what your agent will look like, and all the character animations are stored there. Before you can begin programming for MS Agent you need to specify what character file to open.

     ‘Create a Character Object
     Private Merlin As IAgentCtlCharacterEx

     ‘Load the Default Character by not supplying
     ‘an ACS file
     MSAgent.Characters.Load "Merlin", _ 

     ‘Set the Merlin object to our new character.
     Set Merlin = MSAgent.Characters("Merlin")

Microsoft Agent 2.0 has the ability to allow the user to enter in a default character to use with programs. If you want to load the default character the code looks just about the same.

Instead of doing this:

     MSAgent.Characters.Load "Merlin", “c:/windows/msagent/chars/merlin.acs”

We just need to leave out the path and the default will be used, like this:

     MSAgent.Characters.Load "DefaultCharacter"

To show your character on the screen do the following:


You can also hide your character by doing this:



Part 3 - Speech and Animations

Now that you have the character appearing on the screen you just need to get it to do something. Enter the following command after the Merlin.Show command:

     Merlin.Speak "Hello World!"

As you can see it's easy to get the agent to say something, all you need to do is give it a string with the text to speak and it will talk. Now try this one:

     Merlin.Speak "HELLO WORLD!"

You will notice that the Agent will not speak the words, but will sound out each letter. Remember this when you send text to the agents as you may want to convert it to lowercase before you call the Speak command.

The problem with the Speak command is that the agent does not use things like inflections or dramatic pauses; things we use in everyday speech, so typically when getting the agent to speak long sentences it will sound rather monotone. Lucky this is where speech output tags come in handy.

Part 4 - Speech Output Tags

Speech output tags can be used to modify the way in which words are spoken. All tags start and end with a backslash, and modify the word following the output tag. Whitespace is important so be sure not to leave empty space after your output tag or else your tag will not work properly.

One good example of this is the Emphasis ("Emp") tag. This tag will force the agent to emphasize a word. First lets hear a phrase without the emphasis placed on any word:

     Merlin.Speak "I will emphasize this word."

Now try it with the emphasis tag on the word "this".

     Merlin.Speak "I will emphasize /emp/this word."

Some tags like the Character ("Chr") tag have a parameter you can pass. This parameter must be surrounded by quotes, but since this is a string and the whole text is already in quotes you have to use double-quotes so VB knows that the quotes are part of the string. So to use the "Whisper" parameter for the "Chr" tag we would do this:

     Merlin.Speak "/Chr=""Whisper""/This is an example of whispering."

Another example of a tag that has parameters is the Context ("Ctx") tag. This tag can be used for Email addresses and phone numbers. To see why you may want to use the tag try this:

     Merlin.Speak ""

Notice Merlin said "me at someplace com" instead of "me at someplace dot com". That is because the period is never normally spoken by the agent. To get the agent to speak the period for an Email address you need to use the "Ctx" tag. Try this:

     Merlin.Speak "/Ctx=""Address"/"


Part 5 - Bookmarks

A bookmark is really just another speech output tag, ("Mrk") except for one difference, and that is that there is a special event tied to this tag. The bookmark tag is used to mark specific points in the text supplied to the agents Speak command. Once one of these tags is hit it will fire the BookMark event of the Agent control and pass it the ID you entered in the "Mrk" tag.

To demonstrate how to use bookmarks here is a small application.

You will need to Create a form and place this code in it. You will also need to put a label on the form and call it "Label1".

     Option Explicit
     Private WithEvents MSAgent As Agent
     Private Peedy As IAgentCtlCharacterEx
     Private Merlin As IAgentCtlCharacterEx
     Private Sub Form_Load()
     'Create an Instance of the Agent Control
     Set MSAgent = New Agent
     'Load the Merlin Character
     MSAgent.Characters.Load "Merlin",
     Set Merlin = MSAgent.Characters("Merlin")
     'Move the Character to the left
     Merlin.Left = 500
     'Show Merlin without playing the animation
     Merlin.Show True
     'Use bookmarks in the text to identify where merlin is
     Merlin.Speak "/Mrk=1/I am now reading line number one. " & _
                  "/Mrk=2/Now I am reading line two. " & _
                  "/Mrk=3/And finally, I am reading line three. /Mrk=4/ "
     End Sub
     Private Sub MSAgent_Bookmark(ByVal BookmarkID As Long)
     'When Merlin hits the point in the text above where
     'there is a bookmark tag this event is fired and the
     'ID in the Mrk tag is passed into here as the
     'BookMark ID
     Select Case BookmarkID
     Case 1
         Form1.Label1.Caption = "Merlin is currently Reading Line 1"

     Case 2
         Form1.Label1.Caption = "Merlin is currently Reading Line 2"

     Case 3
         Form1.Label1.Caption = "Merlin is currently Reading Line 3"

     Case 4
         Form1.Label1.Caption = "Merlin has finished Reading all lines"

     End Select
     End Sub


Part 6? - Animations

(Microsoft provides the complete animation list for all its characters on their website.)

Making the agent perform a specific animation is just one line of code. Try running this:
Merlin.Play "Read"

Notice the agent will read and then stop and go back to the default animation behavior. This is not true for all animations there are some that are called Looping Animations. These animations behave like their name suggests, they loop repeatedly. Try this:
Merlin.Play "Reading"

You will have to stop the above program because the Agent will continuing looping forever. One way to stop this is by using the "Stop" command.

DeepLearning tutorial(1)Softmax回归原理简介+代码详解

FROM: DeepLearning tutorial(1)Softmax回...
  • Real_Myth
  • Real_Myth
  • 2015年03月12日 14:54
  • 968


作者:刘威威编辑:李文臣11.GAN的 ‘前世’?大家都知道GAN是Ian Goodfellow 2 014年放出的一篇开山之作,在深度学习界评价很高,可以说GAN的出现,给深度学习界带来了很多的研究...
  • u013709270
  • u013709270
  • 2017年12月09日 00:00
  • 739

graph slam tutorial :从推导到应用2

在上一部分中通过一个例子大致了解了graph based slam的优化过程。在本篇博客中将提升一个层次,对图优化的求解过程进行推导。由于博文关注的在图构建好以后,如何调整机器人位姿使误差最下。因此,...
  • heyijia0327
  • heyijia0327
  • 2015年10月12日 11:04
  • 9191

Chapter 1 正则表达式入门

1 正则表达式简介 “正则表达式是描述一组字符串特征的模式,用来匹配特定的字符串。”                                                        ...
  • skuxeqrsjnxdo596
  • skuxeqrsjnxdo596
  • 2016年10月07日 22:02
  • 75

Chapter 1 预备知识

快捷导航快捷导航 0 导语 1 C简介 2 C简史 3 程序创建的技巧1.0 导语 C++在C语言的基础上添加了对面向对象编程和范型编程的支持 面向对象特性带来了全新的编程方法,这种方法是为应付复杂程...
  • DougHuang
  • DougHuang
  • 2017年07月11日 14:42
  • 94


Ubuntu14.04中Docker的基本使用 1、安装 1.1 使用apt-get安装(非最新版本) sudo apt-get install 1.2 下载安装(...
  • wang_san_shi
  • wang_san_shi
  • 2015年08月26日 15:49
  • 1331

【Chapter 1】入门

刚写了一半的blog 结果不小心backspace的时候浏览器后退了 伤心到爆。 动力大减QAQ 但是日子还是要过 Blog还是要写TAT[啜泣]   本该上学期就应该开始学的东西被我拖...
  • u012392937
  • u012392937
  • 2013年11月09日 09:26
  • 462

Chapter 1 - 访问命令行

Chapter 1 - 访问命令行
  • u013603102
  • u013603102
  • 2017年08月02日 21:21
  • 51


  • killy_uc
  • killy_uc
  • 2014年04月04日 10:19
  • 1504

【Java Tutorial】: Getting Started(开始入门)【官方原版教程】

入门: 这个页面内容提供了你需要了解并开始使用Java编程语言的一切。
  • RuingMan
  • RuingMan
  • 2016年02月05日 17:58
  • 1543
您举报文章:Microsoft Agent Tutorial Chapter 1