Compartir a través de

IAgentCharacterEx::GetTTSModeID

  • Artículo

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].

HRESULT GetTTSModeID(
   BSTR * pbszModeID  // address of TTS engine ID
);

Recupera el identificador de modo del motor de TTS establecido para el carácter.

  • Devuelve S_OK para indicar que la operación se realizó correctamente.

pbszModeID

Dirección de un BSTR que recibe la configuración de identificador de modo del motor de TTS para el carácter.

Esta configuración devuelve el identificador de modo del motor de TTS (texto a voz) para la salida hablada de un carácter. El identificador de modo de un motor de TTS es una representación de cadena del GUID (con formato de llaves y guiones) definido por el proveedor de voz que identifica de forma única el motor. Para obtener más información, consulte la documentación del SDK de Voz de Microsoft. Al consultar esta propiedad, se cargará el motor asociado si aún no está cargado.

Si no establece un identificador de modo del motor de TTS para el carácter, el servidor intenta devolver un motor que coincida (mediante interfaces de Microsoft Speech API), la configuración de TTS compilada del carácter y la configuración de idioma actual del carácter. Si son diferentes, la configuración de idioma del carácter invalida su configuración de modo creado. Si no ha establecido la configuración de idioma del carácter, el idioma del carácter es el identificador de idioma predeterminado del usuario y el servidor intenta la coincidencia en función de ese identificador de idioma.

Esta función no produce un error si IAgentAudioObjectProperties::GetEnabled devuelve False.

Esta propiedad solo se aplica al uso del carácter de la aplicación cliente; la configuración no afecta a otros clientes del carácter u otros caracteres de la aplicación cliente.

Los requisitos del motor de voz de Microsoft Agent se basan en Microsoft Speech API. Los motores que admiten los requisitos de SAPI de Microsoft Agent se pueden instalar y usar con el Agente.

Consulte también

IAgentCharacterEx::SetTTSModeID