Подключение к Microsoft Translator из Power Apps

Добавьте в приложение соединитель Microsoft Translator для отображения переведенного текста в элементе управления Метка. Например, вы можете создать одно текстовое поле для ввода текста, который нужно перевести, и вторую метку для вывода переведенного текста.

В этой статье рассказано о том, как создать и использовать в приложении подключение к Microsoft Translator, и перечислены доступные функции.

Предварительные условия

• Доступ к Power Apps
• Добавление подключения
• Создание приложения с помощью шаблона, на основе данных или с нуля

Подключение к Microsoft Translator

1. Создайте приложение на основе холста с нуля.

2. В области слева откройте вкладку Источники данных, а затем щелкните Добавить источник данных.

3. Выберите команду Создать подключение, а затем — Microsoft Translator:

   

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

   

Использование подключения к Microsoft Translator в приложении

Перевод текста

1. В Представление в виде дерева в левой части экрана выберите Вставить, а затем выберите элемент управления Ввод текста. Назначьте элементу управления Ввод текста имя Source.

2. Добавьте Раскрывающийся список (Вставка > Элементы управления), назначьте ему имя TargetLang, и расположите его ниже элемента Source.

3. Назначьте свойству Items элемента TargetLang следующую формулу:

   MicrosoftTranslator.Languages()

4. Добавьте метку, расположите ее ниже элемента управления TargetLang и назначьте ее свойству Text следующую формулу:

   MicrosoftTranslator.Translate(Source.Text, TargetLang.Selected.Value)

5. Введите какой-либо текст в поле Source и выберите язык в списке TargetLang. В метке будет выведен текст, переведенный на выбранный вами язык.

   

Озвучивание переведенного текста

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

1. Назначьте свойству Items раскрывающегося списка TargetLang следующую формулу:

   MicrosoftTranslator.SpeechLanguages()

2. Переименуйте вторую метку (не поле Source), назначив ей имя Target (Цель).

3. Добавьте элемент управления Аудио (Вставка > Мультимедиа) и назначьте его свойству Мультимедиа следующую формулу:

   MicrosoftTranslator.TextToSpeech(Target.Text, TargetLang.Selected.Value)

4. Нажмите клавишу F5 или кнопку предварительного просмотра (). Введите какой-либо текст в поле Source, выберите язык в списке TargetLang, а затем нажмите кнопку воспроизведения в элементе управления "Аудио".

   Приложение озвучит введенный текст на выбранном вами языке.

5. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.

Определение исходного языка

В этом разделе используются те же текстовые элементы управления Source и Target. При желании вы можете создать новые элементы управления, но следите за тем, чтобы в формулах использовались правильные имена.

1. Выберите элемент управления Target и назначьте его свойству Text следующую формулу:

   MicrosoftTranslator.Detect(Source.Text).Name

2. Введите какой-либо текст в элемент Source.

   В метке будет отображен язык введенного вами текста. Например, при вводе bonjour в метке появится значение Французский, а при вводе ciao — Итальянский.

Просмотр доступных функций

Это подключение включает следующие функции:

Имя функции	Описание
Языки	Возвращает все языки, поддерживаемые службой Microsoft Translator.
Перевести	Переводит текст на указанный язык с помощью службы Microsoft Translator.
Обнаружить	Определяет исходный язык текста.
SpeechLanguages	Возвращает языки, доступные для синтеза речи.
TextToSpeech	Преобразует указанный текст в речь в виде звукового потока в формате звукозаписи.

Языки

Эта функция возвращает все языки, поддерживаемые службой Microsoft Translator.

Входные свойства

Нет.

Выходные свойства

Имя свойства	Тип данных	Обязательные	Описание
Код	string	Нет
Имя (название)	string	Нет

Перевести

Эта функция переводит текст на указанный язык с помощью службы Microsoft Translator.

Входные свойства

Имя (название)	Тип данных	Обязательные	Описание
query	string	да	Текст, который нужно перевести.
languageTo	string	да	Код целевого языка (например, "fr").
languageFrom	string	нет	Исходный язык (если он не указан, Microsoft Translator попытается автоматически распознать язык). Пример: en.
категория	string	нет	Категория перевода (по умолчанию "general" (общая)).

Выходные свойства

Нет.

Обнаружить

Эта функция распознает исходный язык указанного текста.

Входные свойства

Имя (название)	Тип данных	Обязательные	Описание
query	string	да	Текст, язык которого нужно распознать.

Выходные свойства

Имя свойства	Тип данных	Обязательные	Описание
Код	string	Нет
Имя (название)	string	Нет

SpeechLanguages

Эта функция возвращает языки, доступные для синтеза речи.

Входные свойства

Нет.

Выходные свойства

Имя свойства	Тип данных	Обязательные	Описание
Код	string	Нет
Имя (название)	string	Нет

TextToSpeech

Преобразование текста в речь: преобразует заданный текст в речь в виде звукового потока в формате звукозаписи.

Входные свойства

Имя (название)	Тип данных	Обязательные	Описание
query	string	да	Текст, который нужно преобразовать.
язык	string	да	Код языка для синтеза речи (например, "en-us").

Выходные свойства

Нет.

Полезные ссылки

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

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).