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
Lit le texte spécifié en utilisant le moteur de synthèse vocale de l'appareil.
Exemple
SynthèseVocaleLitTexte("WINDEV, c'est bien !")
Syntaxe
<Résultat> = SynthèseVocaleLitTexte(<Texte> [, <Bloquant>])
<Résultat> : Entier
  • Vrai si le texte a été lu (mode bloquant) ou si le texte a été ajouté à la file d'attente de lecture (mode non bloquant),
  • Faux en cas d'échec. En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Texte> : Chaîne de caractères
Texte à lire.
<Bloquant> : Booléen optionnel
  • Vrai : la fonction est exécutée en mode bloquant. Le code suivant l'appel de la fonction sera exécuté lorsque la totalité du texte aura été lue ou en cas d'échec de la fonction. Un sablier sera affiché durant la lecture. Utilisez la fonction TitreSuivant pour personnaliser le message affiché par le sablier.
    iPhone/iPadWidget IOSMac Catalyst Ce mode d'exécution n'est pas disponible.
  • Faux (valeur par défaut) : la fonction est exécutée en mode non bloquant. Le code suivant l'appel de la fonction sera exécuté dès le début de la lecture du texte ou en cas d'échec de la fonction.
Remarques

Fonctionnement

  • 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.
  • 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.
  • Si une nouvelle lecture est déclenchée alors qu'une autre est en cours, la nouvelle lecture démarrera uniquement à la fin de la précédente.
    Pour savoir si une lecture est en cours par le moteur de synthèse vocale, utilisez la fonction SynthèseVocaleEnCours.
    Pour stopper les lectures en cours, utilisez la fonction SynthèseVocaleArrête.
  • Pour fixer les paramètres à utiliser par le moteur de synthèse vocale (langue, vitesse d'énonciation, etc.), utilisez la fonction SynthèseVocaleInitialise.
    Si les paramètres de la synthèse vocale n'ont pas été précédemment fixés par la fonction SynthèseVocaleInitialise, les paramètres par défaut seront utilisés et la langue pour la lecture du texte sera la première langue disponible pour le moteur de synthèse vocale parmi la séquence suivante :
    • 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.
  • Pour lire le contenu d'un fichier texte, utilisez la fonction SynthèseVocaleLitFichier.
  • AndroidWidget Android Pour régler le volume de la lecture, utilisez la fonction VolumeModifie avec la constante volumeMusique.
  • Attention : la fonction SynthèseVocaleLitTexte ne lit pas le texte instantanément lorsque le mobile est en veille. Dans ce cas, il est possible :
    • soit d'empêcher la mise en veille avec la fonction SysMiseEnVeille.
    • AndroidWidget Android soit d'utiliser un thread persistant (fonction ThreadPersistant) pour que l'application continue à s'exécuter même pendant la veille.
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èseVocaleLitTexte 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.
Liste des exemples associés :
Android Synthèse Vocale Android (WINDEV Mobile) : Android Synthèse Vocale
[ + ] Cet exemple didactique montre comment gérer la reconnaissance et la synthèse vocale sous Android.
La synthèse vocale se fait en utilisant soit les fonctions WLangage, soit un fichier JAR externe intégré dans le projet WINDEV Mobile.
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