Công cụ Phân Tích Cảnh cung cấp một bộ các chế độ xem trong Roblox Studio cho bạn cái nhìn tổng quát thông tin so sánh về cách mà cảnh máy khách và máy chủ của bạn được cấu thành, các tài nguyên mà chúng đang sử dụng, và các thể hiện 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à kiểm tra, và có thể kiểm tra cả mô hình dữ liệu máy khách và máy chủ.
Kích hoạt Phân Tích Cảnh
- Kích hoạt Phân Tích Cảnh trong Tệp > Tính năng Beta.
- Trên 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 kiểm tra. 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 ô—khung hình treemap có dạng hình 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 thể hiện đang góp phần vào chúng.
- Dưới khung hình treemap có dạng hình 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 thẳng đế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ớ kịch bản
Chế độ xem này cho thấy bộ nhớ mà mỗi Script, LocalScript, và ModuleScript đang sử dụng trong Luau VM. Đây là bộ nhớ được sử dụng bởi các bảng và các cấp phát kịch bản khác, không phải bộ nhớ được sử dụng bởi các tài sản như hoạt hình, kết cấu, và âm thanh. Chế độ xem này còn được phân bổ theo các vị trí phổ biến mà từ đó các kịch bản được thực thi và theo Script so với ModuleScript.
Các thể hiện không có cha
Chế độ xem các thể hiện không có cha cho thấy các kịch bản và mô-đun nào đang giữ tham chiếu tới các thể hiện, theo số lượng mỗi loại.
Các kịch bản giữ tham chiếu tới các thể hiện là điều bình thường và tự nó không phải là dấu hiệu của lỗi hay 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 giúp bạn dễ dàng phát hiện xem một kịch bản có đang làm điều gì mà 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 bổ sung cho công cụ heap Luau, công cụ này có thể cho bạn biết thêm thông tin về các cấp phát cá nhân.
Nhấp chuột phải vào bất kỳ kịch bản nào trong chế độ xem này để chọn nó trực tiếp trong Explorer.
Thành phần thể hiện
Chế độ xem thành phần thể hiện cho thấy các thể hiện nào hiện đang có trên máy khách hoặc máy chủ. Điều này là vô giá khi làm việc với các bản xây dựng lớn và phức tạp, vì mỗi thể hiện đều có chi phí sao chép và bộ nhớ.
Các danh mục, chẳng hạn 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 cân bằng cảnh của bạn. Ví dụ, có thể bạn không định có 25.000 phát sinh hạt, nhưng chế độ xem này cho bạn biết điều đó.
Chế độ xem này cũng giúp dễ dàng chọn tất cả các thể hiện 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 đ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à khá phức tạp, nhưng về mặt thực tế, việc xóa tất cả các thể hiện tham chiếu đến một bản nhạc âm thanh cho phép bộ nhớ đó được 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 thể hiện đang sử dụng nó.
Bộ nhớ hoạt hình
Tài sản hoạt hình là một trong những nguồn rò rỉ bộ nhớ phổ biến nhất trong sản xuất. Roblox rất tích cực trong việc giải phóng các tài sản hoạt hình không sử dụng, nhưng thường thì các kịch bản sẽ giữ cho hoạt hì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 thể hiện tham chiếu đến một tài sản hoạt hình cho phép nó được giải phóng.
Chế độ xem này, cùng với chế độ xem các thể hiện không có cha, giúp dễ dàng theo dõi vòng đời của các hoạt hình và bao nhiêu bộ nhớ chúng thực sự đang sử dụng.
Nhấp chuột phải vào bất kỳ hoạt hình nào trong chế độ xem này để chọn tất cả các thể hiện đ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ệnh vẽ hiện đang được render trong khung nhìn 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 cấu thành này giúp bạn hiểu rõ hơn về 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 thống kê trong chế độ xem này không nhất thiết khớp với những gì người chơi thấy trên thiết bị của họ. Sự khác biệt về quy mô 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à, chẳng hạn, 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 một cách lập trình thông qua SceneAnalysisService, được đưa ra thông qua MCP server. Mỗi phương thức trả về các bảng chứa các con trong 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ố thể hiện theo danh mục và lớp từ cây DataModel. |
| GetScriptMemoryAsync | Trả về mức sử dụng bộ nhớ heap Luau theo kịch bản tính bằng byte. |
| GetUnparentedInstancesAsync | Trả về các thể hiện được giữ bởi Luau nhưng không còn trong DataModel, nhóm theo kịch bản chủ. |
| GetTriangleCompositionAsync | Trả về số lượng tam giác và lệnh vẽ theo lượt render. |
| GetAnimationMemoryAsync | Trả về bộ nhớ clip hoạt hình đã được tải, đã bỏ trùng theo clip. |
| GetAudioMemoryAsync | Trả về bộ nhớ tài sản âm thanh đã được tải, đã bỏ trùng theo ID tài sản. |