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.