AudioTextToSpeech
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
AudioTextToSpeech est utilisé pour jouer du texte en tant qu'audio de discours.Il fournit un seul sortie pin qui peut être connecté à d'autres pins via Wires .Cette API est encore en développement et n'est pas encore publiquement disponible.
Échantillons de code
local audioTextToSpeech : AudioTextToSpeech = Instance.new("AudioTextToSpeech")
audioTextToSpeech.Parent = workspace
audioTextToSpeech.Text = "Hello! Converting text into speech is fun!"
audioTextToSpeech.VoiceId = "1"
local deviceOutput = Instance.new("AudioDeviceOutput")
deviceOutput.Parent = workspace
local wire = Instance.new("Wire")
wire.Parent = workspace
wire.SourceInstance = audioTextToSpeech
wire.TargetInstance = deviceOutput
local count = 0
local connection = nil
connection = audioTextToSpeech.Ended:Connect(function()
audioTextToSpeech.Text = "I can count to " .. count .. " because I am very smart"
audioTextToSpeech.VoiceId = "2"
audioTextToSpeech.TimePosition = 0
audioTextToSpeech:Play()
count += 1
if count > 10 then
connection:Disconnect()
end
end)
audioTextToSpeech:Play()Résumé
Propriétés
Indique si l'objet AudioTextToSpeech est chargé, tamponné et prêt à jouer.
Indique si l'objet AudioTextToSpeech est en train de jouer actuellement.
Contrôle si les boucles d'objets AudioTextToSpeech s'exécutent.
Contrôle le ton de l'audio de discours généré, qui sera indépendant de sa vitesse.
Contrôle la vitesse à laquelle l'audio du discours sera joué, ce qui contrôle sa hauteur.
Contrôle la vitesse de l'audio de discours généré, qui sera indépendant de son ton.
Le texte à convertir en audio en langue parlée par AudioTextToSpeech .
Indique la longueur de l'audio de discours généré.
Suit la position actuelle de la tête de lecture dans l'audio de discours généré.
Le style de voix à utiliser par AudioTextToSpeech.
Contrôle le volume à lequel le son audio généré sera joué.
Méthodes
Renvoie un tableau de Wires qui sont connectés au épinglerspécifié.
Pause l'objet AudioTextToSpeech partout où son TimePosition est.
Joue le AudioTextToSpeech de n'importe où où son TimePosition est.
Déchargez l'audio de discours généré.
Génère de l'audio de discours.
Évènements
S'enflamme lorsque l'objet AudioTextToSpeech a terminé la lecture et a été interrompu.
S'enflamme lorsque les boucles d'objet AudioTextToSpeech s'exécutent.
Se déclenche lorsqu'une autre instance est connectée ou déconnectée du AudioTextToSpeech via un Wire .
Propriétés
IsLoaded
Indique si l'objet AudioTextToSpeech est chargé, tamponné et prêt à jouer.Bien que peu commun, les objets AudioTextToSpeech peuvent avoir leurs ressources déchargées au moment de l'exécution s'il y a une pression mémoire extrême, auquel cas IsLoaded deviendra faux.
IsPlaying
Indique si l'objet AudioTextToSpeech est en train de jouer actuellement.Cette propriété est lue seule, mais se réplique.Pour jouer et arrêter un objet AudioTextToSpeech à l'exécution, utilisez les méthodes Play() et Pause().
Looping
Contrôle si les boucles d'objets AudioTextToSpeech lorsqu'elles dépassent la fin de son TimeLength .
Pitch
Une valeur en tons musicaux.L'intonation de l'audio de discours généré est déplacée de sa valeur par défaut de AudioTextToSpeech.Pitch demi-tons.Va de -12.0 à 12.0.
PlaybackSpeed
Multiplicateur contrôlant la vitesse à laquelle l'audio du discours sera joué, contrôlant directement sa hauteur perçue. S'étend de 0 à 20.
Speed
Multiplicateur contrôlant la vitesse de l'audio de discours généré. S'étend de 0,5 à 2,0.
TimePosition
Suit et contrôle la position actuelle de la tête de lecture dans l'audio de discours généré, en secondes.
Volume
Niveau de volume qui est multiplié sur le flux audio de sortie, contrôlant à quel point le son généré sera diffusé fort. S'étend de 0 à 3.
Méthodes
GetConnectedWires
Retourne un tableau de Wires qui sont connectés au épinglerspécifié. AudioTextToSpeech a un épingler« Sortie ».
Paramètres
Retours
Pause
Pause l'objet AudioTextToSpeech n'importe où où son TimePosition est. Répliques du serveur au client.
Retours
Play
Joue le AudioTextToSpeech de n'importe où son TimePosition est. Se réplique du serveur au client.
Retours
Unload
Gèle les ressources en déchargeant l'audio de discours généré.
Retours
GetWaveformAsync
Paramètres
Retours
LoadAsync
Un appel de blocage qui commence la génération d'audio de discours en fonction des paramètres actuels.Il produira jusqu'à ce que la génération de discours soit terminée ou échoue.Le statut est renvoyé par une valeur AssetFetchStatus.
Retours
Évènements
Ended
Feux après que l'objet AudioTextToSpeech ait terminé la lecture et été interrompu.Notez que cet événement ne ne tirera pas pour l'audio avec défini sur depuis qu'il continue de jouer lorsqu'il atteint sa terminer.Cet événement ne se déclenchera pas non plus lorsque l'audio est en pause avant que la lecture n'ait été terminée ; pour cela, utilisez sur la propriété >.
Cet événement peut être utilisé pour détruire un objet AudioTextToSpeech lorsqu'il a terminé la lecture.
Looped
Événement qui se déclenche après les boucles d'objets AudioTextToSpeech qui se terminent. Cela se produit lorsque l'audio atteint la fin de son contenu et Looping est true .
Cet événement ne déclenche pas pas de feu si l'audio est bouclé manuellement en modifiant son TimePosition.
WiringChanged
Événement qui se déclenche après qu'un Wire devienne connecté ou déconnecté, et que Wire soit maintenant ou ait été précédemment connecté à un bouton sur le AudioTextToSpeech et à une autre instance wirable.
Paramètres
Si l'instance s'est connectée ou déconnectée.
L'épingle sur le AudioTextToSpeech que les cibles Wire .
Le Wire entre la AudioTextToSpeech et l'autre instance.