AudioTextToSpeech
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
AudioTextToSpeech wird verwendet, um Text als Sprachaudio wiederzugeben.Es bietet einen einzigen Ausgabe-Pin, der mit anderen Pins über verbunden werden kann.Diese API befindet sich noch in der Entwicklung und ist noch nicht öffentlich verfügbar.
Code-Beispiele
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()Zusammenfassung
Eigenschaften
Zeigt an, ob das AudioTextToSpeech Objekt geladen, gebuffert und bereit zum spielenist.
Zeigt an, ob das AudioTextToSpeech Objekt derzeit gespielt wird.
Steuert, ob die AudioTextToSpeech Objekt-Schleifen laufen.
Steuert die Tonhöhe des generierten Audiodateien, die unabhängig von seiner Geschwindigkeit sein wird.
Steuert, wie schnell das Sprachaudio wiedergegeben wird, das seine Tonhöhe kontrolliert.
Steuert die Geschwindigkeit des generierten Audiodateien, das unabhängig von seiner Tonhöhe sein wird.
Der Text, der in Sprachaudio umgewandelt werden soll durch AudioTextToSpeech .
Zeigt die Länge des generierten Audiodateienan.
Verfolgt die aktuelle Position des Spielkopfes innerhalb des generierten Audiodateien.
Der Stil der Stimme, die von AudioTextToSpeech verwendet werden soll.
Steuert, wie laut das generierte Sprachaudio wiedergegeben wird.
Methoden
Gibt eine Reihe von Wires, die mit dem angegebenen anheftenverbunden sind, zurück.
Pausiert das AudioTextToSpeech Objekt, wo immer seine TimePosition ist.
Spielt die AudioTextToSpeech von überall aus, wo seine TimePosition ist.
Entlade das generierte Audiodateien.
Erzeugt Audiodateien.
Ereignisse
Feuert, wenn das AudioTextToSpeech-Objekt den Wiedergang abgeschlossen und unterbrochen hat.
Feuert, wenn die AudioTextToSpeech Objekt-Schleifen laufen.
Feuert, wenn eine andere Instanz über einen AudioTextToSpeech mit der Wire verbunden oder getrennt wird.
Eigenschaften
IsLoaded
Zeigt an, ob das AudioTextToSpeech Objekt geladen, gebuffert und bereit zum spielenist.Obwohl ungewöhnlich, können AudioTextToSpeech Objekte ihre Assets zur Laufzeit entladen, wenn es extremer Speicherdruck gibt, in dem Fall wird IsLoaded falsch.
IsPlaying
Zeigt an, ob das AudioTextToSpeech Objekt derzeit gespielt wird.Diese Eigenschaft ist nur lesbar, aber repliziert.Um ein AudioTextToSpeech Objekt zur Laufzeit zu spielen und zu stoppen, verwende die Play() und Pause() Methoden.
Looping
Steuert, ob die AudioTextToSpeech Objekt-Schleifen, wenn sie das Ende ihrer TimeLength überschreiten, kontrollieren.
Pitch
Ein Wert in musikalischen Semitonen.Die Tonhöhe des generierten Sprachaudios wird von seinem Standardwert durch AudioTextToSpeech.Pitch Semitone verschoben.Reicht von -12.0 bis 12.0.
PlaybackSpeed
Multiplikator, der kontrolliert, wie schnell das gesprochene Audio wiedergegeben wird, und dessen wahrgenommene Tonhöhe direkt steuert. Reichweite von 0 bis 20.
Speed
Multiplikator, der die Geschwindigkeit des generierten Audiodateienkontrolliert. Reicht von 0.5 bis 2.0.
TimePosition
Verfolgt und steuert die aktuelle Position des Spielkopfes innerhalb des generierten Audiodateienin Sekunden.
Volume
Lautstärkelevel, das auf den Ausgabe-Audio-Stream multipliziert wird, und kontrolliert, wie laut das generierte Sprachaudio wiedergegeben wird. Reichweite von 0 bis 3.
Methoden
GetConnectedWires
Gibt eine Reihe von Wires, die mit dem angegebenen anheftenverbunden sind. AudioTextToSpeech hat eine "Ausgabe"anheften.
Parameter
Rückgaben
Pause
Pausiert das AudioTextToSpeech Objekt, wo immer seine TimePosition ist. Replikation vom Server zum Client.
Rückgaben
Play
Spielt die AudioTextToSpeech von überall aus, wo seine TimePosition ist. Repliziert vom Server zum Client.
Rückgaben
Unload
Freigibt Ressourcen, indem es das generierte Audiodateienentlastet.
Rückgaben
GetWaveformAsync
Parameter
Rückgaben
LoadAsync
Ein Blockieranruf, der die Erzeugung von Sprachaudios auf der Grundlage der aktuellen Parameter beginnt.Es wird bis zur Fertigstellung der Sprachgenerierung abgegeben oder bis zum Scheitern.Status wird durch einen AssetFetchStatus-Wert zurückgegeben.
Rückgaben
Ereignisse
Ended
Feuert nachdem das AudioTextToSpeech Objekt den Wiedergang abgeschlossen und unterbrochen hat.Beachten Sie, dass dieses Ereignis nicht für Audio feuern wird, mit Looped festgelegt auf true, da es weiter spielt, wenn es sein beendenerreicht.Dieses Ereignis wird auch nicht feuern, wenn das Audio unterbrochen wird, bevor die Wiedergabe abgeschlossen ist; dazu verwenden Sie auf der Eigenschaften.
Dieses Ereignis kann verwendet werden, um ein AudioTextToSpeech Objekt zu zerstören, wenn es den Abruf abgeschlossen hat.
Looped
Ereignis, das nach den Objekt-Schleifen abgefeuert wird. Dies geschieht, wenn das Audio das Ende seines Inhalts erreicht und ist.
Dieses Ereignis feuert nicht , wenn das Audio manuell geschleift wird, indem seine TimePosition geändert wird.
WiringChanged
Ereignis, das nachdem abgefeuert wird, nachdem ein Wire verbunden oder getrennt wurde, und das Wire jetzt oder zuvor mit einem Pin auf der AudioTextToSpeech und mit einigen anderen verwendbaren Instanzen verbunden war.
Parameter
Ob die Instanz verbunden oder getrennt wurde.
Die Pins auf der AudioTextToSpeech, die die Wire Ziele sind.
Die Wire zwischen der AudioTextToSpeech und der anderen Instanz.