การปรับจูนประสิทธิภาพ

เพิ่มประสิทธิภาพการเรนเดอร์และหน่วยความจำ

โปรไฟล์ทรัพยากรของ Doconut ถูกครอบงำโดยสามสิ่ง: render DPI, what stays cached, และ how long sessions live. คู่มือนี้จะอธิบายการปรับแต่งตามลำดับผลกระทบ.

ความละเอียด — ตัวควบคุมที่ใหญ่ที่สุด

ImageResolution (25–300 DPI) ขับเคลื่อนทั้งเวลาเรนเดอร์และขนาดภาพ. รูปแบบส่วนใหญ่ตั้งค่าเริ่มต้นที่ 200 DPI; ภาพและ PSD ตั้งค่าเริ่มต้นที่ 100.

csharp
// การแสดงตัวอย่างรายการเอกสารไม่จำเป็นต้องมีคุณภาพการพิมพ์
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) จำกัดขนาดผลลัพธ์.

การแคชหน้า — หน่วยความจำ vs. การเรนเดอร์ใหม่

BaseConfig.CachePages (ค่าเริ่มต้น true) เก็บหน้าที่เรนเดอร์ทั้งหมดในหน่วยความจำตลอดอายุของเซสชัน. นี่เป็นค่าเริ่มต้นที่เหมาะสมสำหรับการดูแบบโต้ตอบ — ผู้ใช้สามารถเลื่อนขึ้นลงได้. ปิดการทำงานเมื่อ:

  • เอกสารมีขนาดใหญ่และดูเพียงครั้งเดียว, จากหน้าแรกถึงหน้าสุดท้าย, -หลายเซสชันพร้อมกันจะทำให้จำนวนหน้าที่แคชเพิ่มขึ้นหลายเท่า, -คุณต้องการใช้ CPU ต่อการดูแทนการถือ RAM.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

บนไคลเอนต์, ViewerConfig.CacheEnabled = true โหลดล่วงหน้าหน้าต่างเล็กของภาพหน้าถัดไปในหน่วยความจำของเบราว์เซอร์. นี่เป็นแคชการดึงข้อมูลล่วงหน้าต่อการดูหนึ่งครั้ง, ไม่ใช่ localStorage ที่คงที่.

เซสชัน — หน่วยความจำที่คุณไม่เห็น

แต่ละเซสชันที่เปิดจะเก็บโมเดลเอกสารที่แยกวิเคราะห์พร้อมกับ (ด้วย CachePages) หน้าที่เรนเดอร์ไว้, จนกว่าช่วงเวลาลอย TimeOut (ค่าเริ่มต้น 60 นาที) จะหมด ตั้งแต่คำขอล่าสุด. มีสองนิสัยที่ช่วยควบคุมสิ่งนี้:

  • ปิดสิ่งที่คุณเสร็จแล้ว. viewer.CloseDocument(token) ปล่อยเอนจินทันทีแทนการรอหน้าต่างว่าง.
  • กำหนดขนาดเวลาหมดให้เหมาะสม. การพรีวิวที่ผู้ใช้มองเพียงสองนาทีไม่จำเป็นต้องมีเซสชันหนึ่งชั่วโมง:
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 บนเซิร์ฟเวอร์ที่ไม่มีฟอนต์ของเอกสาร: Windows Server ที่ไม่มี Office มีฟอนต์น้อยกว่าคอมพิวเตอร์พัฒนาอย่างมาก. ฟอนต์ที่หายไปทำให้การสำรวจสำรองช้าและเมตริกไม่ถูกต้อง; ติดตั้งฟอนต์, หรือชี้ FontFolders ไปยังโฟลเดอร์ที่เก็บฟอนต์เหล่านั้น.

กลยุทธ์ด้านไคลเอนต์

  • LargeDoc = true — กลยุทธ์โหลดแบบ lazy สำหรับเอกสารขนาดใหญ่มาก; หน้าโหลดเมื่อผู้ใช้เข้าใกล้.
  • AutoLoad = false (ค่าเริ่มต้น) — ไม่เรนเดอร์จนกว่าคุณจะเรียก View(token) จริง.
  • ShowThumbs = false — ข้ามการสร้าง/ร้องขอภาพย่อสำหรับพรีวิวหน้าเดียวหรือฝัง.
  • การเปิดใช้งาน FixedZoom ป้องกันการเปลี่ยนแปลงการซูมแบบอิสระ; เมื่อคุณแมป C# ViewerConfig, ปรับ FixedZoomPercentMobile (ค่าเริ่มต้น C# 75) สำหรับหน้าจอขนาดเล็ก.

เริ่มต้นครั้งเดียว, ไม่ใช่ต่อคำขอ

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) ควรอยู่ใน Program.cs — การลงทะเบียนการเข้ารหัสต่อคำขอเป็นงานที่เสียเปล่า; ลืมทำเลยจะทำให้เอกสารโค้ดเพจเก่าเสีย.

การกระจายงานไปยังโหนดหลายตัว

ทั้งหมดข้างต้นเป็นการปรับจูนการเรนเดอร์บนโหนดเดียวตามความต้องการ. เมื่อโหนดเดียวไม่สามารถรับภาระได้, ตัวควบคุมต่อไปไม่ใช่การเพิ่มค่าเดิม — แต่เป็นการเผยแพร่ผลลัพธ์ของเอกสารครั้งเดียวลงในที่เก็บข้อมูลร่วมและให้ทุกโหนดให้บริการ. สิ่งนี้เปลี่ยนโมเดลต้นทุน: การเรนเดอร์เกิดขึ้นครั้งเดียวต่อเอกสารแทนที่จะเป็นครั้งเดียวต่อเซสชัน, และการร้องขอหน้าเปลี่ยนเป็นการอ่านไฟล์. ดู การปรับใช้แบบกระจาย.

รายการตรวจสอบการปรับจูน

  1. ตั้งค่า ImageResolution ต่ำสุดที่ UX ของคุณยอมรับ.
  2. เปิด CachePages สำหรับการดูแบบโต้ตอบ; ปิดสำหรับสถานการณ์แบบผ่านครั้งเดียวหรือความพร้อมใช้งานสูง.
  3. ปิดเซสชันอย่างชัดเจน; ลดระยะเวลา TimeOut ในกรณีที่การใช้เป็นแบบกระติก.
  4. ใช้ LargeDoc + ค่าเริ่มต้น AutoLoad = false บนไคลเอนต์สำหรับเอกสารขนาดใหญ่.
  5. ใช้ DefaultRender = false เฉพาะเมื่อคุณต้องการการฉาย PDF ที่มีข้อความ.

หน้านี้เป็นประโยชน์หรือไม่?