WebGL

Halaman ini hanya memberikan informasi tentang kemampuan audio di WebGLLogin API yang membuat grafis 2D dan 3D di browser web. Opsi build Unity WebGL memungkinkan Unity untuk mempublikasikan konten sebagai program JavaScript yang menggunakan teknologi HTML5 dan WebGL rendering API untuk menjalankan konten Unity di browser web. More info
Lihat di Glossary. Untuk mempelajari cara menggunakan audio di proyek Unity Anda, lihat Gambaran Keseluruhan Audio.

Karena Unity menggunakan FMODAudio di Unity dibangun di atas perantara yang disebut FMOD. FMOD terintegrasi dengan mesin Unity untuk membuat dan bermain kembali audio interaktif.
Lihat di Glossary untuk mengelola audio untuk platform, Unity WebGL mendukung fungsionalitas audio terbatas, yang hanya mencakup fitur dasar. FMOD bergantung pada benang, yang WebGL tidak mendukung. Untuk alasan ini, Unity menggunakan implementasi berdasarkan API Web Audio internal, yang memungkinkan browser untuk menangani pemutaran audio dan pencampuran.

Sitemap Kebijakan Autoplay baru Google Chrome mencegah autoplay audio dan video dalam kondisi tertentu. Misalnya, sementara permainan Anda mungkin diatur untuk autoplay beberapa musik latar belakang segera setelah beban permainan, itu tidak akan bermain secara otomatis kecuali Anda klik atau ketuk di situs web. Untuk informasi lebih lanjut tentang cara mengaktifkan atau menonaktifkan kebijakan ini, lihat dokumentasi Google Chrome pada Note:.Kebijakan Autoplay di Chrome.

Kelas yang didukung

Unity WebGL mendukung kelas API berikut:

Class	WebGL Support status
AudioSource	WebGL mendukung beberapa API. Lihat AudioSource untuk rincian dukungan spesifik.
AudioListener	Semua API didukung.
AudioClip	WebGL mendukung beberapa API. Lihat AudioClip untuk rincian dukungan spesifik.
SystemInfo.supportsAudio	Browser menyediakan dukungan audio untuk WebGL. Untuk alasan ini, SystemInfo.supportsAudio selalu benar.
Microphone	Tidak didukung.

AudioSource

API AudioSource mendukung pemutaran audio posisi dasar, termasuk:

• Jeda dan asumsi
• Panning
• Rolloff
• Pengaturan pitch
• Dukungan efek Doppler

Unity WebGL mendukung API AudioSource berikut:

Properties	Summary
Clip	Menentukan audio clipSebuah wadah untuk data audio dalam Unity. Unity mendukung aset audio mono, stereo dan multichannel (hingga delapan saluran). Unity dapat mengimpor .aif, .wav, .mp3, dan format file audio .ogg, dan .xm, .mod, .it, dan format modul pelacak .s3m. More info Lihat di Glossary yang bermain berikutnya.
dopplerLevel	Mengatur skala Doppler untuk AudioSource.
ignoreListenerPause	Memungkinkan AudioSource untuk mengabaikan AudioListener.pause dan terus bermain audio.
ignoreListenerVolume	Mengabaikan volume AudioSource pengguna akhir.
isPlaying	Kembali benar jika AudioSource.clip bermain.
loop	Memungkinkan aplikasi untuk memutar AudioSource.clip.
maxDistance	Mengatur jarak maksimum di mana AudioSource.clip berhenti makan atau menjadi inaudible.
minDistance	Mengatur jarak minimum di mana AudioSource. klip tidak lagi naik dalam volume. Suara mulai memperhatikan jarak minimum.
mute	AudioSource
pitch	Mengatur pitch dari AudioSource.clip. WebGL hanya mendukung nilai pitch positif.
playOnAwake	Memainkan AudioSource di Awake.
rolloffMode	Mengatur atenuasi AudioSource jarak jauh.
time	Mengatur posisi pemutaran dalam detik.
timeSamples	Mengatur posisi pemutaran dalam sampel modulasi kode pulsa (PCM).
velocityUpdateMode	Mengatur apakah pembaruan AudioSource di loop pembaruan tetap atau dinamis.
volume	Mengatur volume AudioSource (0.0 hingga 1.0).

Methods	Summary
Pause	Pauses the AudioSource.clip.
Play	Memainkan AudioSource.clip.
PlayDelayed	Memainkan AudioSource.clip dengan penundaan yang Anda tentukan dalam hitungan detik.
PlayOneShot	Memainkan volume AudioClip dan skala AudioSource dengan volumeScale.
PlayScheduled	Memainkan AudioSource pada waktu yang Anda tentukan.
SetScheduledEndTime	Mengatur waktu yang dijadwalkan AudioSource.clip berakhir.
SetScheduledStartTime	Mengatur waktu yang dijadwalkan AudioSource.clip dimulai.
Stop	Berhenti bermain AudioSource.clip.
UnPause	Unpauses a jeda AudioSource.clip.
PlayClipAtPoint	Memainkan AudioSource.clip pada posisi tertentu di dunia.

AudioClip

Unity WebGL mengimpor file dalam Format AAC, yang secara luas browser didukung. Unity WebGL mendukung API AudioClip berikut:

Properties	Summary
length	Panjang AudioClip dalam detik.
loadState	Mengembalikan keadaan beban saat ini dari data audio yang terkait dengan AudioClip.
samples	Panjang AudioClip dalam sampel.
loadType	Jenis beban klip. Anda dapat mengatur jenis beban AudioClip di InspectorJendela Unity yang menampilkan informasi tentang Pengaturan GameObject yang dipilih saat ini, aset atau proyek, memungkinkan Anda untuk memeriksa dan mengedit nilai. More info Lihat di Glossary.

Method	Summary	Additional information
AudioClip.Create	Buat AudioClip dengan nama dan panjang yang Anda tentukan.	Unity WebGL sebagian mendukung AudioClip.Create. Browser tidak mendukung streaming dinamis, sehingga menggunakan AudioClip.Create, set Stream ke false.
AudioClip.SetData	Mengatur data sampel dalam AudioSource.clip.	Unity WebGL sebagian mendukung AudioClip.SetData. Anda hanya dapat menggunakan metode ini untuk mengganti konten AudioClip. Di WebGL, Unity mengabaikan parameter offsetSample.

Audio Terkompresi

Untuk menggunakan audio terkompresi dengan WebGL di Unity, atur AudioClip ke salah satu opsi berikut:

CompressionA method of storing data that reduces the amount of storage space it requires. See Texture Compression, Animation Compression, Audio Compression, Build Compression. See in Glossary method	Description	Considerations
CompressedInMemory	Gunakan ini untuk mengompresi audio pada disk dan tetap terkompresi setelah dimuat ke dalam memori aplikasi Anda.	Audio terkompresi dapat menyebabkan latensi dan kurang tepat ketika datang ke pemutaran audio. Namun, audio terkompresi menggunakan memori kurang dalam aplikasi Anda daripada audio yang terdepresi. Ini adalah praktik terbaik untuk menggunakan CompressedInMemory untuk audio yang tidak terpengaruh oleh presisi misalnya, musik latar belakang.
DecompressOnLoad	Gunakan ini untuk mengompresi audio pada disk, mirip dengan CompressedInMemory, dan depresi ketika dimuat ke memori aplikasi Anda.	Audio yang terdepresi menggunakan sejumlah memori yang signifikan dibandingkan dengan audio terkompresi tetapi memiliki latensi yang lebih rendah dan lebih fleksibilitas audio. Gunakan DecompressedOnLoad untuk audio yang dipengaruhi oleh presisi (misalnya, dialog karakter atau efek suara).

Audio Playback dan Keamanan Browser

Untuk alasan keamanan, browser tidak memungkinkan pemutaran audio sampai pengguna akhir berinteraksi dengan halaman web aplikasi Anda melalui klik mouse, acara sentuh atau tekan kunci. Gunakan layar pemuatan untuk memungkinkan pengguna akhir untuk berinteraksi dengan aplikasi Anda dan mulai pemutaran audio sebelum konten utama Anda dimulai.