دليل مستخدم SoftPlayer

فك ضغط SoftPlayer على الجهاز الهدف والتحقق من استيفاء البيئة للمتطلبات.

1. تأكد أن الجهاز الهدف يعمل بنظام Windows 10/11 x64.
2. افك ضغط حزمة SoftPlayer في مجلد دائم، مثلاً C:\SoftPlayer\.
3. تحقق أن المجلد يحتوي على SoftPlayer.exe وappsettings.json وبنية المجلد الفرعي SoftPlayerMedia\.
4. لتشغيل فيديو 8K، تأكد أن الجهاز يمتلك GPU يدعم فك التشفير بالعتاد (GTX 1060+ أو ما يعادله)؛ 4K وما دون يعمل مع الرسومات المدمجة.

• SoftPlayer.exe مرئي في المجلد المفكوك.
• مجلد SoftPlayerMedia\ مُنشأ مسبقًا مع مجلدات فرعية: Video وStandBy وAudio وPPT وغيرها.

• ضع SoftPlayer في مسار ثابت — ملفات الوسائط والسجلات وحالة الترخيص تُحفظ نسبيًا إلى مجلد البرنامج.
• يُنصح بتخزين SSD بسرعة قراءة 200 MB/s+ لتشغيل أكثر سلاسة بدقة عالية.

تأكيد بدء تشغيل البرنامج بشكل صحيح وإكمال تأهيل التشغيل الأول.

1. انقر نقرًا مزدوجًا على SoftPlayer.exe لتشغيله (لا تتطلب صلاحيات مسؤول).
2. في التشغيل الأول، يفتح البرنامج دليل البدء السريع في المتصفح الافتراضي (فقط في التشغيل الأول؛ الإطلاقات اللاحقة تتخطى هذه الخطوة).
3. بعد قراءة الدليل، قم بزيارة http://localhost:8766/ في المتصفح لفتح وحدة الإدارة.
4. في علامة التبويب Dashboard، تأكد أن حالة المشغّل طبيعية، ومعلومات الإصدار/الترخيص مرئية.

• يفتح المتصفح بنجاح وحدة الإدارة (http://localhost:8766/) ويعرض Dashboard.
• رقم الإصدار وحالة الترخيص مرئيان في رأس وحدة الإدارة.

لتعطيل دليل التشغيل الأول، اضبط System.ShowQuickStartOnFirstRun على false في appsettings.json.

التحكم الناجح بالمشغّل عبر UDP وتأكيد عمل قناة التحكم.

1. ضع ملف فيديو (مثلاً test.mp4) في مجلد SoftPlayerMedia\Video\.
2. افتح PowerShell وشغّل الأوامر التالية:
3. $udp = New-Object System.Net.Sockets.UdpClient
4. $data = [System.Text.Encoding]::UTF8.GetBytes("video:test.mp4")
5. $udp.Send($data, $data.Length, "127.0.0.1", 7600)
6. $udp.Close()
7. راقب ما إذا كانت نافذة SoftPlayer تبدأ في تشغيل الفيديو المحدد.

• تبدأ نافذة SoftPlayer في تشغيل ملف الفيديو المحدد.
• تُظهر علامة تبويب Log في وحدة الإدارة أن الأمر تم استقباله.

• ملف الفيديو في المجلد الخاطئ (يجب أن يكون في SoftPlayerMedia\Video\، ليس في جذر البرنامج).
• منفذ خاطئ (الافتراضي هو 7600، ليس منفذ وحدة الإدارة 8766).

إتقان صيغة الأمر وفهم الاستجابات الناجحة والفاشلة.

1. صيغة الأمر: command:argument، مثلاً video:show.mp4 أو volume:80.
2. الأوامر التي لا تحتوي على وسيطة يمكن إرسالها باسم الأمر فقط (النقطتان اختياريتان)، مثلاً play.
3. صيغة استجابة النجاح: OK:original-command، مثلاً OK:video:show.mp4.
4. صيغة استجابة الفشل: ERR:original-command:error-message.
5. لمسارات ملفات الوسائط، المطلوب اسم الملف فقط — يبحث المشغّل تلقائيًا في المجلد الفرعي المقابل: video: يبحث في SoftPlayerMedia/Video/.

• استجابة مسبوقة بـ OK بعد إرسال أمر يؤكد الصيغة الصحيحة والتنفيذ.
• استجابة ERR تتضمن سببًا محددًا (الملف غير موجود، خطأ في الصيغة، إلخ).

لتحديد مجلد فرعي، استخدم شرطة مائلة: video:subfolder/video.mp4 يبحث في SoftPlayerMedia/Video/subfolder/.

إتقان جميع الأوامر المتعلقة بتشغيل الفيديو.

1. تشغيل فيديو محلي: video:filename.mp4 (يبحث في مجلد Video).
2. تشغيل بث فيديو عبر الشبكة: webvideo:URL (يدعم بثوث HTTP/HTTPS/RTSP/RTMP/UDP).
3. تشغيل/استئناف: play: (استئناف الوسائط المتوقفة مؤقتًا).
4. إيقاف مؤقت: pause: (إيقاف الوسائط الحالية مؤقتًا).
5. إيقاف والعودة إلى الاستعداد: stop: (العودة إلى شاشة الترحيب / حلقة الاستعداد).
6. إيقاف كامل / شاشة سوداء: stoped: (شاشة سوداء لتوفير الطاقة).
7. إعادة تشغيل الوسائط الحالية: replay:.
8. التحكم في التقدم: seek:milliseconds (القفز إلى موضع)، forward: (تخطي 10 ثوانٍ للأمام)، backward: (تخطي 10 ثوانٍ للخلف).
9. سرعة التشغيل: speed:1.5 (يدعم 1.5x و2.0x وغيرها).

• بعد أمر video:، يبدأ المشغّل في تشغيل الملف المحدد.
• بعد أمر stop:، يعود إلى شاشة الاستعداد (إذا كان ملف الاستعداد مهيأ).

• للاستعداد الطويل في المعارض، استخدم standby: لتكرار ملف الاستعداد بدلاً من stoped: الشاشة السوداء (الشاشة السوداء قد تجعل الزوار يعتقدون أن الجهاز معطل).
• stop وstoped لهما دلالات مختلفة: stop يعود إلى شاشة الترحيب؛ stoped يعرض شاشة سوداء خالصة.

إتقان أوامر ضبط مستوى الصوت والتحكم في تشغيل الصوت.

1. ضبط مستوى الصوت (0-100): volume:80 (يضبط على قيمة دقيقة).
2. رفع الصوت 10%: volup: (يزيد بنسبة 10% في كل استدعاء).
3. خفض الصوت 10%: voldown: (يخفض بنسبة 10% في كل استدعاء).
4. تبديل الكتم: mute: (تبديل بين الكتم وإلغاء الكتم).
5. كتم صريح: muteon:.
6. إلغاء كتم صريح: muteoff:.
7. تشغيل ملف صوت: audio:filename.mp3 (يبحث في SoftPlayerMedia/Audio/).
8. إيقاف الصوت: audiostoped:.

• بعد volume:50، ينخفض مستوى صوت المشغّل إلى 50%.
• mute: يبدّل بين الصوت والصمت.

إتقان أوامر قائمة التكرار وترقيم صفحات PPT وتحميل الويب.

1. تكرار قائمة تشغيل: listloop:file1.mp4;file2.mp4;file3.mp4 (افصل الملفات بفاصلة منقوطة).
2. تشغيل تسلسلي (يتوقف عند النهاية): liststop:filename.
3. المسار التالي: next:، المسار السابق: prev:.
4. فتح PPT في وضع ملء الشاشة: ppt:filename.pptx (يبحث في SoftPlayerMedia/PPT/).
5. تنقل PPT: ppt:next (الشريحة التالية)، ppt:prev (السابقة)، ppt:home (الأولى)، ppt:end (الأخيرة).
6. القفز إلى شريحة: ppt:goto-5 (القفز إلى الصفحة 5).
7. تقدم PPT تلقائي: ppt:auto-5-filename.pptx (تقدم تلقائي كل 5 ثوانٍ).
8. تحميل صفحة ويب: web:URL (عرض URL محدد في ملء الشاشة).

• بعد أمر listloop:، يدور المشغّل عبر الملفات المدرجة.
• ppt:next يقدّم PPT إلى الشريحة التالية.

• يجب وضع ملفات PPT في SoftPlayerMedia/PPT/ قبل إرسال الأوامر.
• بالنسبة لملفات PDF، يعود الأمر إلى نافذة عارض مع ترقيم صفحات بمحاكاة ضغط المفاتيح.
• استخدم listloop لسيناريوهات تكرار المعرض بدلاً من إرسال أوامر فردية يدويًا.

فهم أوامر القناع والأوامر على مستوى النظام.

1. عرض طبقة قناع: openmask: (تضع طبقة قناع فوق الفيديو).
2. إخفاء طبقة قناع: closemask:.
3. ضبط سلوك نهاية التشغيل: endbehavior:Stop / Loop / Standby.
4. الحصول على الإصدار: version: (الاستجابة تتضمن معلومات الإصدار الحالي).
5. إعادة تشغيل المشغّل: restart: (إعادة تشغيل عملية المشغّل عن بُعد).

• بعد openmask:، تظهر طبقة قناع فوق الفيديو.
• بعد version:، تُستلم استجابة تحتوي على معلومات الإصدار.

معرفة الموقع الصحيح لكل نوع من ملفات الوسائط.

1. SoftPlayerMedia/Video/ — ملفات الفيديو (.mp4/.mkv/.avi إلخ)، تستخدمها أمر video:.
2. SoftPlayerMedia/StandBy/ — ملفات الاستعداد، تستخدمها أمر standby: والحلقة الافتراضية.
3. SoftPlayerMedia/Audio/ — ملفات الصوت (.mp3/.wav/.flac إلخ)، تستخدمها أمر audio:.
4. SoftPlayerMedia/BackgroundAudio/ — صوت الخلفية، يتكرر تلقائيًا عند تفعيله.
5. SoftPlayerMedia/PPT/ — ملفات PPT/PDF، تستخدمها أمر ppt:.
6. SoftPlayerMedia/Mask/ — صور القناع، تستخدمها أمر openmask:.
7. SoftPlayerMedia/Thumbnail/ — مجلد ذاكرة التخزين المؤقت للصور المصغرة (يُنشأ تلقائيًا، لا حاجة لملفات يدوية).

• بعد وضع فيديو في Video/، يشغّله أمر video:filename بشكل صحيح.
• تُنشأ بنية المجلد تلقائيًا عند الإطلاق الأول — لا حاجة لإعداد يدوي.

إدارة ملفات الوسائط يوميًا عبر وحدة إدارة المتصفح.

1. افتح http://player-IP:8766/ في متصفح للوصول إلى وحدة الإدارة.
2. انقر على التنقل العلوي للتبديل إلى علامة تبويب Files.
3. اختر المجلد الهدف (Video / StandBy / Audio / PPT، إلخ).
4. انقر Upload لاختيار الملفات، أو اسحب الملفات إلى منطقة الرفع.
5. يدعم إنشاء مجلدات وإعادة تسمية وحذف الملفات/المجلدات وتنزيل الملفات.
6. تدعم الملفات حتى 3 مستويات من المجلدات الفرعية؛ اختر المجلد الحالي عند الرفع.

• يظهر الملف المرفوع حديثًا في قائمة الملفات بعد الرفع.
• يشغّل أمر video:filename الملف المرفوع للتو بنجاح.

• تستخدم وحدة الإدارة المصادقة الأساسية (Basic Auth) — هيّئ اسم المستخدم/كلمة المرور في appsettings.json.
• الحد الافتراضي لرفع ملف واحد هو 500 ميغابايت، قابل للتهيئة في ملف الإعدادات.
• يمكن لطاقم الصيانة الميدانية رفع محتوى استبدالي عبر وحدة الإدارة دون RDP.

فهم قواعد التجربة والتخطيط لتوقيت الترخيص بشكل مناسب.

1. تبدأ تجربة 30 يومًا تلقائيًا عند التشغيل الأول لـ SoftPlayer.
2. جميع الميزات متاحة خلال التجربة، بما في ذلك تشغيل الدقة العالية وجميع أوامر UDP.
3. تحقق من الأيام المتبقية في التجربة في علامة تبويب Dashboard في وحدة الإدارة.
4. بعد انتهاء التجربة، يجب استيراد رمز ترخيص للاستمرار في الاستخدام.

• Dashboard وحدة الإدارة يعرض حالة التجربة الحالية والأيام المتبقية.
• تستجيب الأوامر بشكل طبيعي خلال التجربة دون قيود على الميزات.

• استخدم فترة التجربة لإكمال الاختبار والقبول قبل التسليم الرسمي للمشروع.
• اشترِ الترخيص قبل انتهاء التجربة لتجنب توقف المعرض.

اختيار مستوى الترخيص الصحيح بناءً على احتياجات دقة المعرض الفعلية.

1. ترخيص Standard: يدعم دقة تصل إلى 4K (3840×2160).
2. ترخيص Professional: يدعم دقة تصل إلى 16K (15360×8640).
3. متطلبات عتاد 4K: Intel i3+، 8 غيغابايت RAM، رسومات مدمجة (لا GPU منفصل مطلوب).
4. متطلبات عتاد 8K: Intel i5 الجيل الثامن+، 16 غيغابايت RAM، GTX 1060+.
5. متطلبات عتاد 16K: Intel i7+، 32 غيغابايت RAM، RTX 3070+.
6. إذا لم تكن متأكدًا من المستوى المطلوب، استخدم التجربة للتحقق من متطلبات الدقة الفعلية قبل الشراء.

• مستوى الترخيص يتطابق مع الحد الأقصى لدقة جهاز العرض في المشروع.
• تكوين عتاد الخادم يستوفي الحد الأدنى من المتطلبات للدقة الهدف.

يمكن لأجهزة الكمبيوتر التي لا تمتلك GPU منفصلاً تشغيل 4K وما دون (يتراجع البرنامج تلقائيًا إلى فك التشفير البرمجي)، لكن 8K/16K يتطلب GPU منفصلاً مؤهلاً.

استيراد رمز الترخيص للترقية من التجربة إلى الإصدار الكامل.

1. ابحث عن حقل Device ID في Dashboard وحدة الإدارة وانسخه.
2. قدّم معرف الجهاز للمورد محددًا المستوى المطلوب (Standard/Professional).
3. بعد استلام رمز الترخيص، انتقل إلى علامة تبويب Configuration في وحدة الإدارة وابحث عن قسم إدارة الترخيص.
4. الصق رمز الترخيص في حقل الإدخال وانقر على استيراد الترخيص.
5. بعد الاستيراد الناجح، تتغير حالة ترخيص Dashboard من Trial إلى Standard أو Professional.

• Dashboard وحدة الإدارة يعرض حالة الإصدار الكامل (Standard أو Professional).
• لم يعد تشغيل الفيديو عالي الدقة مقيدًا.

• تطبيق رمز ترخيص على الجهاز الخاطئ (الرموز مرتبطة بالجهاز؛ الجهاز الجديد يتطلب رمزًا جديدًا).
• انتظار انتهاء صلاحية التجربة قبل التقدم بطلب ترخيص، مما يتسبب في توقف المعرض.

استعادة قناة التحكم بأوامر UDP.

1. تأكد أن SoftPlayer يعمل (مرئي في شريط المهام أو إدارة المهام).
2. تحقق أن المنفذ في أمرك يتطابق مع إعداد UdpPort في appsettings.json (الافتراضي 7600).
3. تحقق ما إذا كان جدار حماية Windows يسمح بحركة UDP الواردة على المنفذ 7600.
4. إذا كانت قائمة IP البيضاء مفعّلة (IpWhitelistEnabled: true)، تأكد أن IP المُرسِل موجود في AllowedIps.
5. تحقق من علامة تبويب Log في وحدة الإدارة بحثًا عن سجلات استقبال الأوامر للتأكد من وصول الأوامر إلى المشغّل.

• سجلات وحدة الإدارة تُظهر سجلات استقبال الأوامر، مؤكدةً عمل قناة UDP.
• إرسال volume:50 يغير مستوى صوت المشغّل.

• اختبر بـ 127.0.0.1 (localhost) أولاً لاستبعاد مشكلات الشبكة قبل استخدام IP الفعلي.
• عند الإرسال من SoftControl، تأكد أن بروتوكول أمر UDP لـ SoftControl والمنفذ يتطابقان مع تكوين SoftPlayer.

تشخيص وحل أعطال تشغيل ملفات الوسائط.

1. تأكد أن ملف الفيديو موجود في SoftPlayerMedia\Video\ (ليس في المجلد الجذري للبرنامج).
2. أسماء الملفات حساسة لحالة الأحرف — تأكد أن الاسم في الأمر يتطابق تمامًا مع اسم الملف الفعلي بما في ذلك الامتداد.
3. للملفات في المجلدات الفرعية، أدرج المسار النسبي: video:subfolder/video.mp4.
4. تصفح علامة تبويب Files في وحدة الإدارة للتأكد من وجود الملف فعلاً.
5. لصيغ الملفات غير العادية، تحقق من سجلات وحدة الإدارة بحثًا عن رسائل خطأ VLC.
6. جرّب فتح نفس الملف مباشرة بـ VLC Player على الجهاز لاستبعاد تلف الملف.

• الملف الهدف مرئي في قائمة ملفات وحدة الإدارة.
• اسم الملف في الأمر يتطابق تمامًا مع ما هو معروض في قائمة الملفات.

• اسم الملف في الأمر يحتوي على مسافات أو أحرف بعرض كامل، مما يتسبب في عدم العثور على الملف.
• عدم تطابق حالة امتداد الملف (مثلاً الأمر يستخدم .MP4 لكن الملف هو .mp4 فعلياً).

حل مشكلات أداء تشغيل الفيديو عالي الدقة.

1. أكّد أولاً مستوى الترخيص الحالي: Standard يدعم 4K فقط؛ Professional يدعم 16K.
2. تحقق ما إذا كان GPU يدعم فك التشفير بالعتاد (GTX 1060+ أو ما يعادله مطلوب للـ 8K).
3. في علامة تبويب الأداء في إدارة المهام، تحقق من استخدام فك تشفير GPU — قرب 100% يشير إلى اختناق GPU.
4. تحقق من متطلبات سرعة قراءة القرص: 4K تحتاج 25-50 ميغابت/ثانية، 8K تحتاج 80-100 ميغابت/ثانية، 16K تحتاج 200+ ميغابت/ثانية.
5. خزّن ملفات الفيديو عالي الدقة على SSD لتجنب اختناقات قراءة HDD.
6. لضبط معاملات VLC، انظر التوثيق المدمج (docs\User Manual.html) في مجلد البرنامج.

• مستوى الترخيص يتطابق مع دقة التشغيل المطلوبة.
• تكوين العتاد يستوفي الحد الأدنى من المتطلبات للدقة الهدف.

استعادة وصول وحدة إدارة المتصفح.

1. تأكد أن SoftPlayer يعمل.
2. جرّب http://localhost:8766/ محليًا لاستبعاد مشكلات الشبكة أولاً.
3. تحقق من appsettings.json للتأكد أن HttpMonitor.Enabled هو true والمنفذ هو 8766.
4. تحقق ما إذا كان جدار حماية Windows يسمح بحركة TCP على المنفذ 8766.
5. إذا كان المنفذ مشغولاً ببرنامج آخر، غيّر HttpMonitor.Port في appsettings.json وأعد التشغيل.

• يمكن للمتصفح الوصول إلى http://localhost:8766/ وعرض وحدة الإدارة.
• Dashboard وحدة الإدارة يعرض حالة تشغيل المشغّل.