Connexion à Microsoft Translator depuis Power Apps

Microsoft Translator.

Ajoutez le connecteur Microsoft Translator pour afficher le texte traduit dans un contrôle Étiquette de votre application. Par exemple, vous pouvez créer une zone de saisie qui invite l’utilisateur à entrer du texte à traduire. Dans une autre Étiquette, vous pouvez afficher le texte traduit.

Cette rubrique explique comment créer la connexion Microsoft Translator et l’utiliser dans une application, et répertorie les fonctions disponibles.

Conditions préalables

Connexion à Microsoft Translator

  1. Créez une application canevas vide.

  2. Dans le volet de gauche, cliquez sur l’onglet Données, puis sur Ajouter une source de données.

  3. Sélectionnez Nouvelle connexion, puis Microsoft Translator :

    Connectez-vous à Microsoft Translator.

  4. Cliquez sur Se connecter. Votre connexion apparaît sous Sources de données :

    Connexion.

Utiliser la connexion Microsoft Translator dans votre application

Traduire du texte

  1. Dans la Vue arborescente sur le côté gauche de l’écran, sélectionnez Insérer, puis choisissez le contrôle Texte Input. Renommez le contrôle Texte input en Source.

  2. Ajoutez une liste déroulante via le menu Insertion > Contrôles, renommez-la TargetLang, et déplacez-la sous Source.

  3. Définissez la propriété Items de TargetLang sur la formule suivante :

    MicrosoftTranslator.Languages()

  4. Ajoutez une Étiquette, déplacez-la sous TargetLang, et définissez sa propriété Texte sur la formule suivante :

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

  5. Tapez du texte dans Source, puis sélectionnez une langue dans TargetLang. L’Étiquette affiche le texte saisi dans la langue que vous avez choisie :

    Traduire du texte de l’anglais vers l’espagnol.

Restituer oralement du texte traduit

Si vous ne l’avez pas encore fait, suivez les étapes décrites dans la section précédente pour traduire du texte. Les étapes suivantes utilisent les mêmes contrôles.

  1. Définissez la propriété Items de la liste déroulante TargetLang sur la formule suivante :

    MicrosoftTranslator.SpeechLanguages()

  2. Renommez la deuxième Étiquette (pas la zone Source) en Target.

  3. Ajoutez un contrôle Audio via le menu Insertion > Média, puis définissez sa propriété Média sur la formule suivante :

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

  4. Appuyez sur F5 ou sélectionnez le bouton Aperçu (icône Aperçu.). Tapez du texte dans Source, sélectionnez la langue dans TargetLang, puis sélectionnez le bouton de lecture dans le contrôle audio.

    L’application lit une version audio du texte saisi dans la langue que vous avez choisie.

  5. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Détection de la langue source

Ces étapes utilisent la même zone de saisie Source et les mêmes contrôles de texte Target. Vous pouvez créer de nouveaux contrôles si vous le souhaitez. Il vous suffit simplement de mettre à jour les noms dans la formule.

  1. Sélectionnez le contrôle de texte Target et définissez la propriété Texte sur la formule suivante :

    MicrosoftTranslator.Detect(Source.Text).Name

  2. Tapez du texte dans Source.

    L’Étiquette affiche la langue du texte que vous avez saisi. Par exemple, l’étiquette affiche Français si vous tapez bonjour, ou italien si vous tapez ciao.

Afficher les fonctions disponibles

Cette connexion comprend les fonctions suivantes :

Nom de la fonction Description
Langues Récupère toutes les langues prises en charge par Microsoft Translator
Traduire Traduit le texte dans une langue spécifique à l’aide de Microsoft Translator
Détecter Détecte la langue source du texte
SpeechLanguages Récupère les langues disponibles pour la synthèse vocale
TextToSpeech Convertit un texte donné en flux audio au format wave

Langues

Get languages : récupère toutes les langues prises en charge par Microsoft Translator

Propriétés d’entrée

Aucune.

Propriétés de sortie

Nom de propriété Type de données Nécessaire Description
Code string Non
Nom string Non

Traduire

Translate Texte : traduit le texte dans une langue spécifique à l’aide de Microsoft Translator

Propriétés d’entrée

Nom Type de données Nécessaire Description
query string oui Texte à traduire
languageTo string oui Code de la langue cible (exemple : « fr »)
languageFrom string non Langue source (si elle n’est pas spécifiée, Microsoft Translator essaiera de la détecter automatiquement) (exemple : « en »)
catégorie string non Catégorie de traduction (par défaut : « général »)

Propriétés de sortie

Aucune.

Détecter

Detect language : détecte la langue source du texte

Propriétés d’entrée

Nom Type de données Nécessaire Description
query string oui Texte dont la langue est identifiée

Propriétés de sortie

Nom de propriété Type de données Nécessaire Description
Code string Non
Nom string Non

SpeechLanguages

Get speech languages : récupère les langues disponibles pour la synthèse vocale

Propriétés d’entrée

Aucune.

Propriétés de sortie

Nom de propriété Type de données Nécessaire Description
Code string Non
Nom string Non

TextToSpeech

Texte to speech : convertit un texte donné en flux audio au format wave

Propriétés d’entrée

Nom Type de données Nécessaire Description
query string oui Texte à convertir
langue string oui Code de langue utilisé pour la synthèse vocale (exemple : « en-us »)

Propriétés de sortie

Aucune.

Consultez toutes les connexions disponibles.
Découvrez comment ajouter des connexions dans vos applications.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).