DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions Synthèse Vocale
  • Fonctionnement
  • Application en arrière-plan : Spécificité à partir de Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Initialise les paramètres de la synthèse vocale pour l'application en cours. Il est possible d'initialiser :
  • Uniquement la langue utilisée (syntaxe 1).
  • Toutes les caractéristiques de la voix via une variable de type VoixDeSynthèse (syntaxe 2).
Remarque : L'utilisation de la fonction SynthèseVocaleInitialise n'est pas obligatoire. Si la fonction SynthèseVocaleLitTexte ou la fonction SynthèseVocaleLitFichier est appelée sans que les paramètres de la synthèse vocale n'aient été précisés avec la fonction SynthèseVocaleInitialise, les paramètres par défaut seront utilisés.
Exemple
SI PAS SynthèseVocaleInitialise(NationVersLangue(Nation())) ALORS
Erreur("Echec de l'initialisation de la synthèse vocale.", ErreurInfo())
FIN
Syntaxe

Initialiser uniquement la langue Masquer les détails

<Résultat> = SynthèseVocaleInitialise(<Langue> [, <Vitesse>])
<Résultat> : Booléen
  • Vrai si l'initialisation a fonctionné,
  • Faux en cas d'échec. Dans ce cas, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Langue> : Entier ou constante de type Entier
  • Langue à utiliser pour la lecture du texte. Si la langue spécifiée n'est pas supportée par le moteur de synthèse vocale, la fonction retournera Faux et la première langue disponible parmi la séquence suivante sera utilisée :
    • Langue de l'application (langue par défaut ou définie par la fonction Nation).
    • Langue de l'appareil
    • Anglais
    • Langue par défaut du moteur de synthèse vocale.
  • 0 pour utiliser la langue courante de l'application.
Les constantes disponibles sont les suivantes :
langueAfrikaansAfrikaans
langueAlbanaisAlbanais
langueAllemandAllemand
langueAnglaisAnglais
langueArabeArabe
langueArménienArménien
langueBengaliBengali
langueBiélorusseBiélorusse
langueBulgareBulgare
langueCatalanCatalan
langueChinoisChinois
langueCoréenCoréen
langueCroateCroate
langueDanoisDanois
langueEspagnolEspagnol
langueEstonienEstonien
langueFinnoisFinnois
langueFrançaisFrançais
langueGéorgienGéorgien
langueGrecGrec
langueHébreuHébreu
langueHindiHindi
langueHongroisHongrois
langueIndonésienIndonésien
langueIslandaisIslandais
langueItalienItalien
langueJaponaisJaponais
langueLettonLetton
langueLituanienLituanien
langueMacédonienMacédonien
langueNéerlandaisNéerlandais
langueNorvégienNorvégien
langueOuzbekOuzbek
languePendjabiPendjabi
languePolonaisPolonais
languePortugaisPortugais
langueRoumainRoumain
langueRusseRusse
langueSerbeSerbe
langueSindhiSindhi
langueSlovaqueSlovaque
langueSlovèneSlovène
langueSuédoisSuédois
langueTchèqueTchèque
langueThaïThaï
langueTurcTurc
langueUkrainienUkrainien
langueVietnamienVietnamien
<Vitesse> : Entier optionnel
Vitesse d'énonciation du texte, comprise entre 0 (très lent) et 10 (très rapide). Si ce paramètre n'est pas spécifié, sa valeur sera de 5 (vitesse moyenne).
Universal Windows 10 App Ce paramètre n'est pas pris en compte. La vitesse d'énonciation est réglable uniquement dans les paramètres du mobile utilisé (option "Paramètres .. Heure et langue .. Voix").

Initialiser l'ensemble des caractéristiques de la voix Masquer les détails

<Résultat> = SynthèseVocaleInitialise(<Voix> [, <Vitesse>])
<Résultat> : Booléen
  • Vrai si l'initialisation a fonctionné,
  • Faux en cas d'échec. Dans ce cas, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Voix> : Variable de type VoixDeSynthèse
Nom de la variable de type VoixDeSynthèse à utiliser pour la lecture du texte.
<Vitesse> : Entier optionnel
Vitesse d'énonciation du texte, comprise entre 0 (très lent) et 10 (très rapide). Si ce paramètre n'est pas spécifié, sa valeur sera de 5 (vitesse moyenne).
Universal Windows 10 App Ce paramètre n'est pas pris en compte. La vitesse d'énonciation est réglable uniquement dans les paramètres du mobile utilisé (option "Paramètres .. Heure et langue .. Voix").
Remarques

Fonctionnement

  • AndroidWidget Android Si aucun moteur de synthèse vocale n'est installé sur l'appareil, son téléchargement sera automatiquement proposé.
    Si la langue à utiliser pour la synthèse vocale n'est pas celle du système, cette langue doit être précisée dans le réglage "Moteur de synthèse vocale" des paramètres de Android. A l'entrée "Langue", remplacez "Langue du système" par la langue désirée.
  • Pour synthétiser une chaîne de caractères ou un fichier texte, utilisez respectivement les fonctions SynthèseVocaleLitTexte et SynthèseVocaleLitFichier.
  • Universal Windows 10 App Par défaut, seul le moteur de synthèse vocale de la langue par défaut du système est installé. Pour installer un autre moteur de synthèse vocale, utilisez les paramètres de l'appareil (option "Paramètres .. Heure et langue .. Langue").
  • AndroidWidget Android Les fonctions de synthèse vocale sont disponibles uniquement sur les appareils disposant d'une version d'Android supérieure ou égale à la version 1.6 (api level 4).
    Si la fonction est utilisée avec une version antérieure du système, une erreur fatale sera déclenchée.
    Pour connaître la version du système Android sur laquelle s'exécute l'application, utilisez la fonction SysVersionAndroid.
  • iPhone/iPadWidget IOSMac Catalyst Les fonctions de synthèse vocale sont disponibles uniquement sur les appareils disposant d'une version d'iOS supérieure à la version 6. La synthèse vocale ne fonctionne pas sur les émulateurs iOS 8.
Universal Windows 10 App Fonctionnalité d'application requise
L'utilisation de cette fonction entraîne la déclaration d'une fonctionnalité d'application dans l'assistant de génération de l'application.
Fonctionnalité requise : Microphone : Cette fonctionnalité permet aux applications d'effectuer des enregistrements audio.
AndroidWidget Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction SynthèseVocaleInitialise peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Classification Métier / UI : Code UI
Composante : wd290android.aar
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale