Verbinding maken met Microsoft Translator vanuit PowerAppsConnect to Microsoft Translator from PowerApps

Microsoft Translator

Voeg de Microsoft Translator-connector toe om vertaalde tekst in een besturingselement Labelin uw app weer te geven.Add the Microsoft Translator connector to display translated text in a Label control in your app. U kunt bijvoorbeeld een invoertekstvak maken waarin de gebruiker tekst kan invoeren die moet worden vertaald.For example, you can create an input text box that asks the user to enter some text to translate. In een ander label kunt u de vertaalde tekst weergeven.In another label, you can display the translated text.

In dit onderwerp wordt uitgelegd hoe u de Microsoft Translator-verbinding maakt en hoe u de Microsoft Translator-verbinding gebruikt in een app en worden de beschikbare functies toegelicht.This topic shows you how to create the Microsoft Translator connection, use the Microsoft Translator connection in an app, and lists the available functions.

Opmerking: deze connector is beperkt tot 150 aanroepen per gebruiker per dag.Note: This connector is limited to 150 calls per user per day.

 

What you need to get started

Verbinden met Microsoft TranslatorConnect to Microsoft Translator

  1. Open PowerApps, selecteer Nieuw en maak vervolgens een lege app.Open PowerApps, select New, and then create a Blank app. Kies de telefoon- of tabletindeling.Choose phone or tablet layout. De tabletindeling biedt meer werkruimte:Tablet layout gives you more workspace:

    Een lege app openen

  2. Klik of tik in het rechterdeelvenster op het tabblad Gegevens en klik of tik vervolgens op Gegevensbron toevoegen.In the right-hand pane, click or tap Data tab, and then click or tap Add data source.
  3. Selecteer Nieuwe verbinding en selecteer vervolgens Microsoft Translator:Select New connection, and then select Microsoft Translator:

    Verbinden met Microsoft Translator

    Verbinden met Microsoft Translator

  4. Selecteer Verbinden.Select Connect. De verbinding wordt weergegeven onder Gegevensbronnen:Your connection appears under Data sources:

    Verbinden met Microsoft Translator

De Microsoft Translator-verbinding gebruiken in uw appUse the Microsoft Translator connection in your app

Tekst vertalenTranslate text

  1. Selecteer Text in het menu Insert en selecteer vervolgens Text input.On the Insert menu, select Text, and then select Text input. Wijzig de naam van het besturingselement voor tekstinvoer in Source:Rename the text input control to Source:

    Naam wijzigen

  2. Voeg een vervolgkeuzelijst toe (menu Invoegen > Besturingselementen), wijzig de naam in TargetLang en plaats deze onder Source.Add a Drop down list (Insert menu > Controls), rename it to TargetLang, and move it below Source.
  3. Stel de eigenschap Items van TargetLang in op de volgende formule:Set the Items property of TargetLang to the following formula:

    MicrosoftTranslator.Languages()

  4. Voeg een label toe, plaats dit onder TargetLang en stel de eigenschap Text in op de volgende formule:Add a label, move it below TargetLang, and set its Text property to the following formula:

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

  5. Typ tekst in het vak Source en selecteer een taal in TargetLang.Type some text into Source, and select a language in TargetLang. In het label wordt de tekst die u hebt ingevoerd, weergegeven in de gekozen taal:The label shows the text that you entered in the language you chose:

    Tekst vertalen van het Engels naar het Spaans

Vertaalde tekst uitsprekenSpeak translated text

Als u dat nog niet hebt gedaan, voert u de stappen in de vorige sectie uit om tekst te vertalen.If you haven't already, follow the steps in the previous section to translate some text. In de volgende stappen worden dezelfde besturingselementen gebruikt.These next steps use the same controls.

  1. Stel de eigenschap Items van de vervolgkeuzelijst TargetLang in op de volgende formule:Set the Items property of the TargetLang drop-down list to the following formula:

    MicrosoftTranslator.SpeechLanguages()

  2. Wijzig de naam van het tweede label (niet het vak Source) in Target.Rename the second label (not the Source box) to Target.
  3. Voeg een audiobesturingselement toe (menu Invoegen > Media) en stel de eigenschap Media in op de volgende formule:Add an Audio control (Insert menu > Media), and set its Media property to the following formula:

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

  4. Druk op F5 of selecteer de knop Voorbeeld ().Press F5, or select the Preview button (). Typ tekst in het vak Source, selecteer een taal in TargetLang en selecteer vervolgens de afspeelknop in het audiobesturingselement.Type some text into Source, select a language in TargetLang, and then select the play button in the audio control.

    De app speelt een audioversie van de ingevoerde tekst af in de gekozen taal.The app plays an audio version of the text that you entered in the language you chose.

  5. Druk op Esc om terug te gaan naar de standaardwerkruimte.Press Esc to return to the default workspace.

De brontaal detecterenDetect the source language

In de volgende stappen worden dezelfde tekstbesturingselementen Source en Target gebruikt.These next steps use the same Source text input and Target text controls. U kunt desgewenst nieuwe besturingselementen maken door enkel de namen in de formule bij te werken.You can create new controls if you prefer, just update the names in the formula.

  1. Selecteer het tekstbesturingselement Target en stel de eigenschap Text in op de volgende formule:Select the Target text control, and set the Text property to the following formula:

    MicrosoftTranslator.Detect(Source.Text).Name

  2. Typ tekst in Source.Type some text into Source.

    Het label geeft de taal aan van de tekst die u hebt getypt.The label shows you the language of the text that you typed. Het label geeft bijvoorbeeld Frans aan als u bonjour typt of Italiaans als u ciao typt.For example, the label shows French if you type bonjour, or Italian if you type ciao.

De beschikbare functies weergevenView the available functions

Deze verbinding bevat de volgende functies:This connection includes the following functions:

FunctienaamFunction Name BeschrijvingDescription
LanguagesLanguages Hiermee worden alle talen opgehaald die Microsoft Translator ondersteuntRetrieves all languages that Microsoft Translator supports
TranslateTranslate Vertaalt tekst naar een opgegeven taal met Microsoft TranslatorTranslates text to a specified language using Microsoft Translator
DetectDetect Detecteert de brontaal van de tekstDetects source language of given text
SpeechLanguagesSpeechLanguages Hiermee worden de beschikbare talen voor spraaksynthese opgehaaldRetrieves the languages available for speech synthesis
TextToSpeechTextToSpeech Zet een opgegeven tekst om in spraak als een audiostream in de wave-indelingConverts a given text into speech as an audio stream in wave format

TalenLanguages

Get languages: hiermee worden alle talen opgehaald die Microsoft Translator ondersteuntGet languages: Retrieves all languages that Microsoft Translator supports

InvoereigenschappenInput properties

Geen.None.

UitvoereigenschappenOutput properties

EigenschapsnaamProperty Name GegevenstypeData Type VereistRequired BeschrijvingDescription
CoderenCode Tekenreeksstring NeeNo
NaamName Tekenreeksstring NeeNo

TranslateTranslate

Tekst vertalen: vertaalt tekst naar een opgegeven taal met Microsoft TranslatorTranslate text: Translates text to a specified language using Microsoft Translator

InvoereigenschappenInput properties

NaamName GegevenstypeData Type VereistRequired BeschrijvingDescription
queryquery Tekenreeksstring Jayes Te vertalen tekstText to translate
languageTolanguageTo Tekenreeksstring Jayes Code van doeltaal (bijvoorbeeld: 'fr')Target language code (example: 'fr')
languageFromlanguageFrom Tekenreeksstring Neeno Brontaal (indien niet opgegeven probeert Microsoft Translator deze automatisch te detecteren) (bijvoorbeeld: en)Source language (if not provided, Microsoft Translator will try to auto-detect) (example: en)
categoriecategory Tekenreeksstring Neeno Vertaalcategorie (standaard: 'algemeen')Translation category (default: 'general')

UitvoereigenschappenOutput properties

Geen.None.

DetectDetect

Taal detecteren: detecteert de brontaal van de tekstDetect language: Detects source language of given text

InvoereigenschappenInput properties

NaamName GegevenstypeData Type VereistRequired BeschrijvingDescription
queryquery Tekenreeksstring Jayes Tekst waarvan de taal wordt geïdentificeerdText whose language will be identified

UitvoereigenschappenOutput properties

EigenschapsnaamProperty Name GegevenstypeData Type VereistRequired BeschrijvingDescription
CoderenCode Tekenreeksstring NeeNo
NaamName Tekenreeksstring NeeNo

SpeechLanguagesSpeechLanguages

Talen voor spraak ophalen: hiermee worden de beschikbare talen voor spraaksynthese opgehaaldGet speech languages: Retrieves the languages available for speech synthesis

InvoereigenschappenInput properties

Geen.None.

UitvoereigenschappenOutput properties

EigenschapsnaamProperty Name GegevenstypeData Type VereistRequired BeschrijvingDescription
CoderenCode Tekenreeksstring NeeNo
NaamName Tekenreeksstring NeeNo

TextToSpeechTextToSpeech

Tekst-naar-spraak: zet een opgegeven tekst om in spraak als een audiostream in de wave-indelingText to speech: Converts a given text into speech as an audio stream in wave format

InvoereigenschappenInput properties

NaamName GegevenstypeData Type VereistRequired BeschrijvingDescription
queryquery Tekenreeksstring Jayes Te converteren tekstText to convert
taallanguage Tekenreeksstring Jayes Taalcode om spraak te genereren (bijvoorbeeld: 'en-us')Language code to generate speech (example: 'en-us')

UitvoereigenschappenOutput properties

Geen.None.

Bekijk alle beschikbare verbindingen.See all the available connections.
Meer informatie over het toevoegen van verbindingen aan uw apps.Learn how to add connections to your apps.