SpeechConfig Класс

Класс, определяющий конфигурации для распознавания речи и намерения и синтеза речи.

Конфигурацию можно инициализировать разными способами:

• из подписки: передача ключа подписки и региона

• из конечной точки: передайте конечную точку. Ключ подписки или маркер авторизации являются необязательными.

• из узла: передайте адрес узла. Ключ подписки или маркер авторизации являются необязательными.

• из маркера авторизации: передача маркера авторизации и региона

Наследование

builtins.object

SpeechConfig

Конструктор

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)

Параметры

Имя	Описание
subscription	Ключ подписки. значение по умолчанию: None
region	Имя региона (см. страницу региона). значение по умолчанию: None
endpoint	Конечная точка службы для подключения. значение по умолчанию: None
host	Узел службы, к которому необходимо подключиться. Предполагается стандартный путь к ресурсу. Формат — "protocol://host:port", где ":p ort" является необязательным. значение по умолчанию: None
auth_token	Маркер авторизации. значение по умолчанию: None
speech_recognition_language	Язык ввода для распознавания речи. Язык указан в формате BCP-47. значение по умолчанию: None

Методы

enable_audio_logging	Включает ведение журнала звука в службе. Журналы звука и содержимого хранятся либо в хранилище, принадлежащее Корпорации Майкрософт, либо в вашей учетной записи хранения, связанной с вашей подпиской Cognitive Services (ресурс службы "Речь" с поддержкой BYOS). Примечание Добавлено в версии 1.5.0.
enable_dictation	Включает диктовку. Поддерживается только в непрерывном распознавании речи. Примечание Добавлено в версии 1.5.0.
get_property	Получение свойства по идентификатору.
get_property_by_name	Получение свойства по имени.
request_word_level_timestamps	Включает метки времени на уровне слов в результат ответа. Примечание Добавлено в версии 1.5.0.
set_profanity	Задайте параметр ненормативной лексики. Примечание Добавлено в версии 1.5.0.
set_properties	Задайте несколько свойств по идентификатору.
set_properties_by_name	Задайте несколько свойств по имени.
set_property	Задайте свойство по идентификатору.
set_property_by_name	Задайте свойство по имени.
set_proxy	Задайте сведения о прокси-сервере. Примечание Функции прокси-сервера недоступны в macOS. Эта функция не будет влиять на эта платформа.
set_service_property	Задает значение свойства, которое будет передано службе с помощью указанного канала. Примечание Добавлено в версии 1.5.0.
set_speech_synthesis_output_format	Задайте выходной аудиоформат синтеза речи.

enable_audio_logging

Включает ведение журнала звука в службе. Журналы звука и содержимого хранятся либо в хранилище, принадлежащее Корпорации Майкрософт, либо в вашей учетной записи хранения, связанной с вашей подпиской Cognitive Services (ресурс службы "Речь" с поддержкой BYOS).

Примечание

Добавлено в версии 1.5.0.

enable_audio_logging()

enable_dictation

Включает диктовку. Поддерживается только в непрерывном распознавании речи.

Примечание

Добавлено в версии 1.5.0.

enable_dictation()

get_property

Получение свойства по идентификатору.

get_property(property_id: PropertyId) -> str

Параметры

Имя	Описание
property_id Обязательно	Идентификатор извлекаемого свойства.

Возвращаемое значение

Тип	Описание
	Значение свойства.

get_property_by_name

Получение свойства по имени.

get_property_by_name(property_name: str) -> str

Параметры

Имя	Описание
property_name Обязательно	Имя извлекаемого свойства.

Возвращаемое значение

Тип	Описание
	Значение свойства.

request_word_level_timestamps

Включает метки времени на уровне слов в результат ответа.

Примечание

Добавлено в версии 1.5.0.

request_word_level_timestamps()

set_profanity

Задайте параметр ненормативной лексики.

Примечание

Добавлено в версии 1.5.0.

set_profanity(profanity_option: ProfanityOption) -> None

Параметры

Имя	Описание
profanity_option Обязательно	Устанавливаемая ненормативная лексика.

set_properties

Задайте несколько свойств по идентификатору.

set_properties(properties: Dict[PropertyId, str])

Параметры

Имя	Описание
properties Обязательно	Словарь, сопоставляющий идентификаторы свойств со значениями, которые необходимо задать.

set_properties_by_name

Задайте несколько свойств по имени.

set_properties_by_name(properties: Dict[str, str])

Параметры

Имя	Описание
properties Обязательно	Словарь, сопоставляющий идентификаторы свойств со значениями, которые необходимо задать.

set_property

Задайте свойство по идентификатору.

set_property(property_id: PropertyId, value: str)

Параметры

Имя	Описание
property_id Обязательно	Идентификатор устанавливаемого свойства.
value Обязательно	Значение, устанавливаемое для свойства .

set_property_by_name

Задайте свойство по имени.

set_property_by_name(property_name: str, value: str)

Параметры

Имя	Описание
property_name Обязательно	Имя устанавливаемого свойства.
value Обязательно	Значение, устанавливаемое для свойства .

set_proxy

Задайте сведения о прокси-сервере.

Примечание

Функции прокси-сервера недоступны в macOS. Эта функция не будет влиять на

эта платформа.

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

Параметры

Имя	Описание
hostname Обязательно	Имя узла прокси-сервера. Не добавляйте сведения о протоколе (HTTP) к имени узла.
port Обязательно	Номер порта прокси-сервера.
username	Имя пользователя прокси-сервера. значение по умолчанию: None
password	Пароль прокси-сервера. значение по умолчанию: None

set_service_property

Задает значение свойства, которое будет передано службе с помощью указанного канала.

Примечание

Добавлено в версии 1.5.0.

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

Параметры

Имя	Описание
name Обязательно	Имя свойства.
value Обязательно	Значение свойства.
channel Обязательно	Канал, используемый для передачи указанного свойства в службу.

set_speech_synthesis_output_format

Задайте выходной аудиоформат синтеза речи.

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

Параметры

Имя	Описание
format_id Обязательно	Идентификатор аудиоформата, например Riff16Khz16BitMonoPcm.

Атрибуты

authorization_token

Маркер авторизации, который будет использоваться для подключения к службе.

Примечание

Вызывающий объект должен убедиться, что маркер авторизации действителен. Перед

срок действия маркера авторизации истекает, вызывающий объект должен обновить его, вызвав этот метод задания с помощью

новый допустимый маркер. При копировании значений конфигурации при создании нового распознавателя

Новое значение токена не будет применяться к уже созданным распознавателям. Для

Распознаватели, созданные ранее, необходимо задать маркер авторизации для

соответствующий распознаватель для обновления маркера. В противном случае распознаватели столкнутся

ошибки во время распознавания.

endpoint_id

Идентификатор конечной точки.

output_format

Формат вывода (простой или подробный) результата распознавания речи.

region

Ключ региона, который использовался для создания Распознавателя.

speech_recognition_language

Имя устного языка, распознаваемого в формате BCP-47.

speech_synthesis_language

Получение языка синтеза речи.

speech_synthesis_output_format_string

Получение строки аудиоформата вывода синтеза речи.

speech_synthesis_voice_name

Получение имени голоса синтеза речи.

subscription_key

Ключ подписки, который использовался для создания Распознавателя.