تحسين الأداء

تحسين العرض والذاكرة

ملف موارد 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 بكسل) من حجم الإخراج.

التخزين المؤقت للصفحات — الذاكرة مقابل إعادة العرض

BaseConfig.CachePages (الافتراضي true) يحتفظ بكل صفحة مُعروضة في الذاكرة طوال مدة الجلسة. هذا هو الإعداد الافتراضي الصحيح للعرض التفاعلي — المستخدمون يتنقلون للأمام والخلف. قم بإيقافه عندما:

  • الوثائق ضخمة وتُعرض مرة واحدة من البداية إلى النهاية،
  • العديد من الجلسات المتزامنة ستضاعف الصفحات المخزنة مؤقتًا،
  • تفضل دفع استهلاك المعالج لكل عرض بدلاً من احتفاظ بالذاكرة.
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 بدون Office يحتوي على خطوط أقل بكثير من جهاز التطوير. الخطوط المفقودة تسبب فحصًا بطيئًا للبدائل ومقاييس غير صحيحة؛ قم بتثبيت الخطوط، أو وجه FontFolders إلى مجلد يحتوي عليها.

استراتيجيات جانب العميل

  • LargeDoc = true — استراتيجية التحميل الكسول للوثائق الكبيرة جدًا؛ تُحمَّل الصفحات عندما يقترب المستخدم منها.
  • AutoLoad = false (الافتراضي) — لا تعرض حتى تستدعي فعليًا View(token).
  • ShowThumbs = false — تخطى إنشاء المصغرات/الطلبات للمعاينات ذات الصفحة الواحدة أو المدمجة.
  • تمكين FixedZoom يتجنب تغييرات التكبير الحرّة؛ عندما تُطابق C# ViewerConfig، اضبط FixedZoomPercentMobile (الافتراضي C# 75) للشاشات الصغيرة.

بدء التشغيل مرة واحدة، لا لكل طلب

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) ينتمي إلى Program.cs — تسجيل الترميزات لكل طلب هو عمل مهدور؛ نسيانه تمامًا يكسر مستندات صفحات الشيفرة القديمة.

توزيع العمل عبر العقد

كل ما سبق يضبط عرض عقدة واحدة عند الطلب. عندما لا تستطيع عقدة واحدة استيعاب الحمل، الرافعة التالية ليست ضبطًا أكبر — بل نشر مخرجات المستند مرة واحدة في التخزين المشترك والسماح لكل عقدة بخدمتها. هذا يغيّر نموذج التكلفة: يحدث العرض مرة واحدة لكل مستند بدلاً من مرة لكل جلسة، وتصبح طلبات الصفحات قراءات ملفات. راجع النشر الموزع.

قائمة مراجعة الضبط

  1. حدد أدنى ImageResolution يقبله تجربة المستخدم الخاصة بك.
  2. احتفظ بـ CachePages مفعلاً للعرض التفاعلي؛ أوقفه للسيناريوهات ذات المرور الواحد أو التزامن العالي.
  3. أغلق الجلسات صراحةً؛ قلل TimeOut حيث يكون الاستخدام متقلبًا.
  4. استخدم LargeDoc + الافتراضي AutoLoad = false على العميل للوثائق الكبيرة.
  5. استخدم DefaultRender = false فقط عندما تحتاج إلى إسقاط PDF يحتوي على نص.

هل كانت هذه الصفحة مفيدة؟