IAgentCommands
[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]
Microsoft 에이전트 서버는 사용자가 현재 사용할 수 있는 명령 목록을 유지 관리합니다. 이 목록에는 숨기기 및 Microsoft 에이전트 속성, 사용 가능한(입력이 아닌) 클라이언트 목록 및 현재 활성 클라이언트에서 정의한 명령과 같은 일반적인 상호 작용을 위해 서버가 정의하는 명령이 포함됩니다. 처음 두 명령 집합은 전역 명령입니다. 즉, 입력 활성 클라이언트에 관계없이 언제든지 사용할 수 있습니다. 클라이언트 정의 명령은 해당 클라이언트가 입력 활성인 경우에만 사용할 수 있습니다.
IAgentCommands에 대한 IAgentCharacter 인터페이스를 쿼리하여 IAgentCommands 인터페이스를 검색합니다. 각 Microsoft 에이전트 클라이언트 애플리케이션은 Commands 컬렉션이라는 명령 컬렉션을 정의할 수 있습니다. 컬렉션에 명령을 추가하려면 Add 또는 Insert 메서드를 사용합니다. IAgentCommand 메서드를 사용하여 명령의 속성을 지정할 수 있지만 최적의 코드 성능을 위해 처음에 새 Command의 속성을 설정할 때 IAgentCommands::Add 또는 IAgentCommands::Insert 메서드에서 명령의 모든 속성을 지정합니다. IAgentCommand 메서드를 사용하여 속성 설정을 쿼리하거나 변경할 수 있습니다.
Commands 컬렉션의 각 명령에 대해 명령이 문자의 팝업 메뉴, 음성 명령 창, 둘 다 또는 둘 다에 표시되는지 여부를 확인할 수 있습니다. 예를 들어 명령이 문자의 팝업 메뉴에 표시되도록 하려면 명령의 Caption 및 Visible 속성을 설정합니다. 음성 명령 창에 명령을 표시하려면 명령의 캡션 및 음성 속성을 설정합니다.
사용자는 클라이언트 애플리케이션이 입력 활성이고 문자가 표시되는 경우에만 Commands 컬렉션의 개별 명령에 액세스할 수 있습니다. 따라서 일반적으로 Commands 컬렉션 개체 및 컬렉션의 명령에 대한 Caption, VoiceCaption 및 Voice 속성을 설정하려고 합니다. 이 속성은 캐릭터의 팝업 메뉴와 음성 명령 창에 Commands 컬렉션에 대한 항목을 배치하기 때문입니다. 사용자가 명령 항목을 선택하여 클라이언트로 전환하면 서버는 자동으로 클라이언트 입력을 활성화하고 IAgentNotifySink::ActivateInputState 를 사용하여 클라이언트 애플리케이션에 알리고 컬렉션의 명령을 사용할 수 있게 합니다. 또한 서버는 IAgentNotifySink::ActivateInputState 이벤트를 사용하여 더 이상 입력 활성이 아닌 클라이언트에 알린다. 이렇게 하면 서버가 현재 입력 활성 클라이언트의 컨텍스트에 적용되는 명령 만 표시하고 수락할 수 있습니다. 또한 클라이언트 간의 명령 이름 충돌을 방지하는 역할을 합니다.
또한 클라이언트는 IAgentCharacter::Activate 메서드를 사용하여 입력 활성 클라이언트를 만들도록 명시적으로 요청할 수도 있습니다. 또한 이 메서드는 애플리케이션을 입력 활성 클라이언트가 아닌 것으로 설정하는 것도 지원합니다. 다른 애플리케이션과 문자를 공유할 때 이 메서드를 사용하여 애플리케이션 창이 포커스를 받을 때 애플리케이션이 입력 활성으로 설정되고 포커스가 손실될 때 입력이 활성화되지 않도록 설정할 수 있습니다.
마찬가지로 IAgentCharacter::Activate 를 사용하여 애플리케이션을 문자의 활성 클라이언트로 설정할 수 있습니다. 활성 클라이언트는 해당 문자가 최상위 문자일 때 입력을 받는 클라이언트입니다. 이 상태 변경되면 서버는 IAgentNotifySinkEx::ActiveClientChange 이벤트를 사용하여 애플리케이션에 알린다.
캐릭터의 팝업 메뉴가 표시되면 사용자가 메뉴를 다시 표시할 때까지 Commands 컬렉션의 속성이나 컬렉션의 명령이 변경되지 않습니다. 그러나 열면 음성 명령 창에 변경 내용이 표시됩니다.
IAgentCommands 는 애플리케이션이 Commands 컬렉션에 대한 속성을 추가, 제거, 설정 및 쿼리할 수 있는 인터페이스를 정의합니다. 이러한 함수는 IAgentCommandsEx에서도 사용할 수 있습니다.
Commands 컬렉션은 팝업 메뉴와 문자의 음성 명령 창 모두에서 명령으로 표시할 수 있습니다. Commands 컬렉션을 표시하려면 해당 Caption 속성을 설정해야 합니다. 다음 표에서는 Commands 컬렉션의 속성이 프레젠테이션에 미치는 영향을 요약합니다.
| Caption 속성 | Voice-Caption 속성 | Voice 속성 | Visible 속성 | 문자의 팝업 메뉴에 나타납니다. | 음성 명령 창에 표시 |
|---|---|---|---|---|---|
| Yes | Yes | Yes | True | 예, 캡션 사용 | 예, VoiceCaption 사용 |
| Yes | Yes | No 5 | True | 예, 캡션 사용 | 아니요 |
| 예 | Yes | 예 | False | 예 | 예, VoiceCaption 사용 |
| Yes | Yes | No 5 | False | 예 | 아니요 |
| No 5 | Yes | Yes | True | 아니요 | 예, VoiceCaption 사용 |
| No 5 | Yes | 예 | False | 예 | 예, VoiceCaption 사용 |
| No 5 | Yes | No 5 | True | 아니요 | 아니요 |
| No 5 | Yes | No 5 | False | 예 | 아니요 |
| 예 | No 5 | Yes | True | 예, 캡션 사용 | 예, 캡션 사용 |
| Yes | No 5 | No 5 | True | 예 | 아니요 |
| 예 | No | 예 | False | 예 | 예, 캡션 사용 |
| Yes | No | No | False | 예 | 아니요 |
| No | No | Yes | True | 아니요 | No² |
| No | No | 예 | False | 예 | No² |
| No | No | No | True | 아니요 | 아니요 |
| No | No | No | False | 예 | 아니요 |
요 속성 설정이 null이면 일부 프로그래밍 언어에서는 빈 문자열이 null 문자열과 동일하게 해석되지 않을 수 있습니다.
²명령은 여전히 음성으로 액세스할 수 있습니다.
Vtable 순서의 메서드
| IAgentCommands 메서드 | 설명 |
|---|---|
| GetCommand | Commands 컬렉션에서 Command 개체를 검색합니다. |
| GetCount | Commands 컬렉션의 Commands 수 값을 반환합니다. |
| SetCaption | Commands 컬렉션의 Caption 속성 값을 설정합니다. |
| GetCaption | Commands 컬렉션의 Caption 속성 값을 반환합니다. |
| SetVoice | Commands 컬렉션의 Voice 속성 값을 설정합니다. |
| GetVoice | Commands 컬렉션의 Voice 속성 값을 반환합니다. |
| SetVisible | Commands 컬렉션의 Visible 속성 값을 설정합니다. |
| GetVisible | Commands 컬렉션의 Visible 속성 값을 반환합니다. |
| 추가 | Commands 컬렉션에 Command 개체를 추가합니다. |
| 삽입 | Commands 컬렉션에 Command 개체를 삽입합니다. |
| 제거 | Commands 컬렉션에서 Command 개체를 제거합니다. |
| Removeall | Commands 컬렉션에서 모든 Command 개체를 제거합니다. |