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自动化服务角度出发的最基本的使用方法。