Ligar ao Microsoft Translator a partir do PowerAppsConnect to Microsoft Translator from PowerApps

Microsoft Translator

Adicione a ligação do Microsoft Translator para apresentar texto traduzido num controlo Etiqueta na sua aplicação.Add the Microsoft Translator connector to display translated text in a Label control in your app. Por exemplo, pode criar uma caixa de texto de entrada que pede ao utilizador para introduzir algum texto para traduzir.For example, you can create an input text box that asks the user to enter some text to translate. Noutra etiqueta, pode apresentar o texto traduzido.In another label, you can display the translated text.

Este tópico mostra como criar a ligação do Microsoft Translator, utilizar a ligação do Microsoft Translator numa aplicação e apresenta uma lista das 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.

Nota

Este conector está limitado a 150 chamadas por utilizador por dia.This connector is limited to 150 calls per user per day.

Pré-requisitosPrerequisites

Ligar ao Microsoft TranslatorConnect to Microsoft Translator

  1. Abra o PowerApps, selecione Novo e crie uma Aplicação em branco.Open PowerApps, select New, and then create a Blank app. Escolha o esquema de telemóvel ou tablet.Choose phone or tablet layout. O esquema de tablet dá-lhe mais área de trabalho:Tablet layout gives you more workspace:

    Abrir uma aplicação em branco

  2. No painel da direita, clique ou toque no separador Dados e, em seguida, clique ou toque em Adicionar origem de dados.In the right-hand pane, click or tap Data tab, and then click or tap Add data source.
  3. Selecione Nova ligação e, em seguida, selecione Microsoft Translator:Select New connection, and then select Microsoft Translator:

    Ligar ao Microsoft Translator

    Ligar ao Microsoft Translator

  4. Selecione Ligar.Select Connect. A ligação é apresentado em Origens de dados:Your connection appears under Data sources:

    Ligar ao Microsoft Translator

Utilizar a ligação do Microsoft Translator na sua aplicaçãoUse the Microsoft Translator connection in your app

Traduzir textoTranslate text

  1. No menu Inserir, selecione Texto e, em seguida, selecione Introdução de texto.On the Insert menu, select Text, and then select Text input. Mude o nome do controlo de entrada de texto para Origem:Rename the text input control to Source:

    Mudar o nome

  2. Adicione uma lista Pendente (menu Inserir > Controlos), mude o nome para TargetLang e mova-a para baixo de Origem.Add a Drop down list (Insert menu > Controls), rename it to TargetLang, and move it below Source.
  3. Defina a propriedade Items de TargetLang como a fórmula seguinte:Set the Items property of TargetLang to the following formula:

    MicrosoftTranslator.Languages()

  4. Adicione uma etiqueta, mova-a para baixo de TargetLang e defina a respetiva propriedade Text como a fórmula seguinte:Add a label, move it below TargetLang, and set its Text property to the following formula:

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

  5. Introduza algum texto em Origem e selecione um idioma em TargetLang.Type some text into Source, and select a language in TargetLang. A etiqueta mostra o texto que introduziu no idioma que selecionou:The label shows the text that you entered in the language you chose:

    Traduzir texto de inglês para espanhol

Reproduzir texto traduzidoSpeak translated text

Se ainda não o fez, siga os passos na secção anterior para traduzir algum texto.If you haven't already, follow the steps in the previous section to translate some text. Estes passos seguintes utilizam os mesmos controlos.These next steps use the same controls.

  1. Defina a propriedade Items da lista pendente TargetLang como a fórmula seguinte:Set the Items property of the TargetLang drop-down list to the following formula:

    MicrosoftTranslator.SpeechLanguages()

  2. Mude o nome da segunda etiqueta (não da caixa Origem) para Destino.Rename the second label (not the Source box) to Target.
  3. Adicione um controlo de Áudio (menu Inserir > Multimédia) e defina a respetiva propriedade Media como a fórmula seguinte:Add an Audio control (Insert menu > Media), and set its Media property to the following formula:

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

  4. Prima F5 ou selecione o botão de Pré-visualização ().Press F5, or select the Preview button (). Introduza algum texto em Origem, selecione um idioma em TargetLang e, em seguida, selecione o botão de reprodução no controlo de áudio.Type some text into Source, select a language in TargetLang, and then select the play button in the audio control.

    A aplicação reproduz uma versão de áudio do texto que introduziu no idioma que selecionou.The app plays an audio version of the text that you entered in the language you chose.

  5. Prima Esc para voltar à área de trabalho predefinida.Press Esc to return to the default workspace.

Detetar o idioma de origemDetect the source language

Estes passos utilizam os mesmos controlos de entrada de texto de Origem e de texto de Destino.These next steps use the same Source text input and Target text controls. Se preferir, pode criar novos controlos. Para tal, basta atualizar os nomes na fórmula.You can create new controls if you prefer, just update the names in the formula.

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

    MicrosoftTranslator.Detect(Source.Text).Name

  2. Introduza algum texto em Origem.Type some text into Source.

    A etiqueta mostra o idioma do texto que introduziu.The label shows you the language of the text that you typed. Por exemplo, a etiqueta mostra Francês se escrever bonjour ou Italiano se escrever ciao.For example, the label shows French if you type bonjour, or Italian if you type ciao.

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

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

Nome da FunçãoFunction Name DescriçãoDescription
IdiomasLanguages Obtém todos os idiomas que o Microsoft Translator suportaRetrieves all languages that Microsoft Translator supports
TraduzirTranslate Traduz texto para um idioma especificado com o Microsoft TranslatorTranslates text to a specified language using Microsoft Translator
DetetarDetect Deteta o idioma de origem de um determinado textoDetects source language of given text
SpeechLanguagesSpeechLanguages Obtém os idiomas disponíveis para a sintetização de vozRetrieves the languages available for speech synthesis
TextToSpeechTextToSpeech Converte um determinado texto em voz, como uma transmissão de áudio no formato waveConverts a given text into speech as an audio stream in wave format

IdiomasLanguages

Obter idiomas: obtém todos os idiomas que o Microsoft Translator suportaGet languages: Retrieves all languages that Microsoft Translator supports

Propriedades de entradaInput properties

Nenhum.None.

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type NecessárioRequired DescriçãoDescription
CódigoCode cadeiastring NãoNo
NomeName cadeiastring NãoNo

TraduzirTranslate

Traduzir texto: traduz texto para um idioma especificado com o Microsoft TranslatorTranslate text: Translates text to a specified language using Microsoft Translator

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type NecessárioRequired DescriçãoDescription
queryquery cadeiastring simyes Texto a traduzirText to translate
languageTolanguageTo cadeiastring simyes Código de idioma de destino (exemplo: "fr")Target language code (example: 'fr')
languageFromlanguageFrom cadeiastring nãono Idioma de origem (se não for indicado, o Microsoft Translator irá tentar detetar automaticamente) (exemplo: en)Source language (if not provided, Microsoft Translator will try to auto-detect) (example: en)
categorycategory cadeiastring nãono Categoria de tradução (predefinição: "geral")Translation category (default: 'general')

Propriedades de saídaOutput properties

Nenhum.None.

DetetarDetect

Detetar idioma: deteta o idioma de origem de um determinado textoDetect language: Detects source language of given text

Propriedades de entradaInput properties

NomeName Tipo de DadosData Type NecessárioRequired DescriçãoDescription
queryquery cadeiastring simyes Texto cujo idioma será identificadoText whose language will be identified

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type NecessárioRequired DescriçãoDescription
CódigoCode cadeiastring NãoNo
NomeName cadeiastring NãoNo

SpeechLanguagesSpeechLanguages

Obter idiomas de voz: obtém os idiomas disponíveis para a sintetização de vozGet speech languages: Retrieves the languages available for speech synthesis

Propriedades de entradaInput properties

Nenhum.None.

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type NecessárioRequired DescriçãoDescription
CódigoCode cadeiastring NãoNo
NomeName cadeiastring NãoNo

TextToSpeechTextToSpeech

Conversão de texto em voz: converte um determinado texto em voz, como uma transmissão de áudio no 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 NecessárioRequired DescriçãoDescription
queryquery cadeiastring simyes Texto a converterText to convert
languagelanguage cadeiastring simyes Código de idioma para gerar voz (exemplo: "en-us")Language code to generate speech (example: 'en-us')

Propriedades de saídaOutput properties

Nenhum.None.

Veja todas as ligações disponíveis.See all the available connections.
Saiba como adicionar ligações às suas aplicações.Learn how to add connections to your apps.