إضافة فيديو

يحتوي S3D Player على زر Catalog. يفتح هذا الزر Media Manager، وهي نافذة للوصول السريع إلى مقاطع الفيديو والصور ثلاثية الأبعاد. تختار مصدرًا من القائمة، وتمرر البطاقات وتبدأ تشغيل الفيديو بنقرة واحدة. يمكن أن يكون المصدر مجلدًا على جهاز الكمبيوتر الخاص بك، أو قناة YouTube، أو خادمك الخاص المحمي بكلمة مرور. يتم وصف المصادر في ملف تكوين نصي بسيط، ويمكنك إضافة العدد الذي تحتاجه دون أي برمجة.

مدير الوسائط

طرق الاتصال

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

الطريقة	مكان وجود مقاطع الفيديو	ما تحتاجه	الحفظ على القرص
مجلد محلي	على جهاز الكمبيوتر الخاص بك	مسار المجلد فقط	غير مطلوب، الملفات ملكك بالفعل
قناة YouTube	على YouTube	رابط إلى القناة	مسموح به
خادمك الخاص	على استضافة الويب الخاصة بك	استضافة مع PHP، حزمة الكود الخاصة بنا	إذا كان الخادم يسمح بذلك
خادم + Cloudflare R2	في التخزين السحابي Cloudflare R2	استضافة مع PHP، حساب Cloudflare، حزمة الكود الخاصة بنا	إذا كان الخادم يسمح بذلك

تكوين الكتالوج

يتم وصف جميع مصادر الوسائط في ملفين نصيين موجودين في مجلد المشغل plugins\catalog\. يمكنك فتحهما مباشرة من نافذة Media Manager باستخدام الزرين Base و User. بمجرد حفظ الملف، تلتقط النافذة التغييرات تلقائيًا.

catalog-base.txt: قائمة بالمصادر التي تعرض المشغل. يتم استبدال هذا الملف بتحديثات المشغل من وقت لآخر، لذلك لا تضع تغييراتك الخاصة هنا: ستُفقد في التحديث التالي.
catalog-user.txt: قائمتك الخاصة. لا تعدلها التحديثات أبدًا.

في قائمة اختيار المصدر، تظهر المصادر بنفس الترتيب كما في الملفات: أولاً كل شيء من catalog-base.txt، ثم كل شيء من catalog-user.txt. إذا كان ملفك يحتوي على قسم بنفس اسم قسم في الملف الأساسي، فإن إعداداتك تحل محل الإعدادات الأساسية.

تنسيق الملف
يبدأ كل مصدر باسم بين قوسين مربعين، تليه أسطر بالصيغة key = value. أي شيء بعد علامة # هو تعليق. تُكتب الإعدادات العامة في أعلى الملف، قبل القسم الأول:

# general settings
quality  = 1080      # 720 / 1080 / 2160
thumb    = max       # preview: mq / 720 / max
save_dir = D:\Video\Saved
cookies  = firefox   # YouTube sign in, see the YouTube section

# source
[My 3D videos]
path      = D:\Video\3D
recursive = 1

الطريقة 1: مجلد على جهاز الكمبيوتر الخاص بك

أبسط طريقة. يقوم المشغل بفحص المجلد ويعرض جميع مقاطع الفيديو كبطاقات مع معاينات. تُؤخذ المعاينات من إطار من الفيديو نفسه؛ بالنسبة لمقاطع الفيديو ثلاثية الأبعاد يُستخدم العرض الأيسر.

الخطوة 1. افتح catalog-user.txt
في نافذة Media Manager، انقر على زر User.

الخطوة 2. أضف قسمًا

[My 3D videos]
path      = D:\Video\3D
recursive = 1
include   = SBS, 3D

path: المسار الكامل إلى المجلد الذي يحتوي على مقاطع الفيديو.
recursive = 1: تضمين المجلدات الفرعية أيضًا. بدون هذا السطر يتم فحص المجلد نفسه فقط.
include: عرض مقاطع الفيديو التي يحتوي عنوانها على واحدة من هذه الكلمات فقط. اختياري.
exclude: إخفاء مقاطع الفيديو التي يحتوي عنوانها على أي من هذه الكلمات. اختياري.

الخطوة 3. احفظ الملف
حدد المصدر الجديد في قائمة المصادر الخاصة بالنافذة. يتم فحص المجلد في كل مرة يتم تحديده، لذلك تظهر الملفات الجديدة في القائمة على الفور. إذا لم يكن المجلد موجودًا، تعرض النافذة Folder not found.

* يكتشف المشغل تنسيق ثلاثي الأبعاد من اسم الملف، على سبيل المثال movie_p.mp4 أو movie SBS.mkv. إذا لم يحدد الاسم التنسيق، يحاول كاشف التنسيق الخاص بالمشغل تحديده أثناء التشغيل.

الطريقة 2: قناة YouTube

يعرض المشغل مقاطع الفيديو الخاصة بالقناة المحددة ككتالوج ويشغلها دون متصفح. يتيح لك عامل التصفية حسب الكلمات في العنوان الاحتفاظ بمقاطع الفيديو ثلاثية الأبعاد فقط وإسقاط الباقي.

الخطوة 1. أضف قسمًا إلى catalog-user.txt

[4K Cine Trailer]
url          = https://www.youtube.com/@4kcinematrailer
include      = 3D, SBS
exclude      = anaglyph, VR
search_max   = 3000
search_limit = 200

url: عنوان القناة.
include / exclude: الكلمات في عناوين مقاطع الفيديو التي تحدد أي مقاطع فيديو يتم عرضها وأيها يتم إخفاؤها.
search_max: الحد الأقصى لعدد مقاطع فيديو القناة التي يتم البحث فيها.
search_limit: عدد مقاطع الفيديو المطابقة التي يتم وضعها في الكتالوج.

الخطوة 2. انقر على Rescan
لتجنب تفعيل حماية YouTube من الروبوتات، لا يقوم المشغل بفحص القنوات من تلقاء نفسه أبدًا. عند فتح النافذة، يعرض القائمة المحفوظة. يتم تحميل مقاطع الفيديو الجديدة فقط بواسطة زر Rescan وعند التمرير إلى نهاية القائمة، في كل مرة بالضبط بقدر ما يتسع في النافذة.

الخطوة 3. إذا طلب منك YouTube تأكيد أنك لست روبوتًا
يحدث هذا على شبكات الجامعات والمكاتب ومع بعض مزوّدي خدمة الإنترنت الكبار. سجّل الدخول إلى حسابك على YouTube في متصفح Firefox. سيستخدم المشغّل بعد ذلك تسجيل الدخول هذا للوصول إلى مقاطع الفيديو بشكل طبيعي. أضف السطر التالي في أعلى ملف catalog-user.txt:

cookies = firefox

بدلاً من firefox يمكنك إعطاء المسار إلى ملف cookies.txt. المتصفحات المبنية على Chrome (Chrome, Edge, Opera, Brave) لن تعمل: فهي تشفّر ملفات تعريف الارتباط الخاصة بها، لذلك لا يستطيع المشغّل استخدامها.

* عندما يرفض YouTube الوصول، يوقف المشغّل طلباته لمدة 30 دقيقة. هذا يحمي عنوان IP الخاص بك من الحظر. يُلغى التوقف من تلقاء نفسه بعد فترة.

الطريقة 3: كتالوج خاص على استضافة الويب الخاصة بك

لمن يريد عرض مقاطع الفيديو ثلاثية الأبعاد الخاصة به لأصدقائه أو عملائه أو جمهوره. تُخزَّن مقاطع الفيديو على استضافة الويب الخاصة بك؛ ويحصل المشغّل على القائمة ويشغّلها فقط باستخدام اسم مستخدم وكلمة مرور. أنت تقرر من يمكنه المشاهدة ومن يُسمح له بحفظ مقاطع الفيديو. جرّب العرض التجريبي، فهو مضمن بالفعل في المشغّل: S3D demo server

ما تحتاج إليه
خطة استضافة عادية غير مكلفة مع PHP وApache (دعم .htaccess). لا حاجة إلى خادم مخصص.

حزمة الشيفرة: خادم الفيديو الخاص بك

الخطوة 1. ارفع الحزمة إلى استضافتك
فك ضغط الأرشيف وانسخ المجلد إلى استضافتك، مثلاً إلى /demo/. توضع مقاطع الفيديو في مجلد media الخاص به.

الخطوة 2. اضبط config.php
افتح config.php في مجلد الحزمة. فهو يحدد اسم ملف لوحة الإدارة وكلمة المرور الأولية الخاصة بها. غيّر كليهما قبل أن يصبح الموقع متاحًا للعامة.

الخطوة 3. أضف المستخدمين
في لوحة الإدارة، أنشئ مستخدمين بكلمات مرور وحدد من منهم يُسمح له بحفظ مقاطع الفيديو.

الخطوة 4. اختبر الخادم
في موجه أوامر Windows:

curl -i -X POST -d "user=demo-user&pass=12345" "https://example.com/demo/list.php"

استجابة 200 مع #private في السطر الأول: الخادم يعمل. استجابة 403: اسم مستخدم أو كلمة مرور خاطئة.

الخطوة 5. أضف الخادم إلى المشغّل

[My server]
url      = https://example.com/demo/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

اختر المصدر وانقر على Rescan. في المرة التالية التي تُفتح فيها النافذة، تُؤخذ القائمة من ذاكرة التخزين المؤقت وتُحدَّث في الخلفية.

الطريقة 4: Cloudflare R2 + استضافة الويب الخاصة بك

Cloudflare offers very favorable terms for storing and serving your files: up to 10 GB of storage for free and free outbound traffic, with moderate pricing beyond that. Use a small private hosting plan for logins and passwords, while the videos themselves are stored in Cloudflare R2 cloud storage instead of on the hosting. The hosting only checks the password and gives the player the links. The video goes to the viewer directly from R2, so large files take neither space nor traffic on your hosting. Try the demo, it is already included in the player: Cloudflare-R2 demo video

Cloudflare R2
حزمة الكود: R2 + video

الخطوة 1. إنشاء حاوية R2
في لوحة تحكم Cloudflare، افتح R2 object storage، وأنشئ حاوية وارفع مقاطع الفيديو إليها.

الخطوة 2. إنشاء مفتاح وصول
في R2 object storage، ضمن Account Details، انقر على Manage بجوار API Tokens. الأذونات: Object Read only؛ الحاوية: حاويتك فقط (Apply to specific buckets only)؛ مدة الصلاحية: Forever. بعد إنشاء الرمز، انسخ Access Key ID و Secret Access Key. يُعرض السر مرة واحدة فقط.

الخطوة 3. رفع الحزمة إلى الاستضافة
انسخ مجلد الحزمة إلى استضافتك، على سبيل المثال إلى /cloudflare/. في config.php، أدخل Account ID والمفتاحين واسم الحاوية، وكذلك اسم ملف لوحة الإدارة وكلمة مروره.

الخطوة 4. إضافة المستخدمين والاختبار
كما في الطريقة 3: المستخدمون في لوحة الإدارة، واختبار باستخدام أمر curl.

الخطوة 5. إضافة الخادم إلى المشغل

[My R2 server]
url      = https://example.com/cloudflare/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

* يُخزَّن مفتاح R2 على الاستضافة فقط؛ ولا يحصل عليه المشاهدون أبدًا. يصدر الخادم روابط فيديو مؤقتة صالحة لمدة ساعة واحدة.

حفظ مقاطع الفيديو

إذا كان المصدر يسمح بالحفظ، يعرض رأس النافذة مربع اختيار Save. عند تحديده، يُكتب الفيديو أيضًا على القرص أثناء تشغيله: إلى مجلد save_dir الخاص بقسم المصدر أو، إذا لم يكن محددًا هناك، إلى save_dir العام. يمكن دائمًا حفظ مقاطع الفيديو من قنوات YouTube. يسمح الخادم الخاص بالحفظ فقط للمستخدمين الذين أذن لهم مالك الخادم. لا يتوفر خيار الحفظ للمجلد المحلي، لأن الملفات موجودة بالفعل على جهاز الكمبيوتر الخاص بك.

تصل الأذونات من الخادم الخاص مع القائمة عند النقر على Rescan. حتى يتم النقر على Rescan، تعرض النافذة No save بدلاً من مربع الاختيار.

استكشاف الأخطاء وإصلاحها

إذا كانت القائمة فارغة، تعرض نافذة Media Manager السبب.

No cache: press Rescan
لم يتم تحميل المصدر مطلقًا. انقر على Rescan.

Folder not found
المجلد غير موجود. تحقق من المسار في path.

Wrong user or password
رفض الخادم تسجيل الدخول أو كلمة المرور. تحقق من user وpassword.

Too many attempts, wait 15 min
محاولات تسجيل دخول فاشلة كثيرة متتالية. انتظر 15 دقيقة.

Server not responding
لا يوجد اتصال بالشبكة، أو العنوان في url غير صحيح.

YouTube: requests refused
اعتبر YouTube الطلبات مشبوهة. فعّل cookies = firefox وانتظر حتى تنتهي فترة الإيقاف.