パフォーマンスチューニング

レンダリングとメモリの最適化

Doconut のリソースプロファイルは主に 3 つの要素に支配されています:レンダリング DPI、キャッシュに残るもの、そしてセッションの存続時間。このガイドでは、インパクトの順にレバーを解説します。

解像度 — 最大のレバー

ImageResolution (25–300 DPI) はレンダリング時間と画像サイズの両方を左右します。ほとんどのフォーマットはデフォルトで 200 DPI、画像と PSD はデフォルトで 100 DPI です。

csharp
// ドキュメントリストのプレビューは印刷品質を必要としません
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

DPI を半分にすると、ページあたりのピクセル数はおおよそ 4 分の 1 になり、レンダリングが速くなり、転送が小さくなり、キャッシュメモリも減少します。ズームが多用されるケース(CAD、エンジニアリング図面)では 250–300 DPI を確保してください。

埋め込み画像が多い PDF では、PdfConfig がより細かい調整を可能にします:CompressImages + CompressQuality、ResizeImages + ResizeResolution、そして CompressFast。単純な画像の場合、ImageConfig.MaxImagePixelSize(デフォルト 3000 px)は出力サイズの上限となります。

ページキャッシュ — メモリ vs. 再レンダリング

BaseConfig.CachePages(デフォルト true)は、セッションの存続期間中、すべてのレンダリング済みページをメモリに保持します。インタラクティブな閲覧に適したデフォルトで、ユーザーは前後にスクロールできます。以下の場合はオフにしてください:

  • ドキュメントが非常に大きく、最初から最後まで一度だけ閲覧する場合、
  • 多数の同時セッションがキャッシュページを増幅させる場合、
  • RAM を保持するよりも、ビューごとに CPU コストを支払う方が好ましい場合。
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

クライアント側では、ViewerConfig.CacheEnabled = true がブラウザメモリに次のページ画像の小さな移動ウィンドウを事前読み込みします。これはビューごとのプリフェッチキャッシュであり、永続的な localStorage ではありません。

セッション — 見えないメモリ

開かれたすべてのセッションは、解析されたドキュメントモデルと(CachePages を使用して)レンダリングされたページを保持し、スライディング TimeOut(デフォルト 60 分)が 最後のリクエストから 経過するまで保持します。この状態を管理するための 2 つの習慣:

  • 完了したものは閉じる。 viewer.CloseDocument(token) はアイドルウィンドウを待たずにエンジンを即座に解放します。
  • タイムアウトを適切に設定する。 ユーザーが 2 分間だけプレビューを見る場合、1 時間のセッションは不要です:
csharp
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:Office がインストールされていない Windows Server は開発マシンよりもはるかに少ないフォントしか持ちません。フォントが欠如するとフォールバックの探索が遅くなり、メトリクスが誤ります;フォントをインストールするか、FontFolders をフォントが格納されたフォルダーに指すようにしてください。

クライアント側戦略

  • LargeDoc = true — 非常に大きなドキュメント向けのレイジーロード戦略;ユーザーが近づくとページが読み込まれます。
  • AutoLoad = false(デフォルト) — 実際に View(token) を呼び出すまでレンダリングしません。
  • ShowThumbs = false — 単一ページまたは埋め込みプレビューの場合、サムネイル生成/リクエストをスキップします。
  • FixedZoom を有効にすると、自由形式のズーム変更を回避できます;C# の ViewerConfig をマッピングする際は、小さな画面向けに FixedZoomPercentMobile(C# デフォルト 75)を調整してください。

起動は一度だけ、リクエストごとではなく

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) は Program.cs に属します — リクエストごとにエンコーディングを登録するのは無駄な作業です;それを完全に忘れるとレガシーのコードページドキュメントが壊れます。

ノード間で作業を分散する

上記すべては、オンデマンドで単一ノードのレンダリングを調整します。単一ノードが負荷を吸収できない場合、次のレバーはより大きなダイヤルではなく、ドキュメントのアーティファクトを一度だけ共有ストレージに公開し、すべてのノードがそれを提供するようにすることです。これによりコストモデルが変わります:レンダリングはセッションごとではなくドキュメントごとに一度だけ行われ、ページリクエストはファイル読み取りになります。分散デプロイメント を参照してください。

チューニングチェックリスト

  1. UX が受け入れられる最小の ImageResolution を設定してください。
  2. インタラクティブな閲覧のために CachePages をオンに保ち、ワンパスまたは高同時性シナリオではオフにしてください。
  3. セッションを明示的に閉じ、使用がバースト的な場合は TimeOut を短くしてください。
  4. 大きなドキュメントではクライアント側で LargeDoc + デフォルトの AutoLoad = false を使用してください。
  5. テキストを含む PDF 投影が必要な場合にのみ DefaultRender = false を使用してください。

このページは役に立ちましたか?