Music Player

مشغل موسيقى لـ مكتبتك الشخصية. مجموعة FLACs، MP3 المنسوخة من CD، podcasts المنزلة، تسجيلات حية تراكمتها على مر السنين. كل شيء في مشغل يعمل على أي جهاز مسجل دخول — هاتف، جهاز لوحي، كمبيوتر محمول، Smart TV — مع بث مباشر من HD المنزل، تشغيل في الخلفية (الشاشة مطفأة تستمر في التشغيل) و visualizer للطيف حقيقي.

فكر في Spotify، ولكن مع ملفاتك الخاصة وبدون اشتراك شهري.

---

النقاط البارزة

🎵

قوائم التشغيل

أنشئ ونظم قوائم تشغيل مخصصة مع المزامنة التلقائية في السحابة.

📡

بث الشبكة

استمع للموسيقى من HD المنزل، من أي مكان في العالم.

📱

التشغيل في الخلفية

استمر في الاستماع مع إيقاف شاشة الهاتف.

🌈

Visualizer

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

---

إضافة الموسيقى

📁 من خلال مدير الملفات

ابحث عن ملف صوتي (.mp3، .wav، .ogg، .flac) في مدير الملفات و انقر نقرًا مزدوجًا. سيفتح Music Player تلقائيًا ويبدأ التشغيل.

🔗 عبر URL

الصق URL مباشر لملف صوتي يمكن الوصول إليه عبر الإنترنت. مفيد للروابط المباشرة من الاستضافة أو CDNs.

📂 إضافة مجلد كامل

استورد مجلدًا كاملاً يحتوي على عدة ملفات صوتية مرة واحدة إلى مكتبتك.

💾 من قرص الشبكة الخادم

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

---

بث قرص الشبكة

🌟 وظيفة بارزة! استمع للموسيقى من HD المنزل من أي مكان في العالم، مثل خدمة بث شخصية تشبه Spotify — ولكن مع مجموعة الموسيقى الخاصة بك.

كيف يعمل؟

1. ملفات MP3 الخاصة بك على HD لجهازك أو الخادم
2. هذه الملفات معينة كـ volumes في RoqueOS Server
3. Music Player يصل عبر HTTP streaming من خلال الخادم
4. تستمع من أي جهاز متصل بالإنترنت

خطوة بخطوة

1. عيّن مجلد الموسيقى في docker-compose.yml:

services:
  roqueos-server:
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/user/Music:/app/disks/Music # ← HD الموسيقى الخاص بك

2. أعد تشغيل الخادم:

docker compose down && docker compose up -d

3. في RoqueOS، افتح Music Player وأضف مجلد الشبكة:

• انقر على زر إضافة مجلد
• تنقل إلى قرص Music في selector الشبكة
• اختر المجلد المطلوب وأكد
• ستُستورد جميع موسيقى المجلد إلى مكتبتك

4. تم! استمع من أي مكان.

إذا كنت تستخدم Cloudflare Tunnels للوصول الخارجي، يعمل البث من أي مكان في العالم باتصال بالإنترنت.

---

التشغيل في الخلفية (Background Playback)

📱 وظيفة أساسية للهاتف! يستمر Music Player في التشغيل حتى عند قفل شاشة الهاتف أو تبديل التطبيقات.

كيف يعمل على الهاتف؟

يستخدم RoqueOS Media Session API للمتصفح، والذي يسمح بـ:

• الشاشة مطفأة — تستمر الموسيقى في التشغيل بشكل طبيعي
• التحكم على شاشة القفل — Play، pause، التالي والسابق تظهر في إشعار النظام
• التحكم على السماعات — أزرار سماعات Bluetooth تعمل بشكل طبيعي
• تبديل التطبيق — لا تتوقف الموسيقى عند فتح تطبيقات أخرى

المتطلبات

• استخدم RoqueOS عبر PWA مثبت أو تطبيق أصلي (iOS/Android)
• متصفح Chrome، Safari أو Edge في إصدار حديث
• على iOS، يجب أن يكون PWA مثبتًا على الشاشة الرئيسية لتعمل ميزة التشغيل في الخلفية

نصيحة

للحصول على أفضل تجربة بث على الهاتف، ثبت RoqueOS كـ PWA أو نزّل التطبيق الأصلي من App Store أو Microsoft Store.

---

إدارة قوائم التشغيل

إنشاء قائمة تشغيل

1. في منطقة قوائم التشغيل في اللوحة الجانبية، انقر على + قائمة تشغيل جديدة
2. أعطِ قائمة التشغيل اسمًا
3. اسحب الموسيقى من المكتبة إلى قائمة التشغيل، أو استخدم قائمة سياق الموسيقى

التنظيم

• إعادة الترتيب — اسحب الموسيقى داخل قائمة التشغيل لتغيير الترتيب
• إزالة — انقر بزر الفأرة الأيمن على موسيقى وحدد "إزالة من قائمة التشغيل"
• إعادة تسمية — انقر على اسم قائمة التشغيل لتعديله
• حذف — أزل قائمة التشغيل بأكملها من قائمة السياق

المزامنة

تتزامن جميع قوائم التشغيل ومكتبة الموسيقى تلقائيًا في حسابك. إذا أنشأت قائمة تشغيل على الكمبيوتر، ستظهر على الهاتف في المرة التالية التي تفتح فيها Music Player.

---

Visualizer الصوت

يحتوي Music Player على visualizer لطيف الترددات في الوقت الفعلي يستجيب للموسيقى المعزوفة. تعرض الرسوم المتحركة الترددات المنخفضة والمتوسطة والعالية في أشرطة ملونة ترقص وفقًا للإيقاع.

ملاحظة حول CROSS-ORIGIN

يعمل visualizer بشكل مثالي مع الملفات المحلية ونفس المصدر. لبث قرص الشبكة في مجالات مختلفة (مثل: الوصول إلى casa.roqueos.com أثناء تشغيل التطبيق في localhost)، يستخدم visualizer وضع pulse البديل بسبب قيود CORS للمتصفح — تستمر الموسيقى في التشغيل بشكل طبيعي.

---

widget الوسائط على سطح المكتب

عندما تكون الموسيقى قيد التشغيل، يظهر mini player على شريط مهام RoqueOS، مما يسمح بالتحكم السريع دون الحاجة إلى فتح نافذة Music Player:

• ⏯️ Play / Pause
• ⏭️ المسار التالي
• ⏮️ المسار السابق
• 🔊 التحكم في الصوت

---

التنسيقات المدعومة

التنسيق	الامتداد	الدعم
MP3	.mp3	✅ جميع المتصفحات
WAV	.wav	✅ جميع المتصفحات
OGG Vorbis	.ogg	✅ Chrome، Firefox، Edge
FLAC	.flac	✅ Chrome، Edge، Safari 14.1+
AAC	.aac، .m4a	✅ جميع المتصفحات
WebM Audio	.webm	✅ Chrome، Firefox، Edge

---

نصائح للاستخدام

نصائح سريعة

• انقر نقرًا مزدوجًا على موسيقى في المكتبة لتشغيلها فورًا
• استخدم قائمة السياق (نقر بزر الفأرة الأيمن) لإضافة الموسيقى إلى قوائم التشغيل
• يتذكر المشغل الموضع والقائمة للتشغيل عند إعادة فتح التطبيق
• لجودة بث عن بُعد أفضل، استخدم تنسيقات مدمجة مثل MP3 أو AAC
• مع Cloudflare Tunnels، يعمل البث عالميًا دون كشف المنافذ