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 contenu du fichier spécifié en utilisant le moteur de synthèse vocale de l'appareil.
Exemple
SynthèseVocaleLitFichier("/sdcard/email.txt")
Syntaxe
<Résultat> = SynthèseVocaleLitFichier(<Nom et chemin du fichier Texte> [, <Bloquant>])
<Résultat> : Booléen
  • Vrai si le contenu du fichier a été lu (mode bloquant) ou si le contenu du fichier 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.
<Nom et chemin du fichier Texte> : Chaîne de caractères
Nom et chemin complet (ou relatif) du fichier 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 fichier 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 fichier 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 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'une chaîne de caractères, utilisez la fonction SynthèseVocaleLitTexte.
  • AndroidWidget Android Pour régler le volume de la lecture, utilisez la fonction VolumeModifie avec la constante volumeMusique.
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èseVocaleLitFichier 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.
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