Тонкая настройка производительности
Оптимизация рендеринга и памяти
Профиль ресурсов Doconut определяется тремя факторами: разрешение рендеринга DPI, что кэшируется, и как долго живут сессии. Это руководство рассматривает рычаги в порядке их влияния.
Разрешение — самый сильный рычаг
ImageResolution (25–300 DPI) определяет как время рендеринга, так и размер изображения. Большинство форматов по умолчанию используют 200 DPI; изображения и PSD — 100.
// Для предварительного просмотра списка документов не требуется качество печати
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });Уменьшение DPI вдвое примерно уменьшает количество пикселей на странице вчетверо — более быстрый рендер, меньший объём передачи, меньше памяти кэша. Оставляйте 250–300 DPI для сценариев с интенсивным масштабированием (САПР, инженерные чертежи).
Для PDF с большим количеством встроенных изображений PdfConfig добавляет более тонкие настройки: CompressImages + CompressQuality, ResizeImages + ResizeResolution и CompressFast. Для обычных изображений ImageConfig.MaxImagePixelSize (по умолчанию 3000 px) ограничивает размер вывода.
Кеширование страниц — память vs. повторный рендер
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‑проекционный документ с текстом.
Была ли эта страница полезной?