SpeechConfig Classe

Classe que define configurações para reconhecimento de fala/intenção e síntese de fala.

A configuração pode ser inicializada de diferentes maneiras:

  • da assinatura: passar uma chave de assinatura e uma região

  • do ponto de extremidade: passe um ponto de extremidade. A chave de assinatura ou o token de autorização são opcionais.

  • do host: passe um endereço de host. A chave de assinatura ou o token de autorização são opcionais.

  • do token de autorização: passe um token de autorização e uma região

Herança
builtins.object
SpeechConfig

Construtor

SpeechConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, speech_recognition_language: str | None = None)

Parâmetros

Nome Description
subscription

A chave de assinatura.

valor padrão: None
region

O nome da região (consulte a página região).

valor padrão: None
endpoint

O ponto de extremidade de serviço ao qual se conectar.

valor padrão: None
host

O host de serviço ao qual se conectar. O caminho do recurso padrão será assumido. O formato é "protocol://host:port" em que ":p ort" é opcional.

valor padrão: None
auth_token

O token de autorização.

valor padrão: None
speech_recognition_language

O idioma de entrada para o reconhecimento de fala. O idioma é especificado no formato BCP-47.

valor padrão: None

Métodos

enable_audio_logging

Habilita o log de áudio no serviço. Os logs de áudio e conteúdo são armazenados no armazenamento de propriedade da Microsoft ou em sua própria conta de armazenamento vinculada à sua assinatura dos Serviços Cognitivos (recurso de Fala habilitado para BYOS (Bring Your Own Storage).

Observação

Adicionado na versão 1.5.0.

enable_dictation

Habilita o ditado. Só há suporte no reconhecimento contínuo de fala.

Observação

Adicionado na versão 1.5.0.

get_property

Obter uma propriedade por id.

get_property_by_name

Obtenha uma propriedade por nome.

request_word_level_timestamps

Inclui carimbos de data/hora no nível do word no resultado da resposta.

Observação

Adicionado na versão 1.5.0.

set_profanity

Defina a opção de palavrões.

Observação

Adicionado na versão 1.5.0.

set_properties

Defina várias propriedades por id.

set_properties_by_name

Defina várias propriedades por nome.

set_property

Defina uma propriedade por id.

set_property_by_name

Defina uma propriedade por nome.

set_proxy

Definir informações de proxy.

Observação

A funcionalidade de proxy não está disponível no macOS. Essa função não terá efeito sobre

essa plataforma.

set_service_property

Define um valor de propriedade que será passado para o serviço usando o canal especificado.

Observação

Adicionado na versão 1.5.0.

set_speech_synthesis_output_format

Definir formato de áudio de saída de síntese de fala.

enable_audio_logging

Habilita o log de áudio no serviço. Os logs de áudio e conteúdo são armazenados no armazenamento de propriedade da Microsoft ou em sua própria conta de armazenamento vinculada à sua assinatura dos Serviços Cognitivos (recurso de Fala habilitado para BYOS (Bring Your Own Storage).

Observação

Adicionado na versão 1.5.0.

enable_audio_logging()

enable_dictation

Habilita o ditado. Só há suporte no reconhecimento contínuo de fala.

Observação

Adicionado na versão 1.5.0.

enable_dictation()

get_property

Obter uma propriedade por id.

get_property(property_id: PropertyId) -> str

Parâmetros

Nome Description
property_id
Obrigatório

A ID da propriedade a ser recuperada.

Retornos

Tipo Description

O valor da propriedade.

get_property_by_name

Obtenha uma propriedade por nome.

get_property_by_name(property_name: str) -> str

Parâmetros

Nome Description
property_name
Obrigatório

O nome da propriedade a ser recuperada.

Retornos

Tipo Description

O valor da propriedade.

request_word_level_timestamps

Inclui carimbos de data/hora no nível do word no resultado da resposta.

Observação

Adicionado na versão 1.5.0.

request_word_level_timestamps()

set_profanity

Defina a opção de palavrões.

Observação

Adicionado na versão 1.5.0.

set_profanity(profanity_option: ProfanityOption) -> None

Parâmetros

Nome Description
profanity_option
Obrigatório

O nível de profanação a ser definido.

set_properties

Defina várias propriedades por id.

set_properties(properties: Dict[PropertyId, str])

Parâmetros

Nome Description
properties
Obrigatório

Uma propriedade de mapeamento de ditado ids para os valores a serem definidos.

set_properties_by_name

Defina várias propriedades por nome.

set_properties_by_name(properties: Dict[str, str])

Parâmetros

Nome Description
properties
Obrigatório

Uma propriedade de mapeamento de ditado ids para os valores a serem definidos.

set_property

Defina uma propriedade por id.

set_property(property_id: PropertyId, value: str)

Parâmetros

Nome Description
property_id
Obrigatório

A ID da propriedade a ser definida.

value
Obrigatório

O valor a ser definido para a propriedade .

set_property_by_name

Defina uma propriedade por nome.

set_property_by_name(property_name: str, value: str)

Parâmetros

Nome Description
property_name
Obrigatório

O nome da propriedade a ser definida.

value
Obrigatório

O valor a ser definido para a propriedade .

set_proxy

Definir informações de proxy.

Observação

A funcionalidade de proxy não está disponível no macOS. Essa função não terá efeito sobre

essa plataforma.

set_proxy(hostname: str, port: int, username: str = None, password: str = None)

Parâmetros

Nome Description
hostname
Obrigatório

O nome do host do servidor proxy. Não adicione informações de protocolo (http) ao nome do host.

port
Obrigatório

O número da porta do servidor proxy.

username

O nome de usuário do servidor proxy.

valor padrão: None
password

A senha do servidor proxy.

valor padrão: None

set_service_property

Define um valor de propriedade que será passado para o serviço usando o canal especificado.

Observação

Adicionado na versão 1.5.0.

set_service_property(name: str, value: str, channel: ServicePropertyChannel)

Parâmetros

Nome Description
name
Obrigatório

O nome da propriedade.

value
Obrigatório

O valor da propriedade.

channel
Obrigatório

O canal usado para passar a propriedade especificada para o serviço.

set_speech_synthesis_output_format

Definir formato de áudio de saída de síntese de fala.

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

Parâmetros

Nome Description
format_id
Obrigatório

A ID de formato de áudio, por exemplo, Riff16Khz16BitMonoPcm.

Atributos

authorization_token

O token de autorização que será usado para se conectar ao serviço.

Observação

O chamador precisa garantir que o token de autorização seja válido. Antes do

o token de autorização expira, o chamador precisa atualizá-lo chamando esse setter com um

novo token válido. Como os valores de configuração são copiados ao criar um novo reconhecedor, o

O novo valor do token não se aplicará aos reconhecedores que já foram criados. For (para)

reconhecedores que foram criados antes, você precisa definir o token de autorização do

reconhecedor correspondente para atualizar o token. Caso contrário, os reconhecedores encontrarão

erros durante o reconhecimento.

endpoint_id

A ID do ponto de extremidade.

output_format

O formato de saída (simples ou detalhado) do resultado do reconhecimento de fala.

region

A chave de região usada para criar o Reconhecedor.

speech_recognition_language

O nome da linguagem falada a ser reconhecida no formato BCP-47.

speech_synthesis_language

Obter linguagem de síntese de fala.

speech_synthesis_output_format_string

Obter cadeia de caracteres de formato de áudio de saída de síntese de fala.

speech_synthesis_voice_name

Obter o nome da voz da síntese de fala.

subscription_key

A chave de assinatura usada para criar o Reconhecedor.