Herstellen einer Verbindung mit Microsoft Translator aus PowerAppsConnect to Microsoft Translator from PowerApps

Microsoft Translator

Fügen Sie den Connector für Microsoft Translator hinzu, um übersetzten Text in einem Label-Steuerelement (Bezeichnung) in Ihrer App anzuzeigen.Add the Microsoft Translator connector to display translated text in a Label control in your app. Beispielsweise können Sie ein Eingabetextfeld erstellen, mit dem der Benutzer aufgefordert wird, Text zum Übersetzen einzugeben.For example, you can create an input text box that asks the user to enter some text to translate. In einer anderen Bezeichnung können Sie den übersetzten Text anzeigen.In another label, you can display the translated text.

In diesem Thema wird gezeigt, wie Sie die Microsoft Translator-Verbindung erstellen und in einer App verwenden, und es werden die verfügbaren Funktionen aufgeführt.This topic shows you how to create the Microsoft Translator connection, use the Microsoft Translator connection in an app, and lists the available functions.

Hinweis

Dieser Connector ist auf 150 Aufrufe pro Benutzer und Tag beschränkt.This connector is limited to 150 calls per user per day.

VoraussetzungenPrerequisites

Herstellen einer Verbindung mit Microsoft TranslatorConnect to Microsoft Translator

  1. Öffnen Sie PowerApps, wählen Sie Neu aus, und erstellen Sie eine Leere App.Open PowerApps, select New, and then create a Blank app. Wählen Sie das Layout für Smartphone oder Tablet aus.Choose phone or tablet layout. Das Tablet-Layout bietet Ihnen einen größeren Arbeitsbereich:Tablet layout gives you more workspace:

    Öffnen einer leeren App

  2. Klicken oder tippen Sie im rechten Bereich auf die Registerkarte Daten und dann auf Datenquelle hinzufügen.In the right-hand pane, click or tap Data tab, and then click or tap Add data source.
  3. Wählen Sie Neue Verbindung und anschließend Microsoft Translator aus:Select New connection, and then select Microsoft Translator:

    Herstellen einer Verbindung mit Microsoft Translator

    Herstellen einer Verbindung mit Microsoft Translator

  4. Wählen Sie Verbinden aus.Select Connect. Die Verbindung wird unter Datenquellen angezeigt:Your connection appears under Data sources:

    Herstellen einer Verbindung mit Microsoft Translator

Verwenden der Microsoft Translator-Verbindung in Ihrer AppUse the Microsoft Translator connection in your app

Übersetzen von TextTranslate text

  1. Klicken Sie im Menü Insert (Einfügen) auf Text, und wählen Sie dann Texteingabe (Texteingabe) aus.On the Insert menu, select Text, and then select Text input. Benennen Sie das Texteingabe-Steuerelement in Source um:Rename the text input control to Source:

    Umbenennen

  2. Fügen Sie eine Dropdown-Liste hinzu (Menü Einfügen > Steuerelemente), benennen Sie sie in TargetLang um, und verschieben Sie sie unter Source.Add a Drop down list (Insert menu > Controls), rename it to TargetLang, and move it below Source.
  3. Legen Sie die Items-Eigenschaft von TargetLang auf die folgende Formel fest:Set the Items property of TargetLang to the following formula:

    MicrosoftTranslator.Languages()

  4. Fügen Sie eine Bezeichnung hinzu, verschieben Sie es unter TargetLang, und legen Sie seine Text-Eigenschaft auf die folgende Formel fest:Add a label, move it below TargetLang, and set its Text property to the following formula:

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

  5. Geben Sie Text in Source ein, und wählen Sie unter TargetLang eine Sprache aus.Type some text into Source, and select a language in TargetLang. In der Bezeichnung wird der eingegebene Text in der ausgewählten Sprache angezeigt:The label shows the text that you entered in the language you chose:

    Übersetzen von Text aus dem Englischen ins Spanische

Sprechen von übersetztem TextSpeak translated text

Wenn Sie dies nicht bereits getan haben, führen Sie die Schritte im vorherigen Abschnitt aus, um Text zu übersetzen.If you haven't already, follow the steps in the previous section to translate some text. In den folgenden Schritten werden die gleichen Steuerelemente verwendet.These next steps use the same controls.

  1. Legen Sie die Items-Eigenschaft der Dropdownliste TargetLang auf die folgende Formel fest:Set the Items property of the TargetLang drop-down list to the following formula:

    MicrosoftTranslator.SpeechLanguages()

  2. Benennen Sie die zweite Bezeichnung (nicht das Feld Source) in Target um.Rename the second label (not the Source box) to Target.
  3. Fügen Sie ein Audio-Steuerelement hinzu (Menü Einfügen > Medien), und legen Sie seine Media-Eigenschaft auf die folgende Formel fest:Add an Audio control (Insert menu > Media), and set its Media property to the following formula:

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

  4. Drücken Sie F5, oder wählen Sie die Vorschauschaltfläche aus ().Press F5, or select the Preview button (). Geben Sie Text in Source ein, wählen Sie eine Sprache in TargetLang aus, und wählen Sie dann die Wiedergabeschaltfläche im Audio-Steuerelement aus.Type some text into Source, select a language in TargetLang, and then select the play button in the audio control.

    Die App spielt eine Audioversion des eingegebenen Texts in der ausgewählten Sprache ab.The app plays an audio version of the text that you entered in the language you chose.

  5. Drücken Sie die ESC-Taste, um zum Standardarbeitsbereich zurückzukehren.Press Esc to return to the default workspace.

Erkennen der AusgangsspracheDetect the source language

In den folgenden Schritten werden die gleichen Texteingabe-Steuerelemente (Source) und Text (Target) verwendet.These next steps use the same Source text input and Target text controls. Sie können auch neue Steuerelemente erstellen, in diesem Fall müssen Sie nur die Namen in der Formel aktualisieren.You can create new controls if you prefer, just update the names in the formula.

  1. Wählen Sie das Text-Steuerelement Target aus, und legen Sie die Text-Eigenschaft auf die folgende Formel fest:Select the Target text control, and set the Text property to the following formula:

    MicrosoftTranslator.Detect(Source.Text).Name

  2. Geben Sie Text in Source ein.Type some text into Source.

    In der Bezeichnung wird die Sprache des eingegebenen Texts angezeigt.The label shows you the language of the text that you typed. In der Bezeichnung wird z.B. Französisch angezeigt, wenn Sie Bonjour eingeben oder Italienisch, wenn Sie Ciao eingeben.For example, the label shows French if you type bonjour, or Italian if you type ciao.

Anzeigen der verfügbaren FunktionenView the available functions

Diese Verbindung umfasst die folgenden Funktionen:This connection includes the following functions:

FunktionsnameFunction Name BeschreibungDescription
SprachenLanguages Ruft alle von Microsoft Translator unterstützten Sprachen abRetrieves all languages that Microsoft Translator supports
TranslateTranslate Übersetzt Text mit Microsoft Translator aus einer angegebenen SpracheTranslates text to a specified language using Microsoft Translator
DetectDetect Erkennt die Ausgangssprache eines angegebenen TextsDetects source language of given text
SpeechLanguagesSpeechLanguages Ruft die verfügbaren Sprachen für die Sprachsynthese abRetrieves the languages available for speech synthesis
TextToSpeechTextToSpeech Konvertiert einen angegebenen Text in Sprache als Audiostream im Wave-FormatConverts a given text into speech as an audio stream in wave format

SprachenLanguages

Sprachen abrufen: Ruft alle von Microsoft Translator unterstützten Sprachen abGet languages: Retrieves all languages that Microsoft Translator supports

EingabeeigenschaftenInput properties

KeineNone.

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name DatentypData Type ErforderlichRequired BeschreibungDescription
CodeCode Zeichenfolgestring NeinNo
NameName Zeichenfolgestring NeinNo

TranslateTranslate

Text übersetzen: Übersetzt Text mit Microsoft Translator aus einer angegebenen SpracheTranslate text: Translates text to a specified language using Microsoft Translator

EingabeeigenschaftenInput properties

NameName DatentypData Type ErforderlichRequired BeschreibungDescription
queryquery Zeichenfolgestring jayes Zu übersetzender TextText to translate
languageTolanguageTo Zeichenfolgestring jayes Code der Zielsprache (Beispiel: „fr“)Target language code (example: 'fr')
languageFromlanguageFrom Zeichenfolgestring Neinno Ausgangssprache (wenn die Sprache nicht angegeben wird, versucht Microsoft Translator, sie automatisch zu erkennen) (Beispiel: en)Source language (if not provided, Microsoft Translator will try to auto-detect) (example: en)
categorycategory Zeichenfolgestring Neinno Übersetzungskategorie (Standard: general)Translation category (default: 'general')

AusgabeeigenschaftenOutput properties

KeineNone.

DetectDetect

Sprache erkennen: Erkennt die Ausgangssprache eines angegebenen TextsDetect language: Detects source language of given text

EingabeeigenschaftenInput properties

NameName DatentypData Type ErforderlichRequired BeschreibungDescription
queryquery Zeichenfolgestring jayes Text, dessen Sprache erkannt werden sollText whose language will be identified

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name DatentypData Type ErforderlichRequired BeschreibungDescription
CodeCode Zeichenfolgestring NeinNo
NameName Zeichenfolgestring NeinNo

SpeechLanguagesSpeechLanguages

Sprachen abrufen: Ruft die verfügbaren Sprachen für die Sprachsynthese abGet speech languages: Retrieves the languages available for speech synthesis

EingabeeigenschaftenInput properties

KeineNone.

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name DatentypData Type ErforderlichRequired BeschreibungDescription
CodeCode Zeichenfolgestring NeinNo
NameName Zeichenfolgestring NeinNo

TextToSpeechTextToSpeech

Text in Sprache: Konvertiert einen angegebenen Text in Sprache als Audiostream im Wave-FormatText to speech: Converts a given text into speech as an audio stream in wave format

EingabeeigenschaftenInput properties

NameName DatentypData Type ErforderlichRequired BeschreibungDescription
queryquery Zeichenfolgestring jayes Zu konvertierender TextText to convert
languagelanguage Zeichenfolgestring jayes Sprachcode für die Sprachgenerierung (Beispiel: en-us)Language code to generate speech (example: 'en-us')

AusgabeeigenschaftenOutput properties

KeineNone.

Alle verfügbaren Verbindungen.See all the available connections.
Erfahren Sie, wie Sie Ihren Apps Verbindungen hinzufügen.Learn how to add connections to your apps.