Ajoutez le connecteur Microsoft Translator pour afficher le texte traduit dans un contrôle Label 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.
Remarque : ce connecteur est limité à 150 appels par utilisateur et par jour.
Ce dont vous avez besoin pour commencer
- Accéder à powerapps.com ou installer PowerApps
- Ajouter la connexion
- Créer une application à partir d’un modèle ou de données ou entièrement
Connexion à Microsoft Translator
Ouvrez PowerApps, sélectionnez New (Nouveau), puis créez une application vide. Choisissez le mode téléphone ou tablette. Le mode tablette offre un espace de travail plus important :
Dans le volet droit, ouvrez l’onglet Data sources (Sources de données), puis cliquez ou appuyez sur Add data source (Ajouter une source de données).
Sélectionnez Add connection (Ajouter une connexion), puis Microsoft Translator :
Sélectionnez Connect (Se connecter). Votre connexion apparaît sous Data sources (Sources de données) :
Utiliser la connexion Microsoft Translator dans votre application
Traduire du texte
Dans le menu Insérer, sélectionnez Texte, puis Saisie de texte. Affectez au contrôle de saisie de texte le nom Source :
Ajoutez une liste déroulante via le menu Insert > Controls (Insertion > Contrôles), renommez-la TargetLang, et déplacez-la sous Source.
Définissez la propriété Items de TargetLang sur la formule suivante :
MicrosoftTranslator.Languages()Ajoutez une étiquette, déplacez-la sous TargetLang, et définissez sa propriété Text sur la formule suivante :
MicrosoftTranslator.Translate(Source.Text, TargetLang.Selected.Value)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 :
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.
Définissez la propriété Items de la liste déroulante TargetLang sur la formule suivante :
MicrosoftTranslator.SpeechLanguages()Renommez la deuxième étiquette (pas la zone Source) en Target.
Ajoutez un contrôle Audio via le menu Insert > Media (Insertion > Média), puis définissez sa propriété Media sur la formule suivante :
MicrosoftTranslator.TextToSpeech(Target.Text, TargetLang.Selected.Value)Appuyez sur F5 ou cliquez sur le bouton d’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.
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.
Sélectionnez le contrôle de texte Target et définissez la propriété Text sur la formule suivante :
MicrosoftTranslator.Detect(Source.Text).NameTapez 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 la propriété | Type de données | Obligatoire | Description |
| Code | chaîne | Non | |
| Nom | chaîne | Non |
Traduire
Translate text : traduit le texte dans une langue spécifique à l’aide de Microsoft Translator
Propriétés d’entrée
| Nom | Type de données | Obligatoire | Description |
| query | chaîne | oui | Texte à traduire |
| languageTo | chaîne | oui | Code de la langue cible (exemple : « fr ») |
| languageFrom | chaîne | non | Langue source (si elle n’est pas spécifiée, Microsoft Translator essaiera de la détecter automatiquement) (exemple : « en ») |
| catégorie | chaîne | 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 | Obligatoire | Description |
| query | chaîne | oui | Texte dont la langue est identifiée |
Propriétés de sortie
| Nom de la propriété | Type de données | Obligatoire | Description |
| Code | chaîne | Non | |
| Nom | chaîne | 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 la propriété | Type de données | Obligatoire | Description |
| Code | chaîne | Non | |
| Nom | chaîne | Non |
TextToSpeech
Text to speech : convertit un texte donné en flux audio au format wave
Propriétés d’entrée
| Nom | Type de données | Obligatoire | Description |
| query | chaîne | oui | Texte à convertir |
| language | chaîne | oui | Code de langue utilisé pour la synthèse vocale (exemple : « en-us ») |
Propriétés de sortie
Aucune.
Liens utiles
Consultez toutes les connexions disponibles.
Découvrez comment ajouter des connexions dans vos applications.