Công cụ Phân Tích Cảnh cung cấp một bộ các chế độ xem trong Roblox Studio cho phép bạn có thông tin so sánh nhanh về cách mà cảnh client và server của bạn được cấu thành, tài nguyên mà chúng đang sử dụng, và những instances nào chịu trách nhiệm cho việc sử dụng tài nguyên đó. Phân Tích Cảnh được thiết kế để sử dụng trong các phiên chơi và thử nghiệm, và có thể kiểm tra cả dữ liệu model client và server.
Kích hoạt Phân Tích Cảnh
Trong thanh menu, chọn Cửa sổ > Tóm tắt Hiệu suất > Phân Tích Cảnh.
Sử dụng Phân Tích Cảnh
Phân Tích Cảnh được thiết kế để sử dụng trong một phiên chơi hoặc thử nghiệm. Mở cửa sổ Phân Tích Cảnh và duyệt các chế độ có sẵn. Khi một chế độ đang hoạt động, bạn sẽ thấy một màn hình hiển thị các ô - chế độ xem treemap vuông - cho thấy kích thước tương đối của các tài nguyên đang được xem và các instances đang góp phần vào chúng.
- Dưới chế độ xem treemap vuông là danh sách tất cả các mục trong chế độ xem hiện tại.
- Nhấp chuột phải vào một mục đã chọn trong Phân Tích Cảnh thường cho phép bạn nhảy trực tiếp đến mục đó trong Explorer.
- Bạn có thể sử dụng thanh tìm kiếm để lọc theo tên trong hiển thị hiện tại.
Các chế độ
Phân Tích Cảnh có nhiều chế độ khác nhau, mỗi chế độ phục vụ cho một trường hợp sử dụng khác nhau.
Bộ nhớ script
Chế độ xem này cho thấy bao nhiêu bộ nhớ mỗi Script, LocalScript, và ModuleScript đang sử dụng trong VM Luau. Đây là bộ nhớ được sử dụng bởi các bảng và các phân bổ script khác, không phải bộ nhớ được sử dụng bởi các tài sản như hoạt ảnh, kết cấu, và âm thanh. Chế độ xem này được phân chia thêm theo các vị trí phổ biến từ đó scripts được thực thi và theo Script so với ModuleScript.
Các instances không thuộc về cha
Chế độ xem các instances không thuộc về cha cho thấy các script và module nào đang giữ tham chiếu đến các instances, theo số lượng mỗi loại.
Việc các script giữ tham chiếu đến các instances là điều bình thường và không, một mình nó, là dấu hiệu của một lỗi hoặc rò rỉ bộ nhớ. Tuy nhiên, nếu bạn đang điều tra một rò rỉ bộ nhớ, chế độ xem này dễ dàng giúp bạn phát hiện ra xem một script có đang làm điều gì bạn không mong đợi hay không.
Nếu bạn vẫn gặp khó khăn trong việc tìm ra nguyên nhân gốc rễ của một rò rỉ bộ nhớ, công cụ này là bổ sung cho công cụ tình trạng heap Luau, công cụ này có thể cho bạn biết thêm thông tin về các phân bổ riêng lẻ.
Nhấp chuột phải vào bất kỳ script nào trong chế độ xem này để chọn nó trực tiếp trong Explorer.
Thành phần instance
Chế độ xem thành phần instance cho thấy các instances nào hiện đang có mặt trên client hoặc server. Điều này vô cùng quý giá khi làm việc trên các công trình lớn và phức tạp, vì mỗi instance đều có chi phí sao chép và bộ nhớ.
Các danh mục, như Nhân vật, Hình học và Kết cấu, được thiết kế để giúp bạn hiểu cách mà cảnh của bạn được cân bằng. Ví dụ, có thể bạn không định có 25,000 bộ phát hạt, nhưng chế độ xem này cho phép bạn biết điều đó.
Chế độ xem này cũng dễ dàng để chọn tất cả các instances của một loại nhất định.
Bộ nhớ âm thanh
Chế độ xem bộ nhớ âm thanh cho thấy bao nhiêu bộ nhớ mỗi tài sản âm thanh hiện đang tiêu thụ. Bộ nhớ thực tế được sử dụng bởi một bản nhạc âm thanh nhất định là rất phức tạp, nhưng về mặt thực tế, việc xóa tất cả các instances tham chiếu đến một bản nhạc âm thanh cho phép bộ nhớ đó giải phóng.
Nhấp chuột phải vào bất kỳ tài sản âm thanh nào trong chế độ xem này để chọn tất cả các instances đang sử dụng nó.
Bộ nhớ hoạt ảnh
Tài sản hoạt ảnh là một trong những nguồn gốc phổ biến nhất của các rò rỉ bộ nhớ trong sản xuất. Roblox rất kiên quyết về việc giải phóng tài sản hoạt ảnh không sử dụng, nhưng rất phổ biến là các script giữ cho các hoạt ảnh sống sót sau khi mô hình cha của chúng đã bị phá hủy.
Giống như các tài sản âm thanh, việc xóa tất cả các instances tham chiếu đến một tài sản hoạt ảnh cho phép nó được giải phóng.
Chế độ xem này, cùng với chế độ xem các instances không thuộc về cha, giúp dễ dàng theo dõi vòng đời của các hoạt ảnh và mức độ bộ nhớ mà chúng đang thực sự sử dụng.
Nhấp chuột phải vào bất kỳ hoạt ảnh nào trong chế độ xem này để chọn tất cả các instances đang sử dụng nó.
Thành phần tam giác
Chế độ xem thành phần tam giác cung cấp cho bạn một phân tích chi tiết hơn về các tam giác và các lần gọi vẽ hiện đang được hiển thị trong chế độ xem chính.
Các phân tích này bao gồm số lượng cho Bóng đổ, Đục, Trong suốt, Địa hình, Cỏ, Hạt, Bầu trời, và UI.
Thông tin compositional này giúp bạn hiểu rõ hơn cách mà hình học cảnh của bạn được cấu thành và xác định các trường hợp mà cảnh chứa hình học không mong đợi.
Các số liệu trong chế độ xem này không nhất thiết phải khớp với những gì người chơi thấy trên các thiết bị của họ. Kích thước có thể gây ra sự khác biệt lớn giữa một PC phát triển mạnh mẽ và, ví dụ, một chiếc điện thoại tầm trung.
API của Engine
Bạn cũng có thể truy cập dữ liệu Phân Tích Cảnh theo cách lập trình thông qua SceneAnalysisService, được cung cấp thông qua MCP server. Mỗi phương thức trả về các bảng chứa các con trẻ lồng ghép với cùng dữ liệu mà hiển thị trực quan sử dụng.
| Phương thức | Mô tả |
| GetInstanceCompositionAsync | Trả về số lượng instances theo danh mục và loại từ cây DataModel. |
| GetScriptMemoryAsync | Trả về mức sử dụng bộ nhớ heap Luau theo từng script tính bằng byte. |
| GetUnparentedInstancesAsync | Trả về các instances mà Luau đang giữ nhưng không còn trong DataModel, được nhóm theo script chủ. |
| GetTriangleCompositionAsync | Trả về số lượng tam giác và các lần gọi vẽ theo từng lần render. |
| GetAnimationMemoryAsync | Trả về bộ nhớ clip hoạt ảnh đã nạp, không trùng lặp theo clip. |
| GetAudioMemoryAsync | Trả về bộ nhớ tài sản âm thanh đã nạp, không trùng lặp theo ID tài sản. |