Objek Audio

Objek audio modular Roblox memungkinkan Anda untuk memiliki kontrol dinamis atas suara dan obrolan suara dalam pengalaman Anda. Hampir setiap objek audio sesuai dengan perangkat audio dunia nyata, dan semuanya berfungsi bersama untuk menangkap dan memutar audio seperti rekan fisiknya.

Sebagai contoh, setiap objek audio secara konseptual jatuh ke dalam kategori berikut:

• Objek yang menghasilkan aliran audio, seperti pemutar audio.
• Objek yang mengonsumsi aliran audio, seperti pemancar audio.
• Objek yang mengubah aliran audio, seperti efek audio.
• Objek yang mengangkut aliran audio dari satu objek audio ke objek audio lainnya, seperti kabel.

Saat Anda membaca panduan ini dan mempelajari bagaimana semua objek audio ini bekerja bersama untuk mengeluarkan suara, Anda akan belajar bagaimana menangkap dan memberi makan musik, efek suara, dan suara manusia dari pengalaman ke pemain dan sebaliknya.

Memutar audio

Untuk memutar audio dalam pengalaman Anda, penting untuk memahami peran masing-masing objek audio yang tersedia:

• AudioPlayer memuat dan memutar berkas audio menggunakan ID aset audio yang ditentukan.
• AudioEmitter adalah speaker virtual yang mengeluarkan audio ke dalam lingkungan 3D.
• AudioListener adalah mikrofon virtual yang menangkap audio dari lingkungan 3D.
• AudioDeviceOutput adalah perangkat keras fisik dalam dunia nyata, seperti speaker atau headphone.
• AudioDeviceInput adalah mikrofon fisik dalam dunia nyata.
• Objek AudioTextToSpeech mengubah teks menjadi audio menggunakan suara manusia buatan.
• Objek AudioSpeechToText mengubah audio yang diucapkan menjadi teks.
• Sebuah Wire mengangkut aliran audio dari satu objek audio ke objek audio lainnya.

Bagaimana Anda memasangkan objek audio ini tergantung pada apakah Anda ingin mengeluarkan audio langsung ke speaker atau headphone pemain atau dari objek di ruang 3D. Bagian-bagian berikut menjelaskan kedua skenario tersebut.

Audio 2D

Audio 2D adalah suara non-arah yang diputar dari lokasi tertentu, tetap dengan volume yang sama terlepas dari posisi atau orientasi pemain di ruang 3D. Tipe audio ini memerlukan tiga objek audio:

• Pemutar audio untuk memproduksi aliran audio.
• Perangkat keras fisik untuk memutar aliran audio di dunia nyata.
• Kabel untuk mengangkut aliran audio dari pemutar audio ke perangkat output.

Untuk menunjukkan cara mengonfigurasi objek audio ini dalam Studio untuk audio 2D, diagram berikut membandingkan setiap objek dengan rekan perangkat audio dunia nyata mereka. Singkatnya:

• AudioPlayer memuat dan memutar aset audio Anda dengan pengaturan yang ditentukan.
• AudioDeviceOutput memungkinkan pemain untuk mendengar audio melalui speaker atau headphone mereka.
• Wire terhubung ke pemutar audio dengan propertinya SourceInstance, dan ke perangkat keras fisik dengan propertinya TargetInstance. Kemudian berfungsi sebagai jembatan untuk membawa aliran audio dari pemutar audio ke perangkat output pemain.

Untuk memutar audio non-arah:

1. Di jendela Explorer, pergi ke SoundService dan masukkan yang berikut:

   1. Sebuah objek AudioPlayer untuk membuat sumber audio.
   2. Sebuah objek AudioDeviceOutput untuk membuat speaker yang memutar di seluruh pengalaman.
   3. Sebuah objek Wire untuk menghubungkan aliran dari pemutar audio ke speaker.
2. Di jendela Properties dari objek AudioPlayer:

   1. Atur AssetID ke ID aset audio yang valid. Jika Anda tidak memiliki audio kustom Anda sendiri, Anda dapat menemukan aset audio gratis yang dapat digunakan di Creator Store.
   2. Aktifkan Looping jika Anda ingin audio Anda terus berulang.
   3. Atur Volume ke unit amplitudo yang ingin Anda mainkan untuk audio Anda.
3. Di jendela Properties dari objek Wire:

   1. Atur SourceInstance ke AudioPlayer untuk menentukan bahwa Anda ingin memutar audio dalam pemutar audio ini.
   2. Atur TargetInstance ke AudioDeviceOutput untuk menentukan bahwa Anda ingin memutar audio dari speaker spesifik ini.

Dari sini, Anda dapat memicu audio non-arah Anda dengan skrip untuk diputar saat pemain bergabung dengan pengalaman atau sebagai hasil dari peristiwa permainan atau interaksi UI. Untuk referensi contoh kode untukuse case ini, lihat tutorial Tambahkan audio 2D.

Audio 3D

Audio 3D adalah suara arah yang diputar dari lokasi tertentu di ruang 3D, meningkat atau menurun dalam volume tergantung pada posisi dan orientasi pemain terhadap suara. Tipe audio ini memerlukan enam objek audio:

• Pemutar audio untuk memproduksi aliran audio.
• Pemancar audio untuk mengeluarkan aliran audio dalam lingkungan.
• Pendengar untuk menangkap aliran audio dari lingkungan.
• Perangkat keras fisik untuk memutar aliran audio di dunia nyata.
• Dua kabel: satu untuk mengangkut aliran audio dari pemutar audio ke pemancar, dan satu lagi untuk mengangkutnya dari pendengar ke perangkat output.

Untuk menunjukkan cara mengonfigurasi objek audio ini dalam Studio untuk audio 3D, diagram berikut membandingkan setiap objek dengan rekan perangkat audio dunia nyata mereka. Singkatnya:

• AudioPlayer memuat dan memutar aset audio Anda dengan pengaturan yang ditentukan.
• Posisi induk AudioEmitter di ruang 3D menentukan di mana audio itu memancarkan dalam lingkungan.
• AudioListener baik menangkap audio dari pemancar dari kamera lokal atau dari Humanoid.RootPart karakter pemain, tergantung pada di mana Anda mengatur posisi pendengar default.
• AudioDeviceOutput memungkinkan pemain untuk mendengar audio melalui speaker atau headphone mereka.
• Kabel pertama Wire terhubung ke pemutar audio dengan propertinya SourceInstance, dan ke pemancar dengan propertinya TargetInstance. Kemudian berfungsi sebagai jembatan untuk membawa aliran audio dari pemutar audio ke pemancar.
• Kabel kedua Wire terhubung ke pendengar dengan propertinya SourceInstance, dan ke perangkat keras fisik dengan propertinya TargetInstance. Kemudian berfungsi sebagai jembatan untuk membawa aliran audio dari pendengar ke perangkat output pemain.

Untuk memutar audio posisi:

1. Pilih di mana Anda ingin membuat AudioListener saat pemain muncul ke dalam pengalaman.

   1. Di jendela Explorer, pilih SoundService.
   2. Di jendela Properties, atur ListenerLocation ke salah satu dari yang berikut:

      • Default - Membuat dan mengaitkan pendengar ke Workspace.CurrentCamera dalam pengalaman yang mengaktifkan obrolan suara.
      • None - Tidak membuat pendengar. Opsi ini berguna jika Anda ingin membuat pendengar melalui skrip.
      • Character - Membuat dan mengaitkan pendengar ke karakter pemain lokal.
      • Camera - Membuat dan mengaitkan pendengar ke Workspace.CurrentCamera.

   Saat Anda mengatur ListenerLocation ke Character atau Camera, mesin secara otomatis membuat objek AudioDeviceOutput di bawah SoundService pada saat runtime.

2. Di jendela Explorer, pergi ke objek 3D yang ingin Anda pancarkan audio dan masukkan yang berikut:

   1. Sebuah objek AudioPlayer untuk membuat sumber audio.
   2. Sebuah objek AudioEmitter untuk memancarkan aliran posisi dari objek 3D.
   3. Sebuah objek Wire untuk menghubungkan aliran dari pemutar audio ke pemancar audio.

3. Di jendela Properties dari objek AudioPlayer:

   1. Atur AssetID ke ID aset audio yang valid. Jika Anda tidak memiliki audio kustom Anda sendiri, Anda dapat menemukan aset audio gratis yang dapat digunakan di Creator Store.
   2. Aktifkan Looping jika Anda ingin audio Anda terus berulang.
   3. Atur Volume ke unit amplitudo yang ingin Anda mainkan untuk audio Anda.

4. Di jendela Properties dari objek AudioEmitter, atur DistanceAttenuation ke kurva volume-terhadap-jarak yang menentukan seberapa keras pendengar mendengar pemancar sesuai dengan jarak di antara mereka.

   Sebagai contoh, kurva berikut mengurangi volume audio menjadi setengah ketika pendengar berada 50 stud dari pemancar, lalu volume berkurang tajam menjadi nol ketika pendengar berada 70 stud jauhnya.

   

5. Di jendela Properties dari objek Wire:

   1. Atur SourceInstance ke AudioPlayer untuk menentukan bahwa Anda ingin memutar audio dalam pemutar audio spesifik ini.
   2. Atur TargetInstance ke AudioEmitter untuk menentukan bahwa Anda ingin memutar audio dari pemancar audio spesifik ini.

Dari sini, Anda dapat memicu audio arah Anda dengan skrip untuk diputar saat pemain bergabung dengan pengalaman atau sebagai hasil dari peristiwa permainan atau interaksi UI. Untuk referensi contoh kode untuk use case ini, lihat tutorial Tambahkan audio 3D.

Teks ke suara

Teks ke suara (TTS) adalah bentuk teknologi bantu yang mengubah string teks menjadi suara berbicara menggunakan suara buatan. Jenis audio ini memerlukan lima objek audio:

• Generator suara audio untuk memuat dan mengubah teks menjadi audio.
• Pemancar audio untuk memancarkan aliran audio dalam lingkungan.
• Pendengar untuk menangkap aliran audio dari lingkungan.
• Perangkat keras fisik untuk memutar aliran audio di dunia nyata.
• Untuk audio 2D - Kabel untuk mengangkut aliran audio dari generator suara audio ke perangkat output.
• Untuk audio 3D - Dua kabel: satu untuk mengangkut aliran audio dari generator suara audio ke pemancar, dan satu lagi untuk mengangkutnya dari pendengar ke perangkat output.

Bagaimana Anda mengonfigurasi objek-objek ini tergantung pada apakah Anda ingin membuat audio TTS 2D atau 3D. Untuk detail lebih lanjut tentang setiap proses, klik di antara tab berikut.

Untuk menunjukkan bagaimana cara mengonfigurasi objek audio ini dalam Studio untuk audio TTS 2D, diagram berikut membandingkan setiap objek dengan rekan perangkat audio dunia nyata mereka. Singkatnya:

• Objek AudioTextToSpeech memuat dan mengubah string teks menjadi suara berbicara.
• AudioDeviceOutput memungkinkan pemain untuk mendengar audio melalui speaker atau headphone mereka.
• Wire terhubung ke generator suara audio dengan propertinya SourceInstance, dan ke perangkat keras fisik dengan propertinya TargetInstance. Kemudian berfungsi sebagai jembatan untuk membawa aliran audio dari generator suara audio ke perangkat output pemain.

Untuk memutar audio teks-ke-suara 2D:

1. Di jendela Explorer, pergi ke SoundService dan masukkan yang berikut:

   1. Sebuah objek AudioTextToSpeech untuk membuat generator suara audio.
   2. Sebuah objek AudioDeviceOutput untuk membuat speaker yang memutar di seluruh pengalaman.
   3. Sebuah objek Wire untuk menghubungkan aliran dari generator suara audio ke speaker.
2. Di jendela Properties dari objek AudioTextToSpeech:

   1. Atur Text ke apa pun yang Anda ingin suara ucapkan. Ada batasan 300 karakter per permintaan.

   2. Atur VoiceId ke angka antara 1 dan 10, tergantung pada suara buatan mana yang ingin Anda gunakan dalam tabel berikut.

      Daftar suara buatan

      VoiceID	Deskripsi Suara	Contoh Audio
      1	Pria Inggris
      2	Wanita Inggris
      3	Pria Amerika Serikat #1
      4	Wanita Amerika Serikat #1
      5	Pria Amerika Serikat #2
      6	Wanita Amerika Serikat #2
      7	Pria Australia
      8	Wanita Australia
      9	Suara Retro #1
      10	Suara Retro #2
      11	Suara Narator
      101	Pria Spanyol
      102	Wanita Spanyol
      201	Pria Jerman
      202	Wanita Jerman
      301	Pria Italia
      302	Wanita Italia
      401	Pria Prancis
      402	Wanita Prancis

      
      

   3. Atur Volume ke unit amplitudo yang ingin Anda mainkan untuk audio Anda.

3. Di jendela Properties dari objek Wire:

   1. Atur SourceInstance ke AudioTextToSpeech untuk menentukan bahwa Anda ingin memutar audio dalam generator suara audio spesifik ini.
   2. Atur TargetInstance ke AudioDeviceOutput untuk menentukan bahwa Anda ingin memutar audio dari speaker spesifik ini.

Dari sini, Anda dapat memicu audio TTS Anda dengan skrip. Untuk referensi contoh kode untuk audio TTS, termasuk cara mengonfigurasi TTS yang sadar konteks yang beradaptasi dengan pemain, status lingkungan mereka, atau status permainan, lihat tutorial Tambahkan teks-ke-suara.

Suara-ke-teks

Suara-ke-teks (STT) adalah bentuk teknologi yang secara otomatis menghasilkan string teks dari suara berbicara. Jenis audio ini memerlukan tiga objek audio:

• Generator teks untuk memuat dan mengubah audio menjadi teks.
• Perangkat keras fisik seperti mikrofon untuk menangkap input audio.
• Kabel untuk mengangkut aliran audio dari perangkat input ke generator teks.

Semua objek audio ini bekerja sama untuk menghasilkan teks STT sebagai respons terhadap tindakan pemain. Misalnya, jika pemain mengenakan headset saat memainkan pengalaman dengan laptop mereka:

• AudioDeviceInput menangkap ucapan pemain, seperti yang diucapkan ke mikrofon mereka dan sebagai aliran audio.
• Sebuah Wire mengangkut aliran audio dari AudioDeviceInput ke AudioSpeechToText.
• AudioSpeechToText mengubah ucapan pemain menjadi teks.
• Pengalaman membaca teks ini dan melakukan tindakan, seperti menampilkan teks yang diucapkan di layar atau membuka pintu atas perintah pemain.

Untuk menerapkan suara-ke-teks dalam pengalaman Anda:

1. Aktifkan penggunaan API terbaru untuk suara.

   1. Di jendela Explorer, pilih VoiceChatService.
   2. Di jendela Properties, atur UseAudioApi ke Enabled.
2. Di jendela Explorer, pergi ke SoundService dan masukkan yang berikut:

   1. Sebuah AudioDeviceInput untuk menangkap ucapan.
   2. Sebuah AudioSpeechToText untuk mengubah ucapan menjadi teks.
   3. Sebuah Wire untuk mengangkut aliran dari perangkat input audio ke instance STT.
3. Di jendela Properties dari objek AudioSpeechToText, atur status Enabled ke menyala.
4. Di jendela Properties dari objek Wire:

   1. Atur SourceInstance ke AudioDeviceInput baru Anda untuk menentukan bahwa Anda ingin kabel mengangkut audio dari instance audio spesifik ini.
   2. Atur TargetInstance ke AudioSpeechToText baru Anda untuk menentukan bahwa Anda ingin kabel mengangkut audio ke instance audio spesifik ini.
5. Atur properti Player dari perangkat input audio ke pemain lokal pada saat runtime dengan audioDeviceInput.Player = game.Players.LocalPlayer. Ini memberi tahu Roblox dari mikrofon pengguna mana yang akan menangkap audio.

Setelah mengonfigurasi STT dalam pengalaman Anda, Anda dapat memicunya dengan skrip. Untuk referensi contoh kode, lihat tutorial Tambahkan suara-ke-teks.

Bahasa yang Didukung

Tidak ada konfigurasi yang diperlukan untuk mengaktifkan bahasa yang didukung. Roblox secara otomatis mendeteksi bahasa yang diucapkan dari audio dan mentranskripnya.

STT mendukung bahasa berikut:

• Arab
• Cina (Sederhana)
• Cina (Tradisional)
• Inggris
• Prancis
• Jerman
• Indonesia
• Italia
• Jepang
• Korea
• Polandia
• Portugis
• Spanyol
• Rusia
• Turki
• Thailand
• Vietnam

Filter untuk Kata Serupa

Saat Anda menerapkan STT dalam pengalaman Anda, Anda mungkin ingin meningkatkan akurasi pencocokan dengan memfilter kata-kata yang terdengar mirip dengan kata-kata yang sebenarnya ingin diucapkan pemain. Untuk melakukan ini, Anda dapat membandingkan kata-kata yang dikenali oleh AudioSpeechToText dengan daftar kata yang dikenal:

1. Sanitasi dan tokenkan output Text dari AudioSpeechToText untuk membuat tabel string huruf kecil yang dapat diparse dan dibandingkan.

   1. Hapus karakter tanda baca.
   2. Ubah seluruh string menjadi huruf kecil.
   3. Pecah string dengan spasi untuk menghasilkan tabel kata.
2. Hasilkan tabel kandidat untuk mempersiapkan string Anda untuk perbandingan.

   1. Sanitasi dan tokenkan setiap string referensi.
   2. Simpan kata-kata yang diproses ini dalam tabel terpisah.
3. Bandingkan dan cocokkan kata-kata di kedua tabel untuk mengenali masukan suara yang dekat dengan frasa sasaran Anda, bahkan jika mereka menyertakan variasi kecil.

   • Untuk pemeriksaan sederhana, periksa apakah string sama persis.
   • Untuk pencocokan yang lebih fleksibel, Anda dapat menulis logika kustom untuk menerima substitusi (seperti "colour" alih-alih "color") atau mencocokkan sebagian kata dan menghitung skor kemiripan.

Kustomisasi audio

Efek audio memungkinkan Anda untuk mengubah atau meningkatkan aliran audio secara non-destruktif sebelum mencapai telinga pemain. Anda dapat menerapkan efek ini untuk membuat audio Anda lebih imersif dalam pengalaman, seperti menggunakan objek AudioEqualizer untuk membuat suara hujan terdengar tertahan, objek AudioCompressor untuk mengontrol volume maksimum suara, atau AudioReverb untuk menambahkan refleksi suara yang lebih realistis di ruang interior.

Untuk petunjuk tentang cara mengonfigurasi efek audio, serta perbandingan berdampingan sebelum dan sesudah Anda mengkostumisasi audio Anda, lihat Efek audio.

Memicu audio

Anda dapat memicu audio secara kontekstual dari skrip dengan memanggil Play() pada objek AudioPlayer yang telah terhubung dengan benar. Misalnya, jika Anda mengaitkan skrip dengan pemutar audio, Anda dapat memicu aset audio dengan sesuatu seperti ini:

local audio = script.Parent
local something = ...
something.SomeEvent:Connect(function()
    audio:Play()
end)

Untuk contoh kode yang lebih kompleks untuk memicu audio, seperti untuk umpan balik permainan, interaksi UI, dan suara latar yang berulang, lihat tutorial Tambahkan audio 2D, Tambahkan audio 3D, dan Tambahkan teks-ke-suara tutorials.