Peningkatan ke Unity 2021.1
Peningkatan ke Unity 2019 LTS

Peningkatan ke Unity 2020 LTS

Note: Ikuti saran di bagian ini dalam urutan rilis. Misalnya, jika Anda perlu meningkatkan proyek Anda dari 2018 ke 2020, baca panduan peningkatan 2019 untuk melihat apakah ada perubahan yang Anda perlukan sebelum Anda membaca panduan peningkatan 2020.

Daftar halaman ini berubah dalam versi Unity 2020 LTS yang mungkin mempengaruhi proyek yang ada ketika Anda meng-upgrade dari versi 2019 ke 2020 LTS.

Catatan bahwa 2020 LTS juga dikenal sebagai 2020.3.

Page outline


Semua simpul jala diubah untuk penguraian UV yang lebih baik

Unity mungkin mengubah UV MeshGrafik utama primitif Unity. Mesh membuat sebagian besar dunia 3D Anda. Unity mendukung mesh poligon triangulat atau Quadrangulasi. Nurbs, Nurms, permukaan Subdiv harus dikonversi ke poligon. More info
Lihat di Glossary
3D objectsPermainan 3D Objek seperti kubus, terrain atau ragdoll. More info
Lihat di Glossary
yang Anda impor ke proyek.

Unity mengubah posisi semua vertik Mesh impor untuk skala di Unity unitsUkuran unit yang digunakan dalam proyek Unity. Secara default, unit 1 Unity adalah 1 meter. Untuk menggunakan skala yang berbeda, set Faktor Timbangan di Pengaturan Impor ketika mengimpor aset.
Lihat di Glossary
secara otomatis.

Dari Unity 2020.1, Unity menghasilkan UV peta ringan menggunakan simpul Mesh yang berubah, jika Anda telah mengaktifkan Generate LightmapA pre-rendered texture that contains the effects of light sources on static objects in the scene. Lightmaps are overlaid on top of scene geometry to create the effect of lighting. More info
See in Glossary
UVs
. Sebelum Unity 2020.1, peta UV peta cahaya yang dihasilkan Unity menggunakan posisi vertex Mesh impor asli, sebelum transformasi posisi otomatis.

UV yang dihasilkan setelah transformasi simpul lebih akurat dengan bentuk dan skala asli dari objek impor Anda. Kembali ke atas

Semua hashe bundel aset berbeda sehingga semua bundel dibangun

Dari Unity 2020.1, Unity menghasilkan hash yang berbeda untuk semua bundel aset dalam proyek Anda. Ini memastikan semua bundel dibangun, termasuk yang dengan konten yang sama tetapi dengan jalur yang dapat dimuat. Kembali ke atas

Paket HLAPI multiplayer tidak otomatis dipasang dalam peningkatan proyek

Dari Unity 2020.1, instal paket HLAPI multiplayer dari Paket Manager jika proyek Anda meningkatkan memiliki 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
yang menggunakan HLAPI multiplayer.

Dari Unity 2019.1 hingga 2019.4, Unity secara otomatis menginstal paket HLAPI multiplayer ketika Anda mengupgrade proyek yang dibuat pada Unity 2018.4 atau sebelumnya. Kembali ke atas

Memperbaiki kue LOD dengan Progresif Lightmapper

Unity Progresif LightmapperAlat dalam Unity yang bakes lightmap sesuai dengan pengaturan lampu dan geometri di tempat kejadian Anda. More info
Lihat di Glossary
terdiri dari CPU dan GPU lightmappers.

Dari Unity 2020.1, GPU lightmapper mendukung baking tingkat detail (LOD).

Lightmapper CPU menggunakan algoritma baking yang sama dan ini memungkinkan Unity menggunakan semua core CPU yang tersedia untuk waktu baking yang lebih cepat di ScenesAdegan berisi lingkungan dan menu permainan Anda. Pikirkan setiap file Adegan unik sebagai tingkat yang unik. Di setiap Adegan, Anda menempatkan lingkungan, hambatan, dan dekorasi, pada dasarnya merancang dan membangun permainan Anda dalam potongan-potongan. More info
Lihat di Glossary
dengan nilai LODTeknik Tingkat Detail (LOD) adalah optimasi yang mengurangi jumlah segitiga yang dimiliki Unity untuk membuat GameObject ketika jaraknya dari kamera meningkat. More info
Lihat di Glossary
di atas 0.

Untuk meningkatkan LOD di Adegan Anda, jelas peta cahaya panggang dan kemudian kembali. Untuk melakukan ini:

  1. Di Editor Unity, Open Window > Rendering > Lighting Settings.
  2. Pada Debug Settings, pilih menu drop-down pada tombol Generate Lighting, lalu pilih Clear Baked Data.
  3. Pilih Generate Lighting.

Kembali ke atas

Perubahan pemecahan kinerja yang adaptif

Untuk memperbarui Kinerja Adaptif dari 1.0 hingga 2.0, lihat . Kembali ke atas

Generasi Proyek Xcode

Login Pemilihan jalur bangunan proyek Xcode telah berubah. Sekarang Anda harus menyediakan jalur ke direktori yang diinginkan, dan file .xcodeproj dan menyertai dibuat di dalam direktori target. Folder build MacOS tidak bisa berada di dalam direktori proyek. Lihat halaman manual untuk .

Kembali ke atas

Sistem Partikel Perubahan medan

Untuk memastikan perilaku yang konsisten dari properti, Unity sekarang menggunakan tingkat bingkai referensi 30fps sebagai dasar untuk simulasi. Jika aplikasi Anda menggunakan tingkat bingkai yang berbeda, perubahan ini mungkin mempengaruhi sifat Bidang Angkatan berikut:

  • Gravity
  • Rotation
  • Vector Fields

Jika pengaturan ini berperilaku berbeda untuk versi Unity sebelumnya, sesuaikan nilai-nilai mereka.

Kembali ke atas

Perubahan Kelas Grafis UGUI

UnityEngine.UI.Graphic tidak lagi termasuk atribut untuk komponen. Untuk memperbarui kelas user-written yang mewarisi dari Grafik dan render di kanvas UGUI, tambahkan atribut RequireComponent berikut:

using UnityEngine;

[RequireComponent(typeof (CanvasRenderer))]
public class exampleClass: Graphic
{
  ...
}

Kembali ke atas

Mengatur Optimasi Kode untuk terus menggunakan Penutupan Kode

Pengenalan perubahan Optimasi Kode bagaimana karya. Untuk terus menggunakan paket Code Coverage dengan proyek Anda di 2020LTS, atur Optimization Code untuk mengkompilasi skrip dalam mode Debug. Mode debug memungkinkan C # debugging dan diperlukan untuk mendapatkan hasil cakupan kode yang akurat. Login Untuk memastikan Optimasi Kode diatur ke mode Debug, Anda dapat melakukan salah satu berikut:
To ensure Code Optimization is set to Debug mode, you can do one of the following:

  • Beralih ke mode Debug di Editor (sudut kanan bawah, pilih Bug icon > Switch to debug mode).
  • Menggunakan Kompilasi Pipa API, set CompilationPipeline.codeOptimization = CodeOptimization.Debug.
  • Pass -debugCodeOptimization ke baris perintah.

Kembali ke atas

Dukungan Platform AR / VR

Dokumen ini menyediakan panduan untuk meningkatkan proyek AR / VR yang ada yang menggunakan versi Unity sebelum rilis Unity 2020.

Aktifkan AR / VR dalam Pengaturan Proyek

Ketika mengupgrade proyek Anda yang ada ke Unity 2020 rilis dan kemudian, Anda harus menerima pemberitahuan bahwa menyatakan integrasi XR yang diuraikan (sebaiknya dalam Pengaturan Player / XR) telah dinonaktifkan.

During Asset import, before the Unity Editor is launched.
Selama impor Aset, sebelum Editor Unity diluncurkan.

Untuk mengaktifkan AR / VR, gunakan XR Plug-inSatu set kode yang dibuat di luar Unity yang menciptakan fungsi dalam Unity. Ada dua jenis plug-ins yang dapat Anda gunakan di Unity: Managed plug-ins (diproduksi. Rakitan NET dibuat dengan alat-alat seperti Studio Visual) dan plug-ins asli (pustaka kode asli yang spesifik platform). More info
Lihat di Glossary
Manajemen di Project SettingsPengumpulan yang luas dari pengaturan yang memungkinkan Anda untuk mengkonfigurasi bagaimana Fisika, Audio, Jaringan, Grafik, Input dan banyak bidang lain dari jangkauan proyek Anda. More info
Lihat di Glossary
dan pilih platform target Anda.

Note: We recommend fixing any upgrade-related script errors before installing XR Plug-in Management.
Sitemap Kami merekomendasikan memperbaiki kesalahan skrip terkait upgrade sebelum menginstal XR Plug-in Manajemen. Note: We recommend fixing any upgrade-related script errors before installing XR Plug-in Management.

Realita

Platform Build target Plug-in provider
Oculus Quest Android Oculus
Oculus Rift & Rift S Desktop Oculus
Facebook Twitter UWP Windows Server

Augmented realitas

Platform Build target Plug-in provider
Perangkat ARCore Android ARCore
Perangkat ARKit iOS ARKit
HoloLens UWP Windows Server
Login Sitemap Lumin Magic Leap

Gunakan pengaturan Pemain yang optimal

Pastikan pengaturan rendering dan kualitas proyek Anda optimal. Tabel di bawah pengaturan yang disarankan oleh platform target.

Realita

Platform Graphics API Stereo rendering mode
Oculus Quest OpenGL ES 3.0 Multiview
Oculus Rift & Rift S SD11 Single Pass Instanced
Facebook Twitter SD11 Single Pass Instanced

Augmented realitas

Platform Graphics API Stereo rendering mode
Perangkat ARCore OpenGL ES 3.0 N/A
Perangkat ARKit Metal N/A
HoloLens SD11 Single Pass Instanced
Login Sitemap WinZip 3.3 Single Pass Instanced

Note: "Single Pass" tidak lagi opsi mode rendering, seperti "Single Pass Instanced" lebih berkinerja. Jika Anda mengupgrade dari “single pass” ke “single pass instanced”, Anda mungkin harus memperbarui shadersProgram yang berjalan di GPU. More info
Lihat di Glossary
kustom dalam proyek Anda.

Render Pipeline

The built-in render pipelineRangkaian operasi yang mengambil isi dari Adegan, dan menampilkannya di layar. Unity memungkinkan Anda memilih dari pipa render yang dibangun sebelumnya, atau menulis sendiri. More info
Lihat di Glossary
, Universal Render Pipeline, dan High-Definition Render Pipeline semuanya didukung pada 2020.1. Ada manfaat untuk menggunakan pipa render terbaru kami, tetapi tidak ada persyaratan dalam proses peningkatan ini.

Sitemap Jika Anda menggunakan aset pihak ketiga dan / atau naungan kustom, Anda mungkin perlu untuk memperbarui aset dengan naungan yang kompatibel dengan "single melewati instanced".Note: If you are using third-party assets and/or custom shaders, you might need to update assets with shaders compatible with “single passed instanced”.

Kamera di Adegan

Jika Anda menggunakan XR Interaction Toolkit, tidak ada perubahan yang diperlukan untuk pelacakan cameraKomponen yang menciptakan gambar sudut pandang tertentu di tempat kejadian Anda. Output ditarik ke layar atau ditangkap sebagai tekstur. More info
Lihat di Glossary
.

Jika Anda menggunakan toolkit pihak ketiga untuk pelacakan kamera (OVRCameraRig, dll), pastikan Anda telah diperbarui ke versi terbaru. Perhatikan bahwa upgrade ke versi terbaru dari alat pihak ketiga dapat menyebabkan kesalahan skrip, harap referensi dokumentasi pihak ketiga.

Jika Anda menggunakan Driver Pose Tracked untuk pelacakan kamera, lihat .

Peningkatan alat-alat pihak ketiga

Jika Anda menggunakan toolkit yang dikembangkan oleh platform yang didukung kami (Paket Integrasi Oculus, MRTK, MLTK), pastikan Anda menggunakan versi terbaru. Perhatikan bahwa upgrade ke versi terbaru dari alat pihak ketiga dapat menyebabkan kesalahan skrip yang berkaitan dengan peningkatan, dan Anda mungkin perlu merujuk dokumentasi yang sesuai dari toolkit tersebut.

FAQ

Mengapa saya tidak bisa menginstal XR Plug-in Manajemen di Pengaturan Proyek?

Anda mungkin memiliki kesalahan skrip yang berhubungan dengan upgrade yang harus diperbaiki sebelum menginstal XR Plug-in Manajemen.

Mengapa OpenVR dan Google Cardboard hilang dari Manajemen Plug-in XR?

OpenVR dan Google Cardboard XR Plug-ins dikembangkan dan dipelihara oleh Valve dan Google, masing-masing. Tautan ke instruksi instalasi untuk kedua platform dapat ditemukan di kami.

Apakah sistem input Unity didukung?

Ya, integrasi platform yang didukung kami kompatibel dengan sistem input Unity.

Apakah Pipa Render Universal dan Pipa Render High-Definition didukung?

Ya, integrasi platform yang didukung kami kompatibel dengan Pipa Render Universal dan Pipa Render High-Definition.

Mengapa saya tidak bisa melihat XR Interaction Toolkit di Manajer Paket?

Toolkit Interaksi XR masih ada di pratinjau. Untuk melihat preview packagesPaket preview adalah dalam pengembangan dan belum siap untuk produksi. Paket dalam pratinjau mungkin ada tahap perkembangan, dari tahap awal hingga penyelesaian dekat.
Lihat di Glossary
di 2020.1, Anda harus mengaktifkannya menggunakan tab Manajer Paket di Pengaturan Proyek. Ketika diaktifkan, paket pratinjau ditampilkan di Registry Unity dari Manajer Paket.

Mengapa tidak bermain dalam karya Editor untuk penyedia saya?

Bermain dalam dukungan editor hanya bekerja untuk penyedia yang memiliki dukungan mandiri untuk penyedia mereka. Jika penyedia tidak terdaftar di bagian mandiri dari pemilihan penyedia XR Plug-in Manajemen UI(User Interface) Memungkinkan pengguna untuk berinteraksi dengan aplikasi Anda. Unity saat ini mendukung tiga sistem UI. More info
Lihat di Glossary
kemudian Bermain di Editor tidak akan bekerja. Periksa dokumentasi penyedia Anda karena mereka dapat mendukung beberapa cara lain untuk mengintegrasikan Play dalam dukungan Editor.

Mengapa saya tidak bisa menggunakan mode rendering “single pass”?

“Single pass” tidak lagi didukung pada tahun 2020.1 sebagai “single pass instanced” paling berkinerja. Jika proyek Anda menggunakan rendering “single pass”, Anda mungkin harus memperbarui naungan di proyek Anda. Perpustakaan pihak ketiga yang menggunakan naungan kustom untuk “single pass” juga perlu diperbarui. Anda dapat memilih untuk meningkatkan dari “single pass” ke “multipass” dan naungan harus bekerja, tetapi kami merekomendasikan menargetkan “single pass instanced” untuk kinerja maksimum.

Bagaimana cara mengkonfigurasi API grafis?

Grafik API dikonfigurasi dalam pengaturan Pemain (“Edit” > “Project Settings” > “Player”).

Bagaimana cara mengkonfigurasi mode rendering stereo?

Mode rendering dikonfigurasi dalam pengaturan spesifik penyedia yang bersarang di bawah Manajemen Plug-in XR di Pengaturan Proyek.

Mengapa saya mendapatkan kesalahan dengan renderScale menggunakan API Pengaturan XR?

Login Timbangan telah dihapus dan diganti dengan eyeTextureResolution Skala tapi itu telah menjadi tugas pemutakhiran skrip sejak 2019.3. Jika Anda mengupgrade dari versi Unity sebelum 2019.3, Anda harus secara manual mengganti renderScale dengan eyeTextureResolutionScale.

Mengapa tidak masukan dari pengontrol saya (misalnya tekan tombol) yang diakui oleh XR Interaction Toolkit?

Headset harus terdeteksi sebelum input perangkat dapat terdeteksi. Satu masalah umum ketika pengujian, adalah bahwa banyak orang membiarkan headset mereka beristirahat di meja sementara debugging interaksi mereka. Pengontrol tidak diakui sampai Anda memakai headset (atau sensor dekat di dalam headset diaktifkan). Jika Anda tidak mendapatkan masukan dari perangkat Anda, letakkan headset Anda setelah memulai aplikasi, atau tutup sensor kedekatan.

Dapatkah saya menggunakan kamera sudut lebar pada iPhone di aplikasi AR Foundation?

ARKit tidak memberikan pilihan perubahan FOV kamera.

Kembali ke atas

Peningkatan ke Unity 2021.1
Peningkatan ke Unity 2019 LTS