使用Microsoft Agent的COM接口编程

　　前面介绍的是调用Microsoft Agent服务器最基本的一些步骤，为了完成比较实际的任务，客户程序还应根据自己的情况考虑下面的一些编程要点。 　　 1．检查Agent Server的版本

　　OLE要求组件或对象具有向后兼容性，高版本对象支持低版本对象的所有接口和属性，这样可以很方便地进行组件升级。客户程序通常应检查对象的版本，只有系统中安装的对象的版本号高于或等于所期望的版本号时才能调用对象。下面的IsValidAgentVersion（）函数检查Microsoft Agent的版本号，并将它与定义在AgtSvr.h文件中的版本号相比较：

　　 2．实现IAgentNotifySink接口

　　为了能够处理用户的输入，了解Agent对象的状态，客户程序应实现IAgentNotifySink接口来接收Agent对象的事件。IAgentNotifySink的声明和缺省实现可以在Platform SDK或Internet Clinet SDK中的Notify.h和Notify.cpp中找到，客户程序应根据需要修改某些事件的处理函数
。下面的代码向Agent对象注册IAgentNotifySink接口，其中AgentNotifySink是从IAgentNotifySink继承而来：

　　客户程序最感兴趣的两个事件是RequestComplete和Command。Agent服务器采用异步方式来处理客户程序的各种请求，这样客户程序可以在请求服务的同时进行自己的工作，当服务器完成一项请求时就会激发RequestComplete事件，客户程序可以判断是哪一项请求已经结束，并做相应的处理。Command事件是当用户使用鼠标或麦克风向动画人物发出命令时激发的，客户程序可以通过IAgentUserInput接口来了解命令的具体信息。

　　 3．自定义命令

　　Agent服务器为每个动画人物都提供了一些缺省的命令，这些命令出现在关联菜单或命令窗口中，客户程序可以通过IAgentCommands接口添加自定义命令。

　　为了得到IAgentCommands的接口指针，应使用参数IID—IAgentCommands来调用IAgentCharacter::QueryInterface（），IAgentCommands的Add（）或Insert（）方法可以加入自定义命令，同时设置Caption、Visible和Voice属性，指明该命令是否显示出来，显示在关联菜单中还是在命令窗口中。

　　Agent服务器为每个命令赋予一个ID值，客户程序可以使用这个ID值调用IAgentCommands::GetCommand（）方法，得到每个命令的IAgentCommand接口指针，从而对单个命令的各种属性进行调整。

　　 4． WAV文件代替语音合成

　　Microsoft Agent目前只支持英语的语音合成功能，要输出中文时只能用WAV文件来代替。如果给IAgentCharacter::Speak（）方法的第二个参数传递一个WAV文件的路径，那么Agent服务器自动播放这个WAV文件，并在文字气球中显示出第一个参数中包含的文字，如果给第二个参数传递一个带音节信息的LWV文件的路径，则不需要在第一个参数中提供文字，因为LWV文件中包含有文字信息。当使用LWV文件时，动画人物的嘴部动作能与输出的语音保持一致，所以在可能的情况应该尽量使用LWV文件，这种格式的文件可用Microsoft Agent Linguistic Information Sound Editing Tool编辑WAV文件来生成。

　　 5．其它一些COM接口

　　除了前面提到的接口外，Agent服务器还有其它一些COM接口。IAgentCommandWindow允许客户程序访问或设置命令窗口的属性，包括位置、大小和是否可见。IAgentSpeechInputProperties允许客户程序访问语音输入功能的属性，其中大部分属性都是只读的。IAgentAudioOutputProperties允许客户程序读取语音输出功能的部分属性。IAg
entPropertySheet允许客户程序访问或设置Agent服务器的属性表。IAgentBalloon允许客户程序访问文字气球的属性，可以设置少数属性，如是否可见和字体名称。关于这些接口的具体定义和用途请参考Microsoft Agent的帮助文档。

　　总 结

　　Microsoft Agent是一项较新的技术，它属于OLE的范畴，涉及较深的编程理论，本文所介绍的只是从OLE自动化服务角度出发的最基本的使用方法。

查看本文来源