Conecte-se ao Microsoft Translator por meio do PowerAppsConnect to Microsoft Translator from PowerApps

Microsoft Translator

Adicione o conector do Microsoft Translator para exibir o texto traduzido em um controle Rótulo no aplicativo.Add the Microsoft Translator connector to display translated text in a Label control in your app. Por exemplo, você pode criar uma caixa de texto de entrada que pede ao usuário para digitar um texto para tradução.For example, you can create an input text box that asks the user to enter some text to translate. Em outro rótulo, você pode exibir o texto traduzido.In another label, you can display the translated text.

Este tópico mostra como criar a conexão com o Microsoft Translator, usar a conexão do Microsoft Translator em um aplicativo e listar as funções disponíveis.This topic shows you how to create the Microsoft Translator connection, use the Microsoft Translator connection in an app, and lists the available functions.

Observação

Esse conector é limitado a 150 chamadas por usuário por dia.This connector is limited to 150 calls per user per day.

Pré-requisitosPrerequisites

Conecte-se ao Microsoft TranslatorConnect to Microsoft Translator

  1. Abra o PowerApps, selecione Novoe, em seguida, crie um Aplicativo em branco.Open PowerApps, select New, and then create a Blank app. Escolha o layout de telefone ou tablet.Choose phone or tablet layout. O layout de tablet oferece mais espaço de trabalho:Tablet layout gives you more workspace:

    Abrir um aplicativo em branco

  2. No painel direito, clique ou toque na guia Dados e, em seguida, clique ou toque em Adicionar fonte de dados.In the right-hand pane, click or tap Data tab, and then click or tap Add data source.
  3. Selecione Nova conexão e, em seguida, selecione Microsoft Translator:Select New connection, and then select Microsoft Translator:

    Conecte-se ao Microsoft Translator

    Conecte-se ao Microsoft Translator

  4. Selecione Conectar.Select Connect. Sua conexão aparece em Fontes de dados:Your connection appears under Data sources:

    Conecte-se ao Microsoft Translator

Usar a conexão do Microsoft Translator no seu aplicativoUse the Microsoft Translator connection in your app

Traduzir textoTranslate text

  1. No menu Inserir, selecione Text e, em seguida, selecione Text input.On the Insert menu, select Text, and then select Text input. Renomeie o controle de entrada de texto para Origem:Rename the text input control to Source:

    Renomear

  2. Adicione uma Lista suspensa (menu Inserir > Controles), renomeie-o para IdiomaDestino, e coloque-o abaixo de Origem.Add a Drop down list (Insert menu > Controls), rename it to TargetLang, and move it below Source.
  3. Defina a propriedade Items TargetLang para a fórmula a seguir:Set the Items property of TargetLang to the following formula:

    MicrosoftTranslator.Languages()

  4. Adicione um rótulo, mova-o para abaixo de TargetLang e defina sua propriedade Text com a seguinte fórmula:Add a label, move it below TargetLang, and set its Text property to the following formula:

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

  5. Digite um texto em Origeme selecione um idioma na IdiomaDestino.Type some text into Source, and select a language in TargetLang. O rótulo mostra o texto que você inseriu no idioma escolhido:The label shows the text that you entered in the language you chose:

    Traduzir o texto de inglês para espanhol

Falar o texto traduzidoSpeak translated text

Se você ainda não fez isso, siga as etapas na seção anterior para traduzir um texto.If you haven't already, follow the steps in the previous section to translate some text. As próximas etapas usam os mesmos controles.These next steps use the same controls.

  1. Defina a propriedade Items da lista suspensa IdiomaDestino para a fórmula a seguir:Set the Items property of the TargetLang drop-down list to the following formula:

    MicrosoftTranslator.SpeechLanguages()

  2. Renomeie o segundo rótulo (não a caixa Fonte) Destino.Rename the second label (not the Source box) to Target.
  3. Adicione um controle de Áudio (menu Inserir > Mídia) e defina sua propriedade Media conforme a seguinte fórmula:Add an Audio control (Insert menu > Media), and set its Media property to the following formula:

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

  4. Pressione F5 ou selecione o botão de Visualização ().Press F5, or select the Preview button (). Digite um texto em Origem, selecione um idioma em IdiomaDestinoe em seguida, selecione o botão para reproduzir no controle de áudio.Type some text into Source, select a language in TargetLang, and then select the play button in the audio control.

    O aplicativo executa uma versão em áudio do texto que você inseriu no idioma escolhido.The app plays an audio version of the text that you entered in the language you chose.

  5. Pressione Esc para retornar para o espaço de trabalho padrão.Press Esc to return to the default workspace.

Detecte o idioma de origemDetect the source language

As próximas etapas usam a mesma entrada de texto de Origem e os controles de texto de Destino.These next steps use the same Source text input and Target text controls. Você pode criar novos controles se você preferir, apenas atualize os nomes na fórmula.You can create new controls if you prefer, just update the names in the formula.

  1. Selecione o controle de texto de Destino e defina a propriedade Text conforme a fórmula a seguir:Select the Target text control, and set the Text property to the following formula:

    MicrosoftTranslator.Detect(Source.Text).Name

  2. Digite um texto em Origem.Type some text into Source.

    O rótulo mostra o idioma do texto digitado.The label shows you the language of the text that you typed. Por exemplo, o rótulo mostra Francês se você digita bonjour ou Italiano se você digita ciao.For example, the label shows French if you type bonjour, or Italian if you type ciao.

Exibir as funções disponíveisView the available functions

Essa conexão inclui as seguintes funções:This connection includes the following functions:

Nome da FunçãoFunction Name DescriçãoDescription
LanguagesLanguages Recupera todos os idiomas com suporte do Microsoft TranslatorRetrieves all languages that Microsoft Translator supports
TranslateTranslate Traduz o texto para um idioma especificado usando o Microsoft TranslatorTranslates text to a specified language using Microsoft Translator
DetectDetect Detecta o idioma de origem de um texto especificadoDetects source language of given text
SpeechLanguagesSpeechLanguages Recupera os idiomas disponíveis para sintetização de vozRetrieves the languages available for speech synthesis
TextToSpeechTextToSpeech Converte um determinado texto em fala como um fluxo de áudio em formato waveConverts a given text into speech as an audio stream in wave format

LinguagensLanguages

Get languages: Recupera todos os idiomas com suporte do Microsoft TranslatorGet languages: Retrieves all languages that Microsoft Translator supports

Propriedades de entradaInput properties

Nenhuma.None.

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
CodificarCode cadeia de caracteresstring NãoNo
NomeName cadeia de caracteresstring NãoNo

TranslateTranslate

Translate text: Traduz o texto para um idioma especificado usando o Microsoft TranslatorTranslate text: Translates text to a specified language using Microsoft Translator

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
queryquery cadeia de caracteresstring simyes Texto para traduçãoText to translate
languageTolanguageTo cadeia de caracteresstring simyes Código de idioma de destino (exemplo: 'fr')Target language code (example: 'fr')
languageFromlanguageFrom cadeia de caracteresstring nãono Idioma de origem (se não fornecido, o Microsoft Translator tentará detectar automaticamente) (exemplo: en)Source language (if not provided, Microsoft Translator will try to auto-detect) (example: en)
categorycategory cadeia de caracteresstring nãono Categoria de tradução (padrão: 'general')Translation category (default: 'general')

Propriedades de saídaOutput properties

Nenhuma.None.

DetectDetect

Detect language: Detecta o idioma de origem de um texto especificadoDetect language: Detects source language of given text

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
queryquery cadeia de caracteresstring simyes Texto cujo idioma será identificadoText whose language will be identified

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
CodificarCode cadeia de caracteresstring NãoNo
NomeName cadeia de caracteresstring NãoNo

SpeechLanguagesSpeechLanguages

Get speech languages: Recupera os idiomas disponíveis para sintetização de vozGet speech languages: Retrieves the languages available for speech synthesis

Propriedades de entradaInput properties

Nenhuma.None.

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
CodificarCode cadeia de caracteresstring NãoNo
NomeName cadeia de caracteresstring NãoNo

TextToSpeechTextToSpeech

Text to speech: Converte um determinado texto em fala como um fluxo de áudio em formato waveText to speech: Converts a given text into speech as an audio stream in wave format

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
queryquery cadeia de caracteresstring simyes Texto a ser convertidoText to convert
languagelanguage cadeia de caracteresstring simyes Código de idioma para gerar fala (exemplo: ' en-us')Language code to generate speech (example: 'en-us')

Propriedades de saídaOutput properties

Nenhuma.None.

Veja todas as conexões disponíveis.See all the available connections.
Saiba como adicionar conexões a seus aplicativos.Learn how to add connections to your apps.