تحسين الأداء

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

ملف موارد Doconut يهيمن عليه ثلاثة أشياء: DPI العرض، ما يبقى مخزنًا مؤقتًا، ومدة بقاء الجلسات. يشرح هذا الدليل الرافعات بحسب تأثيرها.

الدقة — الرافعة الأكبر

ImageResolution (25–300 DPI) يتحكم في كل من وقت العرض وحجم الصورة. معظم الصيغ الافتراضية 200 DPI؛ الصور وPSD الافتراضية 100.

csharp
// A document list preview doesn't need print quality
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/PPT على Linux/Docker: الخطوط المفقودة تسبب فحصًا بطيئًا للبدائل ومقاييس خاطئة؛ وجه FontFolders إلى دليل يحتوي على خطوطك.
  • العروض التقديمية على Linux/macOS: يمكن فتح ملفات PPT/PPTX/PPS/POT/ODP، لكن العرض باستخدام محرك العروض الحالي يتطلب libgdiplus الأصلي ومفتاح التشغيل System.Drawing.EnableUnixSupport=true. عائلات الصيغ الأخرى تستخدم مسار العرض المتعدد المنصات العادي.

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

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

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

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

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

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

قائمة فحص الضبط

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

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