AudioTextToSpeech
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
AudioTextToSpeech digunakan untuk memutar teks sebagai audio ucapan.Ini menyediakan satu Output pin yang dapat terhubung ke pin lain melalui Wires .API ini masih dalam pengembangan dan belum tersedia secara publik.
Contoh Kode
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()Rangkuman
Properti
Menunjukkan apakah objek AudioTextToSpeech ter loaded, difilter, dan siap untuk dimainkan.
Menunjukkan apakah objek AudioTextToSpeech bermain saat ini.
Mengontrol apakah loop objek AudioTextToSpeech .
Mengontrol pitch audio ucapan yang dihasilkan, yang akan independen dari kecepatannya.
Mengontrol seberapa cepat audio ucapan akan diputar, yang mengontrol pitchnya.
Mengontrol kecepatan audio ucapan yang dihasilkan, yang akan independen dari pitchnya.
Teks yang akan diubah menjadi audio ucapan oleh AudioTextToSpeech .
Menunjukkan panjang audio ucapan yang dihasilkan.
Pelacak posisi playhead saat ini dalam audio ucapan yang dihasilkan.
Gaya suara yang akan digunakan oleh AudioTextToSpeech .
Mengontrol seberapa keras audio ucapan yang dihasilkan akan diputar.
Metode
Kembalikan array dari Wires yang terhubung ke mengepinyang ditentukan.
Membekukan objek AudioTextToSpeech di mana pun lokasinya TimePosition .
Memainkan AudioTextToSpeech dari mana pun lokasinya TimePosition .
Lepaskan audio ucapan yang dihasilkan.
Membuat audio ucapan.
Acara
Melepaskan api ketika objek AudioTextToSpeech telah selesai diputar dan dijeda.
Melepaskan api saat loop objek AudioTextToSpeech terjadi.
Memicu ketika instansi lain terhubung ke atau terputus dari AudioTextToSpeech melalui Wire .
Properti
IsLoaded
Menunjukkan apakah objek AudioTextToSpeech ter loaded, difilter, dan siap untuk dimainkan.Meskipun tidak biasa, AudioTextToSpeech objek mungkin memiliki aset mereka tidak dimuat saat menjalankan jika ada tekanan memori ekstrim, di mana kemudian IsLoaded akan menjadi salah.
IsPlaying
Menunjukkan apakah objek AudioTextToSpeech bermain saat ini.Properti ini hanya dibaca, tetapi menyalin.Untuk memainkan dan menghentikan objek AudioTextToSpeech pada saat eksekusi, gunakan metode Play() dan Pause().
Pitch
Nilai dalam semiton musik.Nada dari audio ucapan yang dihasilkan dipindahkan dari nilai defaultnya oleh AudioTextToSpeech.Pitch semiton.Berjarak dari -12.0 hingga 12.0.
PlaybackSpeed
Pengganda mengontrol seberapa cepat audio ucapan akan diputar, langsung mengontrol pitch yang terasa. Berkisar dari 0 hingga 20.
Speed
Pengganda yang mengontrol kecepatan audio ucapan yang dihasilkan. Berkisar dari 0,5 hingga 2,0.
TimePosition
Melacak dan mengontrol posisi playhead saat ini dalam audio ucapan yang dihasilkan, dalam beberapa detik.
Volume
Tingkat volume yang dikalikan ke streamaudio output, mengontrol seberapa keras audio ucapan yang dihasilkan akan diputar. Berkisar dari 0 hingga 3.
Metode
GetConnectedWires
Kembalikan array dari Wires yang terhubung ke mengepinyang ditentukan. AudioTextToSpeech memiliki satu mengepin"Output".
Parameter
Memberikan nilai
Pause
Membekukan objek AudioTextToSpeech di mana pun lokasinya TimePosition. Replikasi dari server ke klien.
Memberikan nilai
Play
Memainkan AudioTextToSpeech dari mana pun lokasinya TimePosition. Replikasi dari server ke klien.
Memberikan nilai
Unload
Membebaskan sumber daya dengan melepaskan audio ucapan yang dihasilkan.
Memberikan nilai
GetWaveformAsync
Parameter
Memberikan nilai
LoadAsync
Panggilan memblokir yang memulai pembuatan audio ucapan berdasarkan parameter saat ini.Ini akan menghasilkan sampai pembuatan ucapan selesai atau gagal.Status dikembalikan oleh nilai AssetFetchStatus.
Memberikan nilai
Acara
Ended
Api setelah objek AudioTextToSpeech selesai diputar dan dijeda.Perhatikan acara ini tidak akan tidak menembak untuk audio dengan Looped diatur ke true karena terus bermain saat mencapai akhiri.Acara ini juga tidak terbakar ketika audio dipause sebelum pemutaran selesai; untuk ini, gunakan AudioTextToSpeech:GetPropertyChangedSignal() pada properti IsPlaying.
Acara ini dapat digunakan untuk menghancurkan objek AudioTextToSpeech ketika sudah selesai diputar.
Looped
Peristiwa yang menembak setelah loop objek AudioTextToSpeech berakhir. Ini terjadi ketika audio mencapai akhir kontennya dan Looping adalah true .
Acara ini tidak tidak memicu api jika audio diputar secara manual dengan mengubah TimePosition nya.
WiringChanged
Peristiwa yang menembak setelah Wire terhubung atau terputus, dan bahwa Wire sekarang atau sebelumnya terhubung ke pin di AudioTextToSpeech dan ke beberapa kejadianlain yang dapat ditransmisikan.
Parameter
Apakah instansi terhubung atau terputus.
Pin pada AudioTextToSpeech yang menjadi target Wire .
The Wire antara AudioTextToSpeech dan instansi lainnya.