使用Microsoft Agent的COM接口编程 （4）

    来源：赛迪论坛    作者：guang

pSink = new AgentNotifySink;
pSink－>AddRef（）; //增加引用计数
hRes = pAgent－>Register（（IUnknown ＊）pSink, ＆lNotifySinkID）;//进行注册
...
if （pSink） {
pAgent－>Unregister（lNotifySinkID）; //注销IAgentNotifySink接口
pSink－>Release（）; }

客户程序最感兴趣的两个事件是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自动化服务角度出发的最基本的使用方法。