Membangun terkompresi dan konfigurasi server

Untuk menyebarkan build 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, Anda harus mengkonfigurasi server Anda dan pastikan Anda menggunakan header respons yang benar, sehingga browser dapat menerima respons yang tepat dan memproses respons dengan benar.

Ada dua pengaturan utama dalam Unity yang mempengaruhi bagaimana Anda mengatur server:

• 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 Format: Menentukan bagaimana file kompres Unity selama langkah build.
• Decompression Fallback: Menentukan bagaimana proses Unity mengunduh file ketika build berjalan di browser.

Format Kompresi

Pilih jenis kompresi dari jendela Pengaturan WebGL Player (menu: Edit > Project Settings > Player, kemudian pilih WebGL dan memperluas bagian Publishing Settings):

Metode kompresi	Description
gzip	Ini adalah opsi default. File Gzip lebih besar dari file Brotli, tetapi lebih cepat untuk membangun, dan didukung secara asli oleh semua browser di atas HTTP dan HTTPS.
Brotli	Kompresi Brotli menawarkan rasio kompresi terbaik. File terkompresi Brotli lebih kecil dari gzip, tetapi mengambil waktu lebih lama untuk mengompresi, yang meningkatkan waktu iterasi Anda pada build rilis. Chrome dan Firefox hanya dukungan asli kompresi Brotli melalui HTTPS.
Disabled	Disables kompresi. Gunakan opsi ini jika Anda ingin menerapkan kompresi Anda sendiri di post-processingProses yang meningkatkan visual produk dengan menerapkan filter dan efek sebelum gambar muncul di layar. Anda dapat menggunakan efek pasca proses untuk mensimulasikan kamera fisik dan sifat film, misalnya Bloom dan Kedalaman Lapangan. More info pemrosesan pos, pasca proses, pasca proses Lihat di Glossary scriptsSepotong kode yang memungkinkan Anda untuk membuat Komponen Anda sendiri, memicu peristiwa permainan, memodifikasi sifat komponen dari waktu ke waktu dan menanggapi input pengguna dengan cara apa pun yang Anda sukai. More info Lihat di Glossary. Anda juga harus menggunakannya jika Anda berencana untuk menggunakan kompresi statis pada server hosting.

Untuk informasi lebih lanjut tentang dukungan browser untuk metode kompresi yang dipilih, lihat dokumentasi pada Kompatibilitas browser WebGL.

Web server

Anda mungkin perlu menyesuaikan konfigurasi server Anda untuk mencocokkan pengaturan build spesifik Anda. Secara khusus, mungkin ada masalah jika Anda sudah memiliki konfigurasi sisi server lain untuk mengompres file host, yang bisa mengganggu setup ini. Untuk membuat browser melakukan dekompresi secara asli saat mengunduh aplikasi Anda, menerapkan Judul konten-Encoding ke respons server. header ini harus sesuai dengan jenis kompresi Unity digunakan pada waktu build. Untuk sampel kode, lihat Konfigurasi Server Contoh Kode.

Dekompresi fallback

Opsi fallback dekompresi memungkinkan Unity untuk secara otomatis mengatur dekompresor JavaScript ke build Anda. Dekompresor ini sesuai dengan metode kompresi Anda yang dipilih, dan depresi konten Anda jika browser gagal melakukannya.

Mengaktifkan fallback dekompresi

Aktifkan dekompresi fallback dari jendela Player Settings (menu: Edit > Project Settings > Player, kemudian pilih WebGL dan memperluas bagian Publishing Settings).

Ketika Anda mengaktifkan fallback dekompresi, Unity menambahkan ekstensi .unityweb ke file build. Anda harus mempertimbangkan menggunakan Decompression Fallback jika Anda memiliki pengalaman kurang dengan konfigurasi server, atau jika konfigurasi server tidak tersedia untuk Anda.

Note: Menggunakan opsi ini menghasilkan ukuran loader yang lebih besar dan skema pemuatan yang kurang efisien untuk file build.

Menonaktifkan fallback dekompresi

Opsi Decompression Fallback dinonaktifkan secara default. Oleh karena itu, secara default, membangun file memiliki ekstensi yang sesuai dengan metode kompresi yang Anda pilih.

Ada dua metode kompresi untuk memilih dari: gzip atau Brotli. Untuk informasi lebih lanjut lihat bagian format kompresi.

Untuk mengaktifkan browser ke file build Unity dekompres asli sementara mereka mengunduh, Anda perlu mengkonfigurasi server web Anda untuk melayani file terkompresi dengan header HTTP yang sesuai. Ini disebut dekompresi browser asli. Ini memiliki keuntungan lebih cepat daripada fallback dekompresi JavaScript, yang dapat mengurangi waktu startup aplikasi Anda.

Proses setup untuk dekompresi browser asli tergantung pada server web Anda. Untuk sampel kode, lihat Konfigurasi Server Contoh Kode.

Content-Encoding header

header Konten-Encoding memberitahu browser yang jenis kompresi Unity telah digunakan untuk file terkompresi. Ini memungkinkan browser untuk menekan file secara asli.

Mengatur header respons Konten-Encoding ke metode kompresi yang dipilih dalam Player SettingsPengaturan yang memungkinkan Anda mengatur berbagai pilihan khusus pemain untuk permainan akhir yang dibangun oleh Unity. More info
Lihat di Glossary.

Metode kompresi	File extension	Response header
gzip	.gz	Content-Encoding: gzip
Brotli	.br	Content-Encoding: br

WebAssembly streaming ( header tingkat tinggi)

Streaming WebAssembly memungkinkan browser untuk menyusun kode WebAssembly saat masih mengunduh kode. Ini secara signifikan meningkatkan waktu pemuatan.

Untuk kompilasi streaming WebAssembly untuk bekerja, server perlu mengembalikan file WebAssembly dengan tipe application/wasm MIME. Untuk menggunakan WebAssembly streaming, Anda perlu melayani file WebAssembly dengan header respons Content-Type: application/wasm. Judul Konten-Tipe memberi tahu server yang mengetikkan konten. Nilai ini harus diatur ke application/wasm untuk file WebAssembly.

File extension	Response header
.wasm.gz, .wasm.br	Content-Type: application/wasm

Note: Streaming WebAssembly tidak bekerja sama dengan dekompresi JavaScript (ketika opsi Fallback Dekompresi diaktifkan). Dalam kasus seperti itu, file WebAssembly yang diunduh harus terlebih dahulu melalui dekompresor JavaScript dan oleh karena itu browser tidak dapat streaming selama diunduh.

header tambahan

Jika file Anda mengandung JavaScript, Anda harus menambahkan header application/javascript Content-Type. Beberapa server mungkin termasuk ini secara otomatis, sementara yang lain tidak.

File extension	Response header
.js, .js.gz, js.br	Content-Type: application/javascript

---

• Halaman yang diperbarui untuk akun untuk konfigurasi server pada 2020. 1 Artikel
• 2019–09–04 WebAssembly streaming ditambahkan pada 2019.2
• diperbarui pada 5.6