Alat Analisis Adegan menyediakan serangkaian tampilan di Roblox Studio yang memberikan informasi komparatif sekilas tentang bagaimana adegan klien dan server Anda disusun, sumber daya apa yang mereka gunakan, dan instance mana yang bertanggung jawab atas penggunaan sumber daya tersebut. Analisis Adegan dirancang untuk digunakan selama sesi bermain dan pengujian, dan dapat memeriksa model data klien dan server.
Aktifkan Analisis Adegan
- Aktifkan Analisis Adegan di File > Fitur Beta.
- Di bilah menu, pilih Window > Ringkasan Kinerja > Analisis Adegan.
Gunakan Analisis Adegan
Analisis Adegan dirancang untuk digunakan selama sesi bermain atau pengujian. Buka jendela Analisis Adegan dan jelajahi mode yang tersedia. Ketika sebuah mode aktif, Anda melihat tampilan kotak—tampilan treemap yang disquarified—menunjukkan ukuran relatif dari sumber daya yang sedang dilihat dan instance yang berkontribusi pada sumber daya tersebut.
- Di bawah tampilan treemap yang disquarified adalah daftar semua item dalam tampilan saat ini.
- Mengklik kanan pada item yang dipilih dalam Analisis Adegan biasanya memungkinkan Anda untuk melompat langsung ke item itu di Explorer.
- Anda dapat menggunakan bilah pencarian untuk memfilter berdasarkan nama di tampilan saat ini.
Mode
Analisis Adegan memiliki banyak mode yang berbeda, masing-masing melayani kasus penggunaan yang berbeda.
Memori skrip
Tampilan ini menunjukkan seberapa banyak memori yang digunakan oleh setiap Script, LocalScript, dan ModuleScript di VM Luau. Ini adalah memori yang digunakan oleh tabel dan alokasi skrip lainnya, bukan memori yang digunakan oleh aset seperti animasi, tekstur, dan suara. Tampilan ini lebih jauh dipecah berdasarkan lokasi umum dari mana skrip dieksekusi dan menurut Script versus ModuleScript.
Instance yang tidak diparent
Tampilan instance yang tidak diparent menunjukkan skrip dan modul mana yang memegang referensi ke instance, sebagai hitungan per tipe.
Skrip yang memegang referensi ke instance adalah hal yang normal dan tidak, dengan sendirinya, merupakan indikasi adanya bug atau kebocoran memori. Namun, jika Anda sedang menyelidiki kebocoran memori, tampilan ini memudahkan untuk melihat apakah skrip melakukan sesuatu yang tidak Anda duga.
Jika Anda masih kesulitan menemukan penyebab utama kebocoran memori, alat ini melengkapi alat tumpukan Luau, yang dapat menunjukkan lebih banyak informasi tentang alokasi individual.
Klik kanan pada skrip mana pun dalam tampilan ini untuk memilihnya langsung di Explorer.
Komposisi instance
Tampilan komposisi instance menunjukkan instance mana yang saat ini ada di klien atau server. Ini sangat berharga saat bekerja pada pembangunan besar dan kompleks, karena setiap instance memiliki biaya replikasi dan memori.
Kategorinya, seperti Karakter, Geometri, dan Tekstur, dirancang untuk membantu Anda memahami bagaimana adegan Anda seimbang. Misalnya, mungkin Anda tidak berniat memiliki 25.000 pemancar partikel, tetapi tampilan ini memberi tahu Anda.
Tampilan ini juga memudahkan untuk memilih semua instance dari tipe tertentu.
Memori audio
Tampilan memori audio menunjukkan berapa banyak memori yang saat ini dikonsumsi oleh setiap aset audio. Memori aktual yang digunakan oleh trek audio tertentu cukup kompleks, tetapi dalam istilah praktis, menghapus semua instance yang merujuk ke trek audio memungkinkan memori itu untuk dimuat ulang.
Klik kanan pada aset audio mana pun dalam tampilan ini untuk memilih semua instance yang menggunakannya.
Memori animasi
Aset animasi adalah salah satu sumber kebocoran memori yang paling umum dalam produksi. Roblox agresif dalam memuat ulang aset animasi yang tidak digunakan, tetapi umum bagi skrip untuk menjaga animasi tetap hidup setelah model induknya dihancurkan.
Seperti aset audio, menghapus semua instance yang merujuk ke aset animasi memungkinkan aset itu untuk dimuat ulang.
Tampilan ini, bersamaan dengan tampilan instance yang tidak diparent, memudahkan untuk melacak siklus hidup animasi dan berapa banyak memori yang sebenarnya mereka gunakan.
Klik kanan pada animasi mana pun dalam tampilan ini untuk memilih semua instance yang menggunakannya.
Komposisi segitiga
Tampilan komposisi segitiga memberikan Anda rincian yang lebih mendalam tentang jumlah segitiga dan permintaan gambar yang saat ini dirender di viewport utama.
Rincian ini mencakup hitungan untuk Bayangan, Opaque, Transparan, Terrain, Rumput, Partikel, Langit, dan UI.
Informasi komposisi ini membantu Anda lebih memahami bagaimana geometri adegan Anda disusun dan mengidentifikasi kasus di mana adegan mengandung geometri yang tidak terduga.
Statistik dalam tampilan ini tidak selalu sesuai dengan yang dilihat pemain di perangkat mereka. Penskalaan dapat menyebabkan perbedaan dramatis antara PC pengembangan yang kuat dan, misalnya, ponsel menengah.
API Engine
Anda juga dapat mengakses data Analisis Adegan secara programatis melalui SceneAnalysisService, yang diekspos melalui server MCP. Setiap metode mengembalikan tabel yang berisi anak-anak bersarang dengan data yang sama yang digunakan tampilan visual.
| Metode | Deskripsi |
| GetInstanceCompositionAsync | Mengembalikan hitungan instance berdasarkan kategori dan kelas dari pohon DataModel. |
| GetScriptMemoryAsync | Mengembalikan penggunaan memori tumpukan VM Luau per skrip dalam byte. |
| GetUnparentedInstancesAsync | Mengembalikan instance yang dipegang oleh Luau tetapi tidak lagi berada di DataModel, dikelompokkan berdasarkan skrip host. |
| GetTriangleCompositionAsync | Mengembalikan hitungan segitiga dan permintaan gambar berdasarkan pass render. |
| GetAnimationMemoryAsync | Mengembalikan memori klip animasi yang dimuat, diduplikasi berdasarkan klip. |
| GetAudioMemoryAsync | Mengembalikan memori aset audio yang dimuat, diduplikasi berdasarkan ID aset. |