Siro/docs/04_features/AUDIO_MUSIC_FEATURES_AR.md

تحليل الميزات الصوتية والموسيقى — سيرو

Audio & Music Features Analysis — Siro Platform

النسخة: 1.0 | تاريخ: يوليو 2026 | التصنيف: داخلي | إعداد: فريق التحليل التقني

---

📋 فهرس المحتويات

1. ملخص الميزات الصوتية الحالية
2. Text-to-Speech (TTS)
3. المؤثرات الصوتية والإشعارات
4. المكالمات الصوتية (WebRTC + Agora)
5. تسجيل الصوت
6. البنية التحتية الصوتية (Backend)
7. الميزات الصوتية المفقودة — فرص الابتكار
8. خطة تطوير الموسيقى والترفيه الصوتي
9. دراسة الجدوى — ميزة الموسيقى

---

1. ملخص الميزات الصوتية الحالية

التقييم: ⭐⭐⭐☆☆ (4/10)

المجال	الحالة	التفاصيل
TTS (نص إلى كلام)	✅ موجود	تنقل صوتي، وصف واجهة، تحذيرات
مؤثرات صوتية	✅ موجود	أصوات طلبات الرحلات، إشعارات
مكالمات صوتية	✅ موجود	WebRTC + Agora بين السائق والراكب
تسجيل صوتي	✅ موجود	تسجيل الرحلة AAC-LC
موسيقى / ترفيه صوتي	❌ غير موجود	فرصة تنافسية كبيرة
راديو / Podcasts	❌ غير موجود	فرصة إيرادية جديدة
أوامر صوتية	❌ غير موجود	تجربة مستخدم متقدمة
Spotify / Apple Music	❌ غير موجود	ميزة تنافسية مطلوبة

---

2. Text-to-Speech (TTS)

2.1 التقنية

الخاصية	القيمة
الحزمة	flutter_tts (v4.x)
معدل الكلام	0.5
مستوى الصوت	1.0
اللغة الافتراضية	ar-SA (مع fallback إلى en-US)
iOS Audio Category	playback, mixWithOthers, duckOthers

2.2 الاستخدامات في تطبيق السائق

الملف	الاستخدام
navigation_controller.dart	إرشادات التنقل خطوة بخطوة (TTS عند كل منعطف)
navigation_service.dart	إنشاء كائن TTS للملاحة
map_driver_controller.dart	إعلانات حالة الرحلة
destination_controller.dart	وصف الوجهة
order_request_controller.dart	معلومات طلب الرحلة
gemeni.dart	تحذيرات التحقق من المستندات بالذكاء الاصطناعي
mydialoug.dart	قراءة نصوص الحوارات
criminal_documents_page.dart	معلومات المستندات
contact_us_page.dart	معلومات الاتصال

ميزة فريدة في تطبيق السائق: زر كتم الصوت (Mute) مع isSpeaking observable

2.3 الاستخدامات في تطبيق الراكب

الملف	الاستخدام
mydialoug.dart	قراءة نصوص الحوارات
car_details_widget_to_go.dart	معلومات السيارة والرحلة

---

3. المؤثرات الصوتية والإشعارات

3.1 حزمة just_audio

• الإصدار: ^0.10.5
• الاستخدام: تشغيل المؤثرات الصوتية القصيرة (ليس الموسيقى)

3.2 توزيع الملفات الصوتية

تطبيق الراكب:

الملف	الغرض	التنسيق
start.wav	نغمة رنين المكالمات	WAV
promo.wav	إشعار ترويجي	WAV
ding.wav	صوت إشعار عام	WAV
tone2.wav	نغمة إشعار	WAV
cancel.wav	صوت إلغاء/رفض	WAV
tone1.mp3	نغمة إشعار	MP3

تطبيق السائق:

الملف	الغرض	التنسيق
order.mp3	صوت طلب رحلة جديد (loop)	MP3
order1.wav	صوت طلب رحلة ثانوي	WAV
aggrement.wav	صوت تأكيد الموافقة	WAV
alert.wav	صوت تنبيه عام	WAV
iphone_ringtone.wav	نغمة رنين شبيهة iPhone	WAV
promo.wav	إشعار ترويجي	WAV
ding.wav	صوت إشعار	WAV
tone2.wav	نغمة إشعار	WAV
order.wav	صوت طلب (native)	WAV
cancel.wav	صوت إلغاء	WAV
tone1.mp3	نغمة إشعار	MP3

3.3 آلية تشغيل صوت الطلب

// في order_request_controller.dart:
void _playAudio() {
  _audioPlayer.setAsset('assets/order.mp3');
  _audioPlayer.setLoopMode(LoopMode.one);  // تكرار
  _audioPlayer.play();  // يشغل لمدة 15 ثانية (مدة المؤقت)
}

void _stopAudio() {
  _audioPlayer.stop();
  _audioPlayer.dispose();
}

---

4. المكالمات الصوتية (WebRTC + Agora)

4.1 البنية المعمارية

┌──────────────────────────────────────────────────────────┐
│                    CALL ARCHITECTURE                      │
│                                                           │
│  Passenger App                    Driver App              │
│  ┌─────────────────┐            ┌──────────────────┐     │
│  │ VoiceCallCtrl    │            │ VoiceCallCtrl     │     │
│  │ (WebRTC Peer)    │◄──────────►│ (WebRTC Peer)     │     │
│  └────────┬────────┘   Media    └────────┬─────────┘     │
│           │            Streams           │               │
│           │                               │               │
│  ┌────────▼────────┐           ┌─────────▼─────────┐     │
│  │ SignalingService │           │ SignalingService   │     │
│  │ (WebSocket)      │◄─────────►│ (WebSocket)        │     │
│  └────────┬────────┘   wss://   └─────────┬─────────┘     │
│           │           calls.intaleq       │               │
│           │           .com/ws              │               │
│           ▼                               ▼               │
│  ┌──────────────────────────────────────────────────┐     │
│  │         PHP Backend (create_call_session.php)     │     │
│  │              + Node.js Signaling Server           │     │
│  └──────────────────────────────────────────────────┘     │
│                                                           │
│  STUN Servers:                                            │
│  - stun:stun.l.google.com:19302                           │
│  - stun:stun1.l.google.com:19302                          │
└──────────────────────────────────────────────────────────┘

4.2 حالات المكالمة

idle → dialing → ringing → connecting → active → ended
                                                    ↓
                                                (120s max)

يتم إنهاء المكالمة تلقائياً بعد 120 ثانية

4.3 الميزات

• كتم الميكروفون (Mute)
• تبديل مكبر الصوت (Speaker)
• مؤقت 120 ثانية مع عد تنازلي
• ICE restart عند فشل الاتصال
• إعادة إنشاء الميكروفون عند عودة التطبيق
• دعم Echo Cancellation, Noise Suppression, Auto Gain Control

---

5. تسجيل الصوت

5.1 المواصفات التقنية

الخاصية	القيمة
الحزمة	record: ^6.2.0
الترميز	AAC-LC
معدل العينة	44100 Hz
معدل البت	128000 bps
الصيغة	M4A
تسمية الملف	{YYYY-MM-DD}_{rideId}.m4a

5.2 الميزات

• بدء/إيقاف التسجيل
• إيقاف مؤقت/استئناف
• تشغيل التسجيلات المسجلة (مع tracking للموضع)
• حذف الملفات
• رفع إلى الخادم عبر upload_audio.php

---

6. البنية التحتية الصوتية (Backend)

6.1 رفع الصوتيات (upload_audio.php)

الميزة	التفاصيل
الملفات المقبولة	audio/mp4, audio/mpeg, audio/wav, audio/x-m4a, audio/ogg, audio/webm
تسمية الملف	32-character hex عشوائي
المسار	upload_audio/
الصلاحيات	750
الرابط	https://api.siromove.com/upload_audio/{file}
Rate Limiting	Redis

6.2 إنشاء جلسة مكالمة (Call Session)

PHP Backend:
1. JWT Authentication
2. البحث عن الطرف الآخر في الرحلة النشطة
3. استدعاء Node.js signaling server: POST /sessions
   {ride_id, driver_id, passenger_id}
4. إرسال FCM notification للطرف الآخر (type: incoming_call)
5. إعادة session_id للطالب

6.3 Signaling Server

URL: https://calls.intaleqapp.com
Auth: VOICE_CALL_API_KEY (env)
Events: authenticate, participant_joined, offer, answer, ice_candidate, call_ended

---

7. الميزات الصوتية المفقودة — فرص الابتكار

7.1 تحليل الفجوة (Gap Analysis)

الميزة	سيرو	أوبر (Uber)	كريم (Careem)	Bolt	التوصية
تشغيل موسيقى في الكابينة	❌	✅ (Spotify)	❌	❌	عاجلة
راديو داخلي (Siro Radio)	❌	❌	❌	❌	فرصة ذهبية
بودكاست/محتوى تعليمي	❌	❌	❌	❌	ميزة فريدة
أوامر صوتية	❌	❌	❌	❌	مستقبلية
Sound Zones (ترحيب/وداع)	❌	❌	❌	❌	سهلة وسريعة
إعلانات صوتية مستهدفة	❌	❌	❌	❌	مصدر دخل
AI Music Curator	❌	❌	❌	❌	مبتكرة
تأثيرات صوتية محسنة	جزئي	✅	✅	✅	تحسين
Voice Commands للملاحة	❌	❌	❌	❌	مستقبلية

7.2 فرص الابتكار الصوتي

🎵 فرصة 1: Siro Radio (راديو سيرو)

الوصف: إذاعة داخل التطبيق تبث:
- موسيقى هادئة (خلفية للرحلة)
- إعلانات تجارية (مصدر دخل إضافي)
- نصائح للسائقين
- أخبار المرور

التقنية: HLS Streaming + Audio Player
الإيرادات: إعلانات صوتية مستهدفة
التكلفة: منخفضة (Content licensing via royalty-free)
التأثير: تمييز العلامة التجارية + إيرادات

🎵 فرصة 2: Spotify / Apple Music Integration

الوصف: ربط حساب المستخدم مع Spotify:
- الراكب يتحكم بالموسيقى أثناء الرحلة
- التشغيل عبر سماعات السيارة
- قوائم تشغيل حسب المزاج

التقنية: Spotify SDK + Apple MusicKit
التأثير: تجربة راكب متميزة
الإيرادات: عمولة إحالة Premium

🎵 فرصة 3: Podcasts تعليمية

الوصف: محتوى صوتي تعليمي للسائقين:
- تعلم اللغة الإنجليزية
- السلامة المرورية
- مهارات خدمة العملاء
- قصص نجاح

التأثير: تحسين جودة السائقين + تمييز

🎵 فرصة 4: Voice Assistant (مساعد سيرو الصوتي)

الوصف: "مرحباً سيرو..."
- "خذني إلى دمشق"
- "اتصل بالراكب"
- "شغّل موسيقى"
- "كم ربحت اليوم؟"

التقنية: Speech-to-Text + NLP + TTS
التأثير: واجهة تفاعل جديدة
الجدول: 6-12 شهر

🎵 فرصة 5: Sound Zones (المؤثرات الصوتية)

الوصف: موسيقى ترحيبية عند بدء الرحلة:
- 🎵 Sound Onboarding: موسيقى قصيرة عند بدء الرحلة
- 🎵 Sound Departure: موسيقى وداع عند النزول
- 🔔 Sound Alert: أصوات محسنة للتنبيهات

التأثير: تجربة عاطفية أفضل
التنفيذ: 1-2 أسبوع

🎵 فرصة 6: الإعلانات الصوتية

الوصف: إعلانات صوتية مدتها 5-10 ثوانٍ:
- قبل بدء الرحلة (للمستخدم)
- أثناء انتظار السائق
- بعد انتهاء الرحلة

الإيرادات: CPM (Cost Per Mille)
الاستهداف: حسب الموقع، الوقت، تاريخ الرحلات
}

---

## 8. خطة تطوير الموسيقى والترفيه الصوتي

### المرحلة 1: الأساسيات (شهر 1)
| المهمة | الجهد | الأولوية |
|--------|-------|----------|
| Sound Zones (ترحيب/وداع) | 3 أيام | 🟢 عالية |
| تحسين المؤثرات الصوتية | 3 أيام | 🟢 عالية |
| مكتبة أصوات عالية الجودة | 2 يوم | 🟡 متوسطة |

### المرحلة 2: Siro Radio (شهر 2-3)
| المهمة | الجهد | الأولوية |
|--------|-------|----------|
| HLS Streaming backend | 2 أسبوع | 🟢 عالية |
| Audio Player UI | 1 أسبوع | 🟢 عالية |
| اختيار المحتوى (موسيقى خالية من الحقوق) | 1 أسبوع | 🟡 متوسطة |
| نظام الإعلانات الصوتية | 2 أسبوع | 🟡 متوسطة |

### المرحلة 3: التكامل مع Spotify (شهر 3-4)
| المهمة | الجهد | الأولوية |
|--------|-------|----------|
| Spotify SDK integration | 2 أسبوع | 🟢 عالية |
| التحكم بالموسيقى UI | 1 أسبوع | 🟢 عالية |
| اختبار التكامل مع CarPlay | 1 أسبوع | 🟡 متوسطة |

### المرحلة 4: المحتوى التعليمي (شهر 4-6)
| المهمة | الجهد | الأولوية |
|--------|-------|----------|
| منصة Podcasts | 2 أسبوع | 🟡 متوسطة |
| إنتاج محتوى (10 حلقات) | 3 أسبوع | 🟡 متوسطة |
| Voice Assistant الأساسي | 4 أسبوع | 🔴 طويلة الأجل |

---

## 9. دراسة الجدوى — ميزة الموسيقى

### 9.1 التكلفة التقديرية

| المكون | التكلفة التقديرية |
|--------|-------------------|
| Sound Zones + تحسين المؤثرات | $500 - $1,000 |
| Siro Radio (تطوير + استضافة) | $3,000 - $5,000 |
| Spotify Integration | $2,000 - $4,000 |
| المحتوى التعليمي (Podcasts) | $1,000 - $2,000 |
| **الإجمالي المقدر** | **$6,500 - $12,000** |

### 9.2 العائد المتوقع

| مصدر الإيرادات | التقدير الشهري (3 دول) |
|-----------------|------------------------|
| إعلانات Siro Radio | $500 - $2,000 |
| Spotify Premium referrals | $200 - $800 |
| محتوى مدفوع (Podcasts) | $100 - $500 |
| تحسين الاحتفاظ بالركاب | غير مباشر — كبير |
| **الإجمالي** | **$800 - $3,300/شهر** |

### 9.3 مؤشرات النجاح
- **ROI المتوقع**: 6-12 شهر
- **تأثير على الاحتفاظ بالركاب**: +15-25%
- **تأثير على تقييم التطبيق**: +0.5 نجوم
- **رضا السائقين (موسيقى خلفية)**: +20%

---

## الملخص

**الميزات الصوتية الحالية في سيرو محدودة بالتطبيقات الوظيفية** (TTS للملاحة، مكالمات، تسجيل) وتفتقر تماماً إلى أي عنصر ترفيهي أو موسيقي.

**هذه فجوة تنافسية كبيرة** — أوبر يتفوق بتكامله مع Spotify، ولا يوجد أي منافس إقليمي يقدم تجربة صوتية متكاملة. سيرو لديها فرصة ذهبية لتصبح **أول منصة نقل في المنطقة تقدم تجربة ترفيه صوتي متكاملة**.

**التوصية**: البدء فوراً بـ Sound Zones وتحسين المؤثرات (جهد قليل، تأثير كبير)، ثم Siro Radio (مصدر دخل جديد)، ثم Spotify Integration (ميزة تنافسية).

> "الموسيقى ليست رفاهية — إنها الميزة التنافسية القادمة في عالم النقل الذكي"