Тюнінг продуктивності
Оптимізація рендерингу та пам’яті
Профіль ресурсів Doconut переважає три фактори: роздільна здатність DPI, те, що залишається в кеші, і тривалість життя сесій. Цей посібник розглядає важелі у порядку їх впливу.
Роздільна здатність — найбільший важіль
ImageResolution (25–300 DPI) впливає як на час рендерингу, так і на розмір зображення. Більшість форматів за замовчуванням мають 200 DPI; зображення та PSD — 100.
// Попередній перегляд списку документів не потребує якості друку
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });Зменшення DPI вдвічі приблизно зменшує кількість пікселів на сторінці в чотири рази — швидший рендер, менші передачі, менше пам’яті кешу. Виділяйте 250–300 DPI для випадків, коли часто використовується масштабування (CAD, інженерні креслення).
Для PDF з великою кількістю вбудованих зображень, PdfConfig додає більш точні налаштування: CompressImages + CompressQuality, ResizeImages + ResizeResolution, та CompressFast. Для простих зображень, ImageConfig.MaxImagePixelSize (за замовчуванням 3000 px) обмежує розмір вихідного файлу.
Кешування сторінок — пам’ять проти повторного рендерингу
BaseConfig.CachePages (за замовчуванням true) зберігає кожну відрендерену сторінку в пам’яті протягом усього часу життя сесії. Це правильне значення за замовчуванням для інтерактивного перегляду — користувачі прокручують вперед і назад. Вимкніть його, коли:
- документи величезні і переглядаються один раз, від початку до кінця,
- багато одночасних сесій збільшать кількість кешованих сторінок,
- ви віддаєте перевагу використанню CPU на перегляд, а не займанню RAM.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });На клієнті, ViewerConfig.CacheEnabled = true попередньо завантажує невелике рухоме вікно майбутніх зображень сторінок у пам’ять браузера. Це кеш попереднього завантаження для окремого перегляду, а не постійний localStorage.
Сесії — пам’ять, яку ви не бачите
Кожна відкрита сесія зберігає розпарсений модель документа плюс (з CachePages) її відрендерені сторінки, доки не сплине ковзне вікно TimeOut (за замовчуванням 60 хвилин) з моменту останнього запиту. Дві звички допомагають тримати це під контролем:
- Закрийте те, чим закінчили користуватися.
viewer.CloseDocument(token)звільняє движок негайно, замість очікування простого вікна. - Підбирайте правильний тайм-аут. Попередній перегляд, який користувачі дивляться протягом двох хвилин, не потребує одногодинної сесії:
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Пам’ятайте про компроміс: після закінчення терміну дії віджет показує Document session not found. Please re-open document. — оберіть тайм-аут, який відповідає реальним сеансам читання.
Формат‑специфічні перемикачі
- Excel:
MemoryOptimizationPreferenceувімкнено за замовчуванням і зменшує використання пам’яті під час рендерингу дуже великих робочих книг — залишайте його ввімкненим, або встановітьfalse, якщо готові обміняти пам’ять на невелике підвищення швидкості;SheetNames/PrintAreaобмежують рендеринг лише тим, що важливо. - Режим перенаправлення має початкові витрати:
DefaultRender = falseконвертує весь документ у PDF під час відкриття. Це забезпечує нативний пошук за текстом, але для 500‑сторінкового документа виклик відкриття включає цю конвертацію — не вмикайте його автоматично. - Word/PowerPoint на сервері без шрифтів документів: Windows Server без Office має значно менше шрифтів, ніж робоча машина. Відсутність шрифтів викликає повільне резервне пошук і неправильні метрики; встановіть шрифти або вкажіть
FontFoldersна папку, що їх містить.
Стратегії на боці клієнта
LargeDoc = true— стратегія лінивого завантаження для дуже великих документів; сторінки завантажуються, коли користувач наближається до них.AutoLoad = false(за замовчуванням) — не рендерити, доки ви фактично не викличетеView(token).ShowThumbs = false— пропускати створення/запити мініатюр для односторінкових або вбудованих попередніх переглядів.- Увімкнення
FixedZoomзапобігає довільним змінам масштабу; коли ви прив’язуєте C#ViewerConfig, налаштуйтеFixedZoomPercentMobile(за замовчуванням C# 75) для малих екранів.
Запуск один раз, а не на кожен запит
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) належить до Program.cs — реєстрація кодувань на кожен запит є марною роботою; повне їх ігнорування руйнує документи зі старими кодовими сторінками.
Розподіл роботи між вузлами
Все вищевказане налаштовує рендеринг на одному вузлі за запитом. Коли один вузол не може впоратися з навантаженням, наступний важіль — не збільшення діалю, а публікація артефактів документа один раз у спільне сховище та дозволення кожному вузлу їх обслуговувати. Це змінює модель витрат: рендеринг відбувається один раз на документ замість одного разу на сесію, а запити сторінок стають читанням файлів. Дивіться Розподілені розгортання.
Чек‑лист налаштувань
- Встановіть найнижчий
ImageResolution, який приймає ваш UX. - Тримайте
CachePagesувімкненим для інтерактивного перегляду; вимикайте його для одноразових або сценаріїв з високою конкуренцією. - Явно закривайте сесії; скорочуйте
TimeOut, коли використання є спорадичним. - Використовуйте
LargeDoc+ за замовчуваннямAutoLoad = falseна клієнті для великих документів. - Використовуйте
DefaultRender = falseлише коли потрібна PDF‑проекція з текстом.
Чи була ця сторінка корисною?