Tinh chỉnh hiệu năng
Tối ưu hoá việc render và bộ nhớ
Hồ sơ tài nguyên của Doconut bị chi phối bởi ba yếu tố: render DPI, cái gì được lưu trong bộ nhớ đệm, và thời gian tồn tại của các phiên. Hướng dẫn này sẽ khám phá các công tắc theo mức độ ảnh hưởng.
Độ phân giải — công tắc lớn nhất
ImageResolution (25–300 DPI) điều khiển cả thời gian render và kích thước hình ảnh. Hầu hết các định dạng mặc định là 200 DPI; hình ảnh và PSD mặc định là 100.
// Bản xem trước danh sách tài liệu không cần chất lượng in
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });Giảm một nửa DPI sẽ làm giảm khoảng một phần tư số pixel trên mỗi trang — render nhanh hơn, truyền tải nhỏ hơn, bộ nhớ đệm ít hơn. Dành 250–300 DPI cho các trường hợp sử dụng nhiều thu phóng (CAD, bản vẽ kỹ thuật).
Đối với các tệp PDF có nhiều hình ảnh nhúng, PdfConfig cung cấp các điều chỉnh chi tiết hơn: CompressImages + CompressQuality, ResizeImages + ResizeResolution, và CompressFast. Đối với hình ảnh đơn giản, ImageConfig.MaxImagePixelSize (mặc định 3000 px) giới hạn kích thước đầu ra.
Bộ nhớ đệm trang — bộ nhớ vs. render lại
BaseConfig.CachePages (mặc định true) giữ mọi trang đã render trong bộ nhớ suốt thời gian của phiên. Đây là mặc định phù hợp cho việc xem tương tác — người dùng cuộn lên xuống. Tắt nó khi:
- tài liệu rất lớn và chỉ được xem một lần, từ đầu tới cuối,
- nhiều phiên đồng thời sẽ làm tăng số trang được lưu trong bộ nhớ đệm,
- bạn muốn trả phí CPU cho mỗi lần xem hơn là giữ RAM.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });Trên client, ViewerConfig.CacheEnabled = true tải trước một cửa sổ di chuyển nhỏ của các hình ảnh trang sắp tới trong bộ nhớ trình duyệt. Đó là bộ nhớ đệm prefetch cho mỗi lần xem, không phải localStorage kéo dài.
Phiên — bộ nhớ bạn không thấy
Mỗi phiên mở giữ mô hình tài liệu đã phân tích cộng với (với CachePages) các trang đã render, cho đến khi TimeOut trượt (mặc định 60 phút) hết kể từ yêu cầu cuối cùng. Hai thói quen giúp kiểm soát điều này:
- Đóng những gì bạn đã xong.
viewer.CloseDocument(token)giải phóng engine ngay lập tức thay vì chờ qua cửa sổ nhàn rỗi. - Điều chỉnh thời gian chờ cho phù hợp. Một bản xem trước mà người dùng chỉ nhìn trong hai phút không cần một phiên một giờ:
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Hãy nhớ cân nhắc: sau khi hết hạn widget sẽ hiển thị Document session not found. Please re-open document. — chọn thời gian chờ phù hợp với các phiên đọc thực tế.
Công tắc riêng theo định dạng
- Excel:
MemoryOptimizationPreferenceđược bật mặc định và giảm lượng bộ nhớ khi render các workbook rất lớn — để nó bật, hoặc đặt thànhfalsenếu bạn muốn đổi bộ nhớ lấy một chút tăng tốc;SheetNames/PrintAreahạn chế việc render chỉ những gì quan trọng. - Chế độ chuyển hướng có chi phí ban đầu:
DefaultRender = falsechuyển đổi toàn bộ tài liệu sang PDF khi mở. Nó cho phép tìm kiếm dựa trên văn bản gốc, nhưng trên tài liệu 500 trang, lời gọi mở sẽ mang theo việc chuyển đổi đó — đừng bật nó một cách phản xạ. - Word/PowerPoint trên máy chủ không có phông chữ của tài liệu: một Windows Server không có Office có ít phông chữ hơn rất nhiều so với máy phát triển. Các phông chữ thiếu gây ra việc dò tìm dự phòng chậm và các chỉ số sai; cài đặt các phông chữ, hoặc chỉ định
FontFolderstới thư mục chứa chúng.
Chiến lược phía client
LargeDoc = true— chiến lược tải lười cho tài liệu rất lớn; các trang được tải khi người dùng tiến gần tới chúng.AutoLoad = false(mặc định) — không render cho đến khi bạn thực sự gọiView(token).ShowThumbs = false— bỏ qua việc tạo/ yêu cầu thumbnail cho các bản xem trước một trang hoặc nhúng.- Bật
FixedZoomtránh các thay đổi thu phóng tự do; khi bạn ánh xạ một C#ViewerConfig, điều chỉnhFixedZoomPercentMobile(mặc định C# 75) cho màn hình nhỏ.
Khởi động một lần, không phải mỗi yêu cầu
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) thuộc về Program.cs — đăng ký các mã hoá mỗi yêu cầu là công việc lãng phí; bỏ qua hoàn toàn sẽ làm hỏng các tài liệu legacy code-page.
Phân phối công việc qua các node
Mọi điều trên đều tinh chỉnh việc render trên một node theo yêu cầu. Khi một node đơn không thể chịu tải, công tắc tiếp theo không phải là một vòng quay lớn hơn — mà là xuất bản các artefact của tài liệu một lần vào bộ nhớ chia sẻ và để mỗi node phục vụ chúng. Điều này thay đổi mô hình chi phí: render xảy ra một lần cho mỗi tài liệu thay vì một lần cho mỗi phiên, và các yêu cầu trang trở thành đọc tệp. Xem Triển khai phân tán.
Danh sách kiểm tra tinh chỉnh
- Đặt
ImageResolutionthấp nhất mà UX của bạn chấp nhận. - Giữ
CachePagesbật cho việc xem tương tác; tắt cho các kịch bản một lần hoặc đồng thời cao. - Đóng các phiên một cách rõ ràng; rút ngắn
TimeOutkhi việc sử dụng có tính bùng nổ. - Sử dụng
LargeDoc+ mặc địnhAutoLoad = falsetrên client cho tài liệu lớn. - Chỉ dùng
DefaultRender = falsekhi bạn cần một bản chiếu PDF có chứa văn bản.
Trang này có hữu ích không?