Power Apps から Microsoft Translator に接続するConnect to Microsoft Translator from Power Apps

Microsoft Translator

Microsoft Translator コネクタを追加すると、アプリのラベル コントロールに翻訳されたテキストを表示できます。Add the Microsoft Translator connector to display translated text in a Label control in your app. たとえば、ユーザーに翻訳するテキストの入力を求める入力用のテキスト ボックスを作成できます。For example, you can create an input text box that asks the user to enter some text to translate. また、別のラベルには翻訳されたテキストを表示できます。In another label, you can display the translated text.

このトピックでは、Microsoft Translator 接続の作成方法とアプリでの Microsoft Translator 接続の使用方法を説明し、使用可能な関数の一覧を示します。This topic shows you how to create the Microsoft Translator connection, use the Microsoft Translator connection in an app, and lists the available functions.

注意

このコネクタの呼び出し数は、ユーザーあたり 1 日 150 件に制限されています。This connector is limited to 150 calls per user per day.

前提条件Prerequisites

Microsoft Translator に接続するConnect to Microsoft Translator

  1. Power Apps を開き、新規 を選択して、空のアプリを作成します。Open Power Apps, select New, and then create a Blank app. 携帯電話またはタブレットのレイアウトを選択します。Choose phone or tablet layout. タブレットのレイアウトの方がワークスペースが広くなります。Tablet layout gives you more workspace:

    空のアプリを開く

  2. 右側のウィンドウで、 [データ] タブをクリックまたはタップし、 [データソースの追加] をクリックまたはタップします。In the right-hand pane, click or tap Data tab, and then click or tap Add data source.

  3. [新しい接続][Microsoft Translator] の順に選択します。Select New connection, and then select Microsoft Translator:

    Microsoft Translator に接続する

    Microsoft Translator に接続する

  4. [接続] を選択します。Select Connect. [データ ソース] の下に接続が表示されます。Your connection appears under Data sources:

    Microsoft Translator に接続する

アプリで Microsoft Translator 接続を使用するUse the Microsoft Translator connection in your app

テキストの翻訳Translate text

  1. [挿入] メニューで、 [テキスト][Text input] (テキスト入力) の順に選択します。On the Insert menu, select Text, and then select Text input. テキスト入力コントロールの名前を Source に変更します。Rename the text input control to Source:

    名前の変更

  2. [挿入] メニューの [コントロール] から [ドロップ ダウン] を追加し、名前を TargetLang に変更して Source の下に移動します。Add a Drop down list (Insert menu > Controls), rename it to TargetLang, and move it below Source.

  3. TargetLangItems プロパティに次の式を設定します。Set the Items property of TargetLang to the following formula:

    MicrosoftTranslator.Languages()

  4. ラベルを追加して TargetLang の下に移動させ、 Text プロパティに次の式を設定します。Add a label, move it below TargetLang, and set its Text property to the following formula:

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

  5. Source にテキストを入力し、TargetLang で言語を選択します。Type some text into Source, and select a language in TargetLang. ラベルに、入力したテキストが選択した言語で表示されます。The label shows the text that you entered in the language you chose:

    英語からスペイン語へのテキスト翻訳

翻訳されたテキストの読み上げSpeak translated text

まだ翻訳していない場合は、前のセクションの手順に従ってテキストを翻訳します。If you haven't already, follow the steps in the previous section to translate some text. 以下の手順では、前のセクションと同じコントロールを使用します。These next steps use the same controls.

  1. TargetLang のドロップダウン リストの Items プロパティに次の式を設定します。Set the Items property of the TargetLang drop-down list to the following formula:

    MicrosoftTranslator.SpeechLanguages()

  2. 2 つ目のラベル (Source ボックスではない方) の名前を Target に変更します。Rename the second label (not the Source box) to Target.

  3. [挿入] メニューの [メディア] からオーディオ コントロールを追加し、Media プロパティに次の式を設定します。Add an Audio control (Insert menu > Media), and set its Media property to the following formula:

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

  4. F5 キーを押すか、[プレビュー] ボタン () を選びます。Press F5, or select the Preview button (). Source にテキストを入力して TargetLang で言語を選択してから、オーディオ コントロールの再生ボタンを選択します。Type some text into Source, select a language in TargetLang, and then select the play button in the audio control.

    入力した言語が選択した言語の音声で読み上げられます。The app plays an audio version of the text that you entered in the language you chose.

  5. Esc キーを押して既定のワークスペースに戻ります。Press Esc to return to the default workspace.

ソース言語の検出Detect the source language

次の手順では、前のセクションと同じ Source のテキスト入力コントロールと Target のテキスト コントロールを使用します。These next steps use the same Source text input and Target text controls. 必要であれば新しいコントロールを作成し、式の名前をその名前に更新してください。You can create new controls if you prefer, just update the names in the formula.

  1. Target のテキスト コントロールを選択し、 Text プロパティに次の式を設定します。Select the Target text control, and set the Text property to the following formula:

    MicrosoftTranslator.Detect(Source.Text).Name

  2. Source にテキストを入力します。Type some text into Source.

    ラベルに、入力したテキストの言語が表示されます。The label shows you the language of the text that you typed. たとえば、ラベルには、「bonjour」と入力すると「French」(フランス語) と表示され、「ciao」と入力すると「Italian」(イタリア語) と表示されます。For example, the label shows French if you type bonjour, or Italian if you type ciao.

使用可能な関数の確認View the available functions

この接続には、次の関数が含まれています。This connection includes the following functions:

関数名Function Name DescriptionDescription
LanguagesLanguages Microsoft Translator でサポートされるすべての言語を取得します。Retrieves all languages that Microsoft Translator supports
TranslateTranslate Microsoft Translator を使用してテキストを指定された言語に翻訳します。Translates text to a specified language using Microsoft Translator
DetectDetect 入力したテキストのソース言語を検出します。Detects source language of given text
SpeechLanguagesSpeechLanguages 音声合成に使用できる言語を取得します。Retrieves the languages available for speech synthesis
TextToSpeechTextToSpeech 入力したテキストを、WAVE 形式の音声ストリームの音声に変換します。Converts a given text into speech as an audio stream in wave format

言語:Languages

言語の取得: Microsoft Translator でサポートされるすべての言語を取得します。Get languages: Retrieves all languages that Microsoft Translator supports

入力プロパティInput properties

なし。None.

出力プロパティOutput properties

プロパティ名Property Name データ型Data Type 必須Required DescriptionDescription
コードCode stringstring いいえNo
名前Name stringstring いいえNo

TranslateTranslate

テキストの翻訳: Microsoft Translator を使用してテキストを指定された言語に翻訳します。Translate text: Translates text to a specified language using Microsoft Translator

入力プロパティInput properties

名前Name データ型Data Type 必須Required DescriptionDescription
queryquery stringstring はいyes 翻訳するテキストText to translate
languageTolanguageTo stringstring はいyes 翻訳先言語のコード (例: fr (フランス語))Target language code (example: 'fr')
languageFromlanguageFrom stringstring いいえno ソース言語 (指定しない場合、自動検出が行われます) (例: en (英語))Source language (if not provided, Microsoft Translator will try to auto-detect) (example: en)
categorycategory stringstring いいえno 翻訳のカテゴリ (既定値: general (一般))Translation category (default: 'general')

出力プロパティOutput properties

なし。None.

DetectDetect

言語の検出: 入力したテキストのソース言語を検出します。Detect language: Detects source language of given text

入力プロパティInput properties

名前Name データ型Data Type 必須Required DescriptionDescription
queryquery stringstring はいyes 言語を特定するテキストText whose language will be identified

出力プロパティOutput properties

プロパティ名Property Name データ型Data Type 必須Required DescriptionDescription
コードCode stringstring いいえNo
名前Name stringstring いいえNo

SpeechLanguagesSpeechLanguages

音声言語の取得: 音声合成に使用できる言語を取得します。Get speech languages: Retrieves the languages available for speech synthesis

入力プロパティInput properties

なし。None.

出力プロパティOutput properties

プロパティ名Property Name データ型Data Type 必須Required DescriptionDescription
コードCode stringstring いいえNo
名前Name stringstring いいえNo

TextToSpeechTextToSpeech

テキストの音声変換: 入力したテキストを、WAVE 形式の音声ストリームの音声に変換します。Text to speech: Converts a given text into speech as an audio stream in wave format

入力プロパティInput properties

名前Name データ型Data Type 必須Required DescriptionDescription
queryquery stringstring はいyes 変換するテキストText to convert
languagelanguage stringstring はいyes 音声を生成する言語コード (例: en-us (米国英語))Language code to generate speech (example: 'en-us')

出力プロパティOutput properties

なし。None.

利用可能な接続をすべて表示する。See all the available connections.
アプリに接続を追加する方法を確認する。Learn how to add connections to your apps.