การปรับจูนประสิทธิภาพ
เพิ่มประสิทธิภาพการเรนเดอร์และหน่วยความจำ
โปรไฟล์ทรัพยากรของ Doconut ถูกครอบงำโดยสามสิ่ง: render DPI, what stays cached, และ how long sessions live. คู่มือนี้จะอธิบายการปรับแต่งตามลำดับของผลกระทบ.
ความละเอียด — คันโยกที่ใหญ่ที่สุด
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) จำกัดขนาดผลลัพธ์.
การแคชหน้า — หน่วยความจำ vs. การเรนเดอร์ใหม่
BaseConfig.CachePages (ค่าเริ่มต้น true) เก็บทุกหน้าที่เรนเดอร์ไว้ในหน่วยความจำตลอดอายุของเซสชัน. นี่เป็นค่าเริ่มต้นที่เหมาะสมสำหรับการดูแบบโต้ตอบ — ผู้ใช้เลื่อนกลับและไปข้างหน้า. ปิดการใช้งานเมื่อ:
- เอกสารมีขนาดใหญ่และดูเพียงครั้งเดียว, ตั้งแต่หน้าแรกถึงหน้าสุดท้าย,
- มีหลายเซสชันพร้อมกันซึ่งจะทำให้จำนวนหน้าที่แคชเพิ่มขึ้นหลายเท่า,
- คุณต้องการจ่ายค่า CPU ต่อการดูแทนการเก็บ RAM.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });บนไคลเอนต์, ViewerConfig.CacheEnabled = true โหลดล่วงหน้าหน้าต่างเล็กของภาพหน้าถัดไปในหน่วยความจำของเบราว์เซอร์. นี่เป็นแคชการดึงข้อมูลล่วงหน้าต่อการดู, ไม่ใช่ localStorage ที่คงที่.
เซสชัน — หน่วยความจำที่คุณไม่เห็น
แต่ละเซสชันที่เปิดจะเก็บโมเดลเอกสารที่แยกวิเคราะห์พร้อมกับ (ด้วย CachePages) หน้าที่เรนเดอร์ไว้, จนกว่า sliding 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/PPT บน Linux/Docker: ฟอนต์ที่หายไปทำให้การสำรวจสำรองช้าและเมตริกไม่ถูกต้อง; ชี้
FontFoldersไปยังไดเรกทอรีที่มีฟอนต์ของคุณ. - การนำเสนอบน Linux: ไม่จำเป็นต้องมีสวิตช์
libgdiplusหรือSystem.Drawing.EnableUnixSupport— ดูที่ Fonts on Linux.
กลยุทธ์ด้านไคลเอนต์
LargeDoc = true— กลยุทธ์ lazy-load สำหรับเอกสารขนาดใหญ่มาก; หน้าโหลดเมื่อผู้ใช้เข้าใกล้.AutoLoad = false(ค่าเริ่มต้น) — ไม่เรนเดอร์จนกว่าคุณจะเรียกView(token)จริง.ShowThumbs = false— ข้ามการสร้าง/ร้องขอภาพย่อสำหรับการพรีวิวหน้าเดียวหรือฝัง.- การเปิดใช้งาน
FixedZoomป้องกันการเปลี่ยนแปลงซูมแบบอิสระ; เมื่อคุณแมป C#ViewerConfig, ปรับFixedZoomPercentMobile(ค่าเริ่มต้น C# 75) สำหรับหน้าจอขนาดเล็ก.
เริ่มต้นครั้งเดียว, ไม่ใช่ต่อคำขอ
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) ควรอยู่ใน Program.cs — การลงทะเบียนการเข้ารหัสต่อคำขอเป็นการทำงานที่เสียเปล่า; ลืมทำเลยจะทำให้เอกสารโค้ดเพจเก่าเสีย.
กระจายงานไปยังโหนดหลายตัว
ทั้งหมดข้างต้นเป็นการปรับจูนการเรนเดอร์ของโหนดเดียวตามความต้องการ. เมื่อโหนดเดียวไม่สามารถรับภาระได้, คันโยกต่อไปไม่ใช่การเพิ่มค่า — แต่เป็นการเผยแพร่ผลลัพธ์ของเอกสารครั้งเดียวไปยังที่เก็บข้อมูลร่วมและให้ทุกโหนดให้บริการ. สิ่งนี้เปลี่ยนโมเดลต้นทุน: การเรนเดอร์เกิดขึ้นครั้งเดียวต่อเอกสารแทนที่จะเป็นครั้งเดียวต่อเซสชัน, และคำขอหน้าเปลี่ยนเป็นการอ่านไฟล์. ดูที่ Distributed Deployments.
รายการตรวจสอบการปรับจูน
- ตั้งค่า
ImageResolutionที่ต่ำที่สุดที่ UX ของคุณยอมรับ. - เปิดไว้
CachePagesสำหรับการดูแบบโต้ตอบ; ปิดสำหรับสถานการณ์การดูครั้งเดียวหรือความพร้อมใช้งานสูง. - ปิดเซสชันอย่างชัดเจน; ลดระยะเวลา
TimeOutในกรณีที่การใช้งานเป็นแบบกระติก. - ใช้
LargeDoc+ ค่าเริ่มต้นAutoLoad = falseบนไคลเอนต์สำหรับเอกสารขนาดใหญ่. - ใช้
DefaultRender = falseเฉพาะเมื่อคุณต้องการการฉาย PDF ที่มีข้อความ.
หน้านี้เป็นประโยชน์หรือไม่?