SpeechTranslationConfig class
Конфигурация перевода речи.
- Extends
Свойства
authorization |
Возвращает или задает маркер авторизации. Примечание. Вызывающий объект должен убедиться, что маркер авторизации действителен. До истечения срока действия маркера авторизации вызывающий объект должен обновить его, вызвав этот метод задания с новым допустимым маркером. |
endpoint |
Возвращает идентификатор конечной точки настраиваемой модели речи, используемой для распознавания речи. |
output |
Возвращает формат выходных данных распознавания речи (простой или подробный). Примечание. Этот формат выходных данных предназначен для результатов распознавания речи. Используйте [SpeechConfig.speechSynthesisOutputFormat], чтобы получить формат синтезированного аудиовыхода. |
region | |
speech |
Возвращает или задает язык распознавания речи. |
speech |
Возвращает язык синтезатора речи. Добавлено в версии 1.11.0. |
speech |
Возвращает формат выходных данных синтеза речи. Добавлено в версии 1.11.0. |
speech |
Возвращает голос синтезатора речи. Добавлено в версии 1.11.0. |
subscription |
|
target |
Возвращает целевой язык (текст) для перевода. |
voice |
Возвращает выбранное имя голоса. |
Методы
add |
Добавьте целевой язык (текст) для перевода. |
close() | Удалите связанные ресурсы. |
from |
Статический экземпляр SpeechTranslationConfig, возвращаемый путем передачи маркера авторизации и региона службы. Примечание. Вызывающий объект должен убедиться, что маркер авторизации действителен. До истечения срока действия маркера авторизации вызывающему объекту необходимо обновить его, задав свойству authorizationToken новый допустимый маркер. В противном случае все распознаватели, созданные этим экземпляром SpeechTranslationConfig, будут сталкиваться с ошибками во время распознавания. Так как значения конфигурации копируются при создании нового распознавателя, новое значение маркера не будет применяться к уже созданным распознавателям. Для распознавателей, которые были созданы ранее, необходимо задать маркер авторизации соответствующего распознавателя, чтобы обновить маркер. В противном случае распознаватели будут сталкиваться с ошибками во время распознавания. |
from |
Создает экземпляр конфигурации перевода речи с указанной конечной точкой и ключом подписки. Этот метод предназначен только для пользователей, использующих нестандартную конечную точку службы или параметры. Примечание. Свойства запроса, указанные в URL-адресе конечной точки, не изменяются, даже если они задаются другими API. Например, если язык определен в URI как параметр запроса "language=de-DE", а также задан свойством speechRecognitionLanguage, параметр языка в URI имеет приоритет, а действующий язык — "de-DE". Другие API могут задавать только свойства, не указанные в URL-адресе конечной точки. Примечание. Чтобы использовать маркер авторизации с fromEndpoint, передайте пустую строку в subscriptionKey в методе fromEndpoint, а затем задайте authorizationToken="token" в созданном экземпляре SpeechConfig для использования маркера авторизации. |
from |
Создает экземпляр конфигурации речи с указанными узлом узла и ключом подписки. Этот метод предназначен только для пользователей, использующих узел службы, отличный от узла службы по умолчанию. Предполагается стандартный путь к ресурсу. Для служб с нестандартным путем к ресурсам или вообще без него используйте fromEndpoint. Примечание. Параметры запроса не разрешены в URI узла и должны задаваться другими API. Примечание. Чтобы использовать маркер авторизации с fromHost, используйте fromHost(URL- адрес), а затем задайте свойство AuthorizationToken для созданного экземпляра SpeechConfig. Примечание. Добавлено в версии 1.9.0. |
from |
Статический экземпляр SpeechTranslationConfig, возвращаемый путем передачи ключа подписки и региона службы. |
set |
Задает именованное свойство в качестве значения |
Наследуемые методы
enable |
Включите ведение журнала звука в службе. Журналы аудио и содержимого хранятся либо в хранилище, принадлежащее Корпорации Майкрософт, либо в вашей учетной записи хранения, связанной с подпиской Cognitive Services (ресурс службы "Речь" с поддержкой BYOS). Журналы будут удалены через 30 дней. Добавлено в версии 1.7.0. |
enable |
Включите диктовку. Поддерживается только в непрерывном распознавании речи. Добавлено в версии 1.7.0. |
get |
Возвращает текущее значение произвольного свойства. |
request |
Включает метки времени на уровне слов. Добавлено в версии 1.7.0. |
set |
Задает параметр ненормативной лексики. Добавлено в версии 1.7.0. |
set |
Задает конфигурацию прокси-сервера. Применимо только в Node.js средах. Добавлено в версии 1.4.0. |
set |
Задает конфигурацию прокси-сервера. Применимо только в Node.js средах. Добавлено в версии 1.4.0. |
set |
Задает значение свойства, которое будет передано службе по указанному каналу. Добавлено в версии 1.7.0. |
Сведения о свойстве
authorizationToken
Возвращает или задает маркер авторизации. Примечание. Вызывающий объект должен убедиться, что маркер авторизации действителен. До истечения срока действия маркера авторизации вызывающий объект должен обновить его, вызвав этот метод задания с новым допустимым маркером.
void authorizationToken
Значение свойства
void
endpointId
Возвращает идентификатор конечной точки настраиваемой модели речи, используемой для распознавания речи.
string endpointId
Значение свойства
string
Идентификатор конечной точки
outputFormat
Возвращает формат выходных данных распознавания речи (простой или подробный). Примечание. Этот формат выходных данных предназначен для результатов распознавания речи. Используйте [SpeechConfig.speechSynthesisOutputFormat], чтобы получить формат синтезированного аудиовыхода.
OutputFormat outputFormat
Значение свойства
Возвращает формат выходных данных.
region
string region
Значение свойства
string
Регион, заданный в конфигурации.
speechRecognitionLanguage
Возвращает или задает язык распознавания речи.
void speechRecognitionLanguage
Значение свойства
void
speechSynthesisLanguage
Возвращает язык синтезатора речи. Добавлено в версии 1.11.0.
string speechSynthesisLanguage
Значение свойства
string
Возвращает язык синтеза речи.
speechSynthesisOutputFormat
Возвращает формат выходных данных синтеза речи. Добавлено в версии 1.11.0.
SpeechSynthesisOutputFormat speechSynthesisOutputFormat
Значение свойства
Возвращает формат выходных данных синтеза речи.
speechSynthesisVoiceName
Возвращает голос синтезатора речи. Добавлено в версии 1.11.0.
string speechSynthesisVoiceName
Значение свойства
string
Возвращает голос синтеза речи.
subscriptionKey
string subscriptionKey
Значение свойства
string
Ключ подписки, заданный в конфигурации.
targetLanguages
Возвращает целевой язык (текст) для перевода.
string[] targetLanguages
Значение свойства
string[]
voiceName
Возвращает выбранное имя голоса.
string voiceName
Значение свойства
string
Имя голоса.
Сведения о методе
addTargetLanguage(string)
Добавьте целевой язык (текст) для перевода.
function addTargetLanguage(value: string)
Параметры
- value
-
string
Язык, например de-DE
close()
Удалите связанные ресурсы.
function close()
fromAuthorizationToken(string, string)
Статический экземпляр SpeechTranslationConfig, возвращаемый путем передачи маркера авторизации и региона службы. Примечание. Вызывающий объект должен убедиться, что маркер авторизации действителен. До истечения срока действия маркера авторизации вызывающему объекту необходимо обновить его, задав свойству authorizationToken новый допустимый маркер. В противном случае все распознаватели, созданные этим экземпляром SpeechTranslationConfig, будут сталкиваться с ошибками во время распознавания. Так как значения конфигурации копируются при создании нового распознавателя, новое значение маркера не будет применяться к уже созданным распознавателям. Для распознавателей, которые были созданы ранее, необходимо задать маркер авторизации соответствующего распознавателя, чтобы обновить маркер. В противном случае распознаватели будут сталкиваться с ошибками во время распознавания.
static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig
Параметры
- authorizationToken
-
string
Маркер авторизации.
- region
-
string
Имя региона (см. страницу региона).
Возвращаемое значение
Конфигурация перевода речи.
fromEndpoint(URL, string)
Создает экземпляр конфигурации перевода речи с указанной конечной точкой и ключом подписки. Этот метод предназначен только для пользователей, использующих нестандартную конечную точку службы или параметры. Примечание. Свойства запроса, указанные в URL-адресе конечной точки, не изменяются, даже если они задаются другими API. Например, если язык определен в URI как параметр запроса "language=de-DE", а также задан свойством speechRecognitionLanguage, параметр языка в URI имеет приоритет, а действующий язык — "de-DE". Другие API могут задавать только свойства, не указанные в URL-адресе конечной точки. Примечание. Чтобы использовать маркер авторизации с fromEndpoint, передайте пустую строку в subscriptionKey в методе fromEndpoint, а затем задайте authorizationToken="token" в созданном экземпляре SpeechConfig для использования маркера авторизации.
static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig
Параметры
- 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)
Статический экземпляр SpeechTranslationConfig, возвращаемый путем передачи ключа подписки и региона службы.
static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig
Параметры
- subscriptionKey
-
string
Ключ подписки.
- region
-
string
Имя региона (см. страницу региона).
Возвращаемое значение
Конфигурация перевода речи.
setProperty(string | PropertyId, string)
Задает именованное свойство в качестве значения
function setProperty(name: string | PropertyId, value: string)
Параметры
- name
-
string | PropertyId
Имя задаваемого свойства.
- value
-
string
Новое значение свойства.
Сведения о наследуемом методе
enableAudioLogging()
Включите ведение журнала звука в службе. Журналы аудио и содержимого хранятся либо в хранилище, принадлежащее Корпорации Майкрософт, либо в вашей учетной записи хранения, связанной с подпиской Cognitive Services (ресурс службы "Речь" с поддержкой BYOS). Журналы будут удалены через 30 дней. Добавлено в версии 1.7.0.
function enableAudioLogging()
Наследуется отSpeechConfig.enableAudioLogging
enableDictation()
Включите диктовку. Поддерживается только в непрерывном распознавании речи. Добавлено в версии 1.7.0.
function enableDictation()
Наследуется отSpeechConfig.enableDictation
getProperty(string, string)
Возвращает текущее значение произвольного свойства.
function getProperty(name: string, def?: string): string
Параметры
- name
-
string
Имя свойства для запроса.
- def
-
string
Значение, возвращаемое в случае, если свойство неизвестно.
Возвращаемое значение
string
Текущее значение (по умолчанию) заданного свойства.
Наследуется отSpeechConfig.getProperty
requestWordLevelTimestamps()
Включает метки времени на уровне слов. Добавлено в версии 1.7.0.
function requestWordLevelTimestamps()
Наследуется отSpeechConfig.requestWordLevelTimestamps
setProfanity(ProfanityOption)
Задает параметр ненормативной лексики. Добавлено в версии 1.7.0.
function setProfanity(profanity: ProfanityOption)
Параметры
- profanity
- ProfanityOption
Наследуется отSpeechConfig.setProfanity
setProxy(string, number)
Задает конфигурацию прокси-сервера. Применимо только в Node.js средах. Добавлено в версии 1.4.0.
function setProxy(proxyHostName: string, proxyPort: number)
Параметры
- proxyHostName
-
string
Имя узла прокси-сервера.
- proxyPort
-
number
Номер порта прокси-сервера.
Наследуется отSpeechConfig.setProxy
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
Пароль прокси-сервера.
Наследуется отSpeechConfig.setProxy
setServiceProperty(string, string, UriQueryParameter)
Задает значение свойства, которое будет передано службе по указанному каналу. Добавлено в версии 1.7.0.
function setServiceProperty(name: string, value: string, channel: UriQueryParameter)
Параметры
- name
-
string
- value
-
string
- channel
- UriQueryParameter
Наследуется отSpeechConfig.setServiceProperty