Partilhar via


SpeechConfig Classe

Classe que define configurações para o reconhecimento de voz/intenção e sintetização de voz.

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

  • da subscrição: transmitir uma chave de subscrição e uma região

  • do ponto final: transmita um ponto final. A chave de subscrição ou o token de autorização são opcionais.

  • do anfitrião: transmita um endereço de anfitrião. A chave de subscrição ou o token de autorização são opcionais.

  • do token de autorização: transmitir 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

Name Description
subscription

A chave de subscrição.

valor predefinido: None
region

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

valor predefinido: None
endpoint

O ponto final de serviço ao qual se ligar.

valor predefinido: None
host

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

valor predefinido: None
auth_token

O token de autorização.

valor predefinido: None
speech_recognition_language

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

valor predefinido: None

Métodos

enable_audio_logging

Ativa o registo de áudio no serviço. Os registos de áudio e conteúdo são armazenados no armazenamento da Microsoft ou na sua própria conta de armazenamento ligada à sua subscrição dos Serviços Cognitivos (recurso de Voz ativado bring Your Own Storage (BYOS).

Nota

Adicionado na versão 1.5.0.

enable_dictation

Ativa o ditado. Apenas suportado no reconhecimento contínuo de voz.

Nota

Adicionado na versão 1.5.0.

get_property

Obtenha uma propriedade por ID.

get_property_by_name

Obtenha uma propriedade por nome.

request_word_level_timestamps

Inclui carimbos de data/hora ao nível da palavra no resultado da resposta.

Nota

Adicionado na versão 1.5.0.

set_profanity

Defina a opção de palavrões.

Nota

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

Defina as informações do proxy.

Nota

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

esta plataforma.

set_service_property

Define um valor de propriedade que será transmitido para o serviço com o canal especificado.

Nota

Adicionado na versão 1.5.0.

set_speech_synthesis_output_format

Defina o formato de áudio de saída da sintetização de voz.

enable_audio_logging

Ativa o registo de áudio no serviço. Os registos de áudio e conteúdo são armazenados no armazenamento da Microsoft ou na sua própria conta de armazenamento ligada à sua subscrição dos Serviços Cognitivos (recurso de Voz ativado bring Your Own Storage (BYOS).

Nota

Adicionado na versão 1.5.0.

enable_audio_logging()

enable_dictation

Ativa o ditado. Apenas suportado no reconhecimento contínuo de voz.

Nota

Adicionado na versão 1.5.0.

enable_dictation()

get_property

Obtenha uma propriedade por ID.

get_property(property_id: PropertyId) -> str

Parâmetros

Name Description
property_id
Necessário

O ID da propriedade a obter.

Devoluções

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

Name Description
property_name
Necessário

O nome da propriedade a obter.

Devoluções

Tipo Description

O valor da propriedade.

request_word_level_timestamps

Inclui carimbos de data/hora ao nível da palavra no resultado da resposta.

Nota

Adicionado na versão 1.5.0.

request_word_level_timestamps()

set_profanity

Defina a opção de palavrões.

Nota

Adicionado na versão 1.5.0.

set_profanity(profanity_option: ProfanityOption) -> None

Parâmetros

Name Description
profanity_option
Necessário

O nível de profanidade a definir.

set_properties

Defina várias propriedades por ID.

set_properties(properties: Dict[PropertyId, str])

Parâmetros

Name Description
properties
Necessário

Um dict mapping property ids to the values to the values to be set.

set_properties_by_name

Defina várias propriedades por nome.

set_properties_by_name(properties: Dict[str, str])

Parâmetros

Name Description
properties
Necessário

Um dict mapping property ids to the values to the values to be set.

set_property

Defina uma propriedade por ID.

set_property(property_id: PropertyId, value: str)

Parâmetros

Name Description
property_id
Necessário

O ID da propriedade a definir.

value
Necessá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

Name Description
property_name
Necessário

O nome da propriedade a definir.

value
Necessário

O valor a ser definido para a propriedade.

set_proxy

Defina as informações do proxy.

Nota

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

esta plataforma.

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

Parâmetros

Name Description
hostname
Necessário

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

port
Necessário

O número de porta do servidor proxy.

username

O nome de utilizador do servidor proxy.

valor predefinido: None
password

A palavra-passe do servidor proxy.

valor predefinido: None

set_service_property

Define um valor de propriedade que será transmitido para o serviço com o canal especificado.

Nota

Adicionado na versão 1.5.0.

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

Parâmetros

Name Description
name
Necessário

O nome da propriedade.

value
Necessário

O valor da propriedade.

channel
Necessário

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

set_speech_synthesis_output_format

Defina o formato de áudio de saída da sintetização de voz.

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

Parâmetros

Name Description
format_id
Necessário

O ID do formato de áudio, por exemplo, Riff16Khz16BitMonoPcm.

Atributos

authorization_token

O token de autorização que será utilizado para ligar ao serviço.

Nota

O autor da chamada tem de garantir que o token de autorização é válido. Antes da

o token de autorização expira, o autor da chamada tem de o atualizar ao chamar este setter com um

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

o novo valor de token não se aplicará aos reconhecedores que já tenham sido criados. Para o

reconhecedores que tenham sido criados anteriormente, tem de definir o token de autorização do

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

durante o reconhecimento.

endpoint_id

O ID do ponto final.

output_format

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

region

A chave de região que foi utilizada para criar o Reconhecedor.

speech_recognition_language

O nome do idioma falado a ser reconhecido no formato BCP-47.

speech_synthesis_language

Obter linguagem de sintetização de voz.

speech_synthesis_output_format_string

Obter a cadeia de formato de áudio de saída da sintetização de voz.

speech_synthesis_voice_name

Obtenha o nome de voz da sintetização de voz.

subscription_key

A chave de subscrição que foi utilizada para criar o Reconhecedor.