XSpeechSynthesizerCreateStreamFromSsml
Cria um fluxo de síntese de fala a partir do SSML especificado.Sintaxe
Parâmetros
speechSynthesizer _In_Tipo: XSpeechSynthesizerHandle
O sintetizador de fala a ser usado. ssml _In_z_
Tipo: char* O texto modificado por SSML a ser falado. Para obter detalhes sobre a marcação SSML, consulte as recomendações do W3C.
Esta API exige que os chamadores usem a versão 1.0 do SSML.
Tipo: XSpeechSynthesizerStreamHandle* Um fluxo de síntese de fala que representa a fala gerada a partir do texto sem formatação especificado em text.
Valor retornado
Tipo: HRESULT Retorna S_OK se for bem-sucedida; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro. Se a função falhar porque o fluxo do sintetizador de fala é maior que o tamanho máximo de dados, o valor retornado será definido como E_BOUNDS.Comentários
Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
-
Use esta função para sintetizar fala a partir de texto sem formatação e gerar dados de áudio no formato de contêiner WAVE (tipo MIME
audio/wav). Depois de usar esta função para criar um fluxo do sintetizador de fala e sintetizar fala a partir de texto sem formatação, use as funções XSpeechSynthesizerGetStreamDataSize e XSpeechSynthesizerGetStreamData para recuperar os dados de áudio do fluxo do sintetizador de fala. Use a função XSpeechSynthesizerCloseStreamHandle para fechar o fluxo do sintetizador de fala depois de recuperar os dados de áudio. - O tamanho máximo de dados de um fluxo do sintetizador de fala é 0xffffffff bytes: quatro gigabytes menos um byte. Ocorrerá um erro se você tentar criar um fluxo do sintetizador de fala maior que o tamanho máximo de dados.
- Para evitar vazamentos de memória, chame a função XSpeechSynthesizerCloseStreamHandle para fechar um identificador de fluxo do sintetizador de fala depois de concluir todas as operações que estão usando o identificador. Todas as operações assíncronas pendentes devem ser concluídas antes que esta função seja chamada.
- Para obter um exemplo que demonstra como usar a função XSpeechSynthesizerCreateStreamFromSsml, consulte XSpeechSynthesizerCreate.
Requisitos
Cabeçalho: XSpeechSynthesizer.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
XAccessibilityXSpeechSynthesizerCloseStreamHandle
XSpeechSynthesizer
