Поделиться через


SpeechConfig class

Настройка речи.

Свойства

authorizationToken

Возвращает маркер авторизации.

endpointId

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

outputFormat

Получает формат вывода распознавания речи (простой или подробный). Примечание. Этот формат выходных данных предназначен для результата распознавания речи, используйте [SpeechConfig.speechSynthesisOutputFormat], чтобы получить синтезированный формат вывода звука.

region
speechRecognitionLanguage

Возвращает настроенный язык.

speechSynthesisLanguage

Получает язык синтезатора речи. Добавлено в версию 1.11.0.

speechSynthesisOutputFormat

Возвращает формат выходных данных синтеза речи. Добавлено в версию 1.11.0.

speechSynthesisVoiceName

Получает голос синтезатора речи. Добавлено в версию 1.11.0.

subscriptionKey
tokenCredential

Получает экземпляр TokenCredential, если он настроен. Доступно только при использовании аутентификации на основе AAD через TokenCredential.

Методы

close()

Закрывает конфигурацию.

enableAudioLogging()

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

enableDictation()

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

fromAuthorizationToken(string, string)

Создает экземпляр фабрики речи с указанным начальным маркером авторизации и регионом. Примечание. Вызывающий объект должен убедиться, что маркер авторизации действителен. Прежде чем срок действия маркера авторизации истекает, вызывающий объект должен обновить его, вызвав этот метод задания с новым допустимым маркером. Примечание: Поскольку значения конфигурации копируются при создании нового распознавателя, новое значение маркера не будет применяться к распознавателям, которые уже были созданы. Для распознавателей, созданных ранее, необходимо задать маркер авторизации соответствующего распознавателя для обновления маркера. В противном случае распознаватели будут сталкиваться с ошибками во время распознавания.

fromEndpoint(URL, any)

Создает экземпляр SpeechConfig с пользовательской конечной точкой и учетными данными. Параметры запроса, указанные в URI конечной точки, не изменяются, даже если они задаются любым другим вызовом API. Например, если язык распознавания определен в параметре запроса URI как "language=de-DE", а свойство SpeechRecognitionLanguage установлено на "en-US", язык, установленный в URI, имеет приоритет, а "de-DE" остается ожидаемым языком. Так как параметры, включенные в URI конечной точки, имеют приоритет, другие API могут задавать только те параметры, которые не указаны в URI конечной точки. Поддерживаемые типы учетных данных:

  • KeyCredential: для аутентификации на основе ключа API.
  • TokenCredential: для проверки подлинности на основе Azure AD. Примечание. Чтобы использовать маркер авторизации с помощью FromEndpoint, передайте пустую строку в subscriptionKey в методе fromEndpoint, а затем задайте authorizationToken="token" в созданном экземпляре SpeechConfig для использования маркера авторизации.
fromEndpoint(URL, string)

Создает экземпляр конфигурации речи с указанной конечной точкой и ключом подписки. Этот метод предназначен только для пользователей, использующих нестандартную конечную точку или параметры службы. Примечание. Параметры запроса, указанные в URL-адресе конечной точки, не изменяются, даже если они задаются другими API. Например, если язык определен в URI в качестве параметра запроса "language=de-DE", а также задан speechConfig.speechRecognitionLanguage = "en-US", параметр языка в URI имеет приоритет, а эффективный язык — "de-DE". Можно задать только параметры, не указанные в URL-адресе конечной точки, другими API. Примечание. Чтобы использовать маркер авторизации с помощью FromEndpoint, передайте пустую строку в subscriptionKey в методе fromEndpoint, а затем задайте authorizationToken="token" в созданном экземпляре SpeechConfig для использования маркера авторизации.

fromHost(URL, string)

Создает экземпляр конфигурации речи с указанным ключом узла и подписки. Этот метод предназначен только для пользователей, использующих узел службы, отличный от по умолчанию. Предполагается стандартный путь к ресурсу. Для служб с нестандартным путем к ресурсу или без пути вообще используйте fromEndpoint. Примечание. Параметры запроса не допускаются в URI узла и должны быть заданы другими API. Примечание. Чтобы использовать маркер авторизации с fromHost, используйте fromHost(URL), а затем задайте свойство AuthorizationToken в созданном экземпляре SpeechConfig. Примечание. Добавлено в версию 1.9.0.

fromSubscription(string, string)

Статический экземпляр SpeechConfig, возвращаемый путем передачи subscriptionKey и региона службы.

getProperty(string, string)

Возвращает текущее значение произвольного свойства.

requestWordLevelTimestamps()

Включает метки времени на уровне слова. Добавлено в версию 1.7.0.

setProfanity(ProfanityOption)

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

setProperty(string | PropertyId, string)

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

setProxy(string, number)

Задает конфигурацию прокси-сервера. Применимо только в средах Node.js. Добавлено в версию 1.4.0.

setProxy(string, number, string, string)

Задает конфигурацию прокси-сервера. Применимо только в средах Node.js. Добавлено в версию 1.4.0.

setServiceProperty(string, string, UriQueryParameter)

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

Сведения о свойстве

authorizationToken

Возвращает маркер авторизации.

string authorizationToken

Значение свойства

string

endpointId

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

string endpointId

Значение свойства

string

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

outputFormat

Получает формат вывода распознавания речи (простой или подробный). Примечание. Этот формат выходных данных предназначен для результата распознавания речи, используйте [SpeechConfig.speechSynthesisOutputFormat], чтобы получить синтезированный формат вывода звука.

OutputFormat outputFormat

Значение свойства

Возвращает выходной формат.

region

string region

Значение свойства

string

Регион, заданный в конфигурации.

speechRecognitionLanguage

Возвращает настроенный язык.

string speechRecognitionLanguage

Значение свойства

string

speechSynthesisLanguage

Получает язык синтезатора речи. Добавлено в версию 1.11.0.

string speechSynthesisLanguage

Значение свойства

string

Возвращает язык синтеза речи.

speechSynthesisOutputFormat

Возвращает формат выходных данных синтеза речи. Добавлено в версию 1.11.0.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Значение свойства

Возвращает формат выходных данных синтеза речи

speechSynthesisVoiceName

Получает голос синтезатора речи. Добавлено в версию 1.11.0.

string speechSynthesisVoiceName

Значение свойства

string

Возвращает голос синтеза речи.

subscriptionKey

string subscriptionKey

Значение свойства

string

Ключ подписки, заданный в конфигурации.

tokenCredential

Получает экземпляр TokenCredential, если он настроен. Доступно только при использовании аутентификации на основе AAD через TokenCredential.

any tokenCredential

Значение свойства

any

Сведения о методе

close()

Закрывает конфигурацию.

function close()

enableAudioLogging()

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

function enableAudioLogging()

enableDictation()

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

function enableDictation()

fromAuthorizationToken(string, string)

Создает экземпляр фабрики речи с указанным начальным маркером авторизации и регионом. Примечание. Вызывающий объект должен убедиться, что маркер авторизации действителен. Прежде чем срок действия маркера авторизации истекает, вызывающий объект должен обновить его, вызвав этот метод задания с новым допустимым маркером. Примечание: Поскольку значения конфигурации копируются при создании нового распознавателя, новое значение маркера не будет применяться к распознавателям, которые уже были созданы. Для распознавателей, созданных ранее, необходимо задать маркер авторизации соответствующего распознавателя для обновления маркера. В противном случае распознаватели будут сталкиваться с ошибками во время распознавания.

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechConfig

Параметры

authorizationToken

string

Начальный маркер авторизации.

region

string

Название региона (см. страницу региона).

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

Экземпляр фабрики речи.

fromEndpoint(URL, any)

Создает экземпляр SpeechConfig с пользовательской конечной точкой и учетными данными. Параметры запроса, указанные в URI конечной точки, не изменяются, даже если они задаются любым другим вызовом API. Например, если язык распознавания определен в параметре запроса URI как "language=de-DE", а свойство SpeechRecognitionLanguage установлено на "en-US", язык, установленный в URI, имеет приоритет, а "de-DE" остается ожидаемым языком. Так как параметры, включенные в URI конечной точки, имеют приоритет, другие API могут задавать только те параметры, которые не указаны в URI конечной точки. Поддерживаемые типы учетных данных:

  • KeyCredential: для аутентификации на основе ключа API.
  • TokenCredential: для проверки подлинности на основе Azure AD. Примечание. Чтобы использовать маркер авторизации с помощью FromEndpoint, передайте пустую строку в subscriptionKey в методе fromEndpoint, а затем задайте authorizationToken="token" в созданном экземпляре SpeechConfig для использования маркера авторизации.
static function fromEndpoint(endpoint: URL, credential: any): SpeechConfig

Параметры

endpoint

URL

Конечная точка службы для подключения.

credential

any

Учетные данные, используемые для аутентификации.

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

Экземпляр фабрики речи.

fromEndpoint(URL, string)

Создает экземпляр конфигурации речи с указанной конечной точкой и ключом подписки. Этот метод предназначен только для пользователей, использующих нестандартную конечную точку или параметры службы. Примечание. Параметры запроса, указанные в URL-адресе конечной точки, не изменяются, даже если они задаются другими API. Например, если язык определен в URI в качестве параметра запроса "language=de-DE", а также задан speechConfig.speechRecognitionLanguage = "en-US", параметр языка в URI имеет приоритет, а эффективный язык — "de-DE". Можно задать только параметры, не указанные в URL-адресе конечной точки, другими API. Примечание. Чтобы использовать маркер авторизации с помощью FromEndpoint, передайте пустую строку в subscriptionKey в методе fromEndpoint, а затем задайте authorizationToken="token" в созданном экземпляре SpeechConfig для использования маркера авторизации.

static function fromEndpoint(endpoint: URL, subscriptionKey?: string): SpeechConfig

Параметры

endpoint

URL

Конечная точка службы для подключения.

subscriptionKey

string

Ключ подписки. Если ключ подписки не указан, необходимо задать маркер авторизации.

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

Экземпляр фабрики речи.

fromHost(URL, string)

Создает экземпляр конфигурации речи с указанным ключом узла и подписки. Этот метод предназначен только для пользователей, использующих узел службы, отличный от по умолчанию. Предполагается стандартный путь к ресурсу. Для служб с нестандартным путем к ресурсу или без пути вообще используйте fromEndpoint. Примечание. Параметры запроса не допускаются в URI узла и должны быть заданы другими API. Примечание. Чтобы использовать маркер авторизации с fromHost, используйте fromHost(URL), а затем задайте свойство AuthorizationToken в созданном экземпляре SpeechConfig. Примечание. Добавлено в версию 1.9.0.

static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig

Параметры

hostName

URL

subscriptionKey

string

Ключ подписки. Если ключ подписки не указан, необходимо задать маркер авторизации.

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

Экземпляр фабрики речи.

fromSubscription(string, string)

Статический экземпляр SpeechConfig, возвращаемый путем передачи subscriptionKey и региона службы.

static function fromSubscription(subscriptionKey: string, region: string): SpeechConfig

Параметры

subscriptionKey

string

Ключ подписки.

region

string

Название региона (см. страницу региона).

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

Фабрика речи

getProperty(string, string)

Возвращает текущее значение произвольного свойства.

function getProperty(name: string, def?: string): string

Параметры

name

string

Имя свойства для запроса.

def

string

Значение, возвращаемое в случае, если свойство не известно.

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

string

Текущее значение или указано по умолчанию заданного свойства.

requestWordLevelTimestamps()

Включает метки времени на уровне слова. Добавлено в версию 1.7.0.

function requestWordLevelTimestamps()

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

Параметры

profanity
ProfanityOption

setProperty(string | PropertyId, string)

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

function setProperty(name: string | PropertyId, value: string)

Параметры

name

string | PropertyId

Имя заданного свойства.

value

string

Новое значение свойства.

setProxy(string, number)

Задает конфигурацию прокси-сервера. Применимо только в средах Node.js. Добавлено в версию 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Параметры

proxyHostName

string

Имя узла прокси-сервера.

proxyPort

number

Номер порта прокси-сервера.

setProxy(string, number, string, string)

Задает конфигурацию прокси-сервера. Применимо только в средах Node.js. Добавлено в версию 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

Параметры

proxyHostName

string

Имя узла прокси-сервера без схемы протокола (http://)

proxyPort

number

Номер порта прокси-сервера.

proxyUserName

string

Имя пользователя прокси-сервера.

proxyPassword

string

Пароль прокси-сервера.

setServiceProperty(string, string, UriQueryParameter)

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

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

Параметры

name

string

value

string