Qt and Phonon



مقدمة:



فونون phonon هي عبارة عن Multimedia API لتشغيل ملفات الصوت والفيديو .
هذا المشروع طور في الاساس لسطح المكتب 4 KDE بهدف عمل واجهة بسيطة Simple Interface لتطوير تطبيقات الـ Multimedia بدلا من الحلول المعقدة قبلها .ومن مميزاتها الرئيسية هي انها مفصولة تماما عن أي محرك صوتيات Multimedia Framework/Server مثل GStreamer,Xine,VLC...etc وتستطيع استخدامها مع اي محرك في حالة توفر plugin له.

بداية مشروع phonon كانت بالاعتماد على محرك xine في تشغيل ملفات الصوت و الفيديو ، الى أن تدخلت TT 'حاليا qtsoftware' وقامت باضافة عدة plugin بحيث أصبحت phonon أيضا تدعم GStreamer على اللينوكس ' ، و DirectShow في ويندوز و QT' QuikTime' في OS X .

اذا ياختصار phonon هي دوال فقط او front-end، ولا تعمل بدون محركات الصوت back-end ، فوظيفتها فقط هي توفير واجهة موحدة لتشغيل الملتميديا .

وفي +Qt 4.4 قامت qtsoftware باستخدام phonon كموديل ،وبهكذا أصبح بالامكان تطوير تطبيقات لتشغيل ملفات الصوت والفيديو بشكل متعدد المنصات Cross Platform ،بدلا من اللجوء الى اي مكتبات خارجية External Libs ، لكن لن تستطيع سوى استخدام المحركات التي قامت qtsoftware بدعمها في Qt ، لذلك يجب توفر المحركات/البرامج الاتية لكي تعمل معك phonon بشكل صحيح :
في اللينوكس يجب توفر GStreamer
اما في الويندوز يجب توفر DirectShow
وفي ماك OS X يجب توفر QuikTime


تنصيب phonon على ويندوز
يجب تحميل Dx و DirectShow 9 بالاضافة الى SDK لويندوز.
وأيضا يجب توفر فيجوال سي++.

وهذه روابط تشرح كيفية التنصيب :
http://www.matthiaspospiech.de/blog/2008/07/30/compilation-of-phonon-under-windows-xp/
http://wiki.qtcentre.org/index.php?title=Building_the_Phonon_backend_plugin_on_Windows_using_MinGW


التنصيب على لينوكس :
قم بفتح مدير الحزم وحمل gstreamer اولا ثم قم بتحميل الباكج التالية :

phonon
libphonon4
phonon-devel
phonon-backend-gstreamer
فقط من دون الحاجة الى اعادة ترجمة كيوت !

الشكل العام ل phonon :
تتكون phonon من ثلاث مفاهيم أساسية وهي media objects, sinks, and paths .
ال media object هي الفئة التي تتعامل مع ملفات الصوت والفيديو وتقوم بالتحكم فيها starting, stopping, and pausing
اما ال sinks فهي الفئات المتخصة باخراج الصوت او الفيديو الى كرت الصوت او الشاشة.
اخيرا ال path يمثل الفئة التي تربط بين ال media objects و ال sinks ، بحيث يقوم ال media object بارسال ال media stream الى اي sink مرتبط به عبر path معين وبعدها يقوم ال sink بارسال هذا ال stream الى كرت الصوت او الشاشة.


ملاحظات:
+فئات ودوال phonon معرفة في مساحة الاسماء Phonon لذلك ستجد قبل كل فئة او دالة اسم مساحة الاسماء Phonon::XXX.
+في ملف المشروع يجب إضافة : QT += phonon.

كيفية استخدام phonon :
يوجد طريقتين تستطيع بها تشغيل ملفات الصوت والفيديو في phonon ، الطريقة الاولى وهي بسيطة جدا ولا تتطلب انشاء العناصر الثلاثة السابقة ، فقط عليك ان تقوم باستدعاء الدالة Phonon::createPlayer مع تمرير الملف المراد تشغيله ومن ثم استدعاء الدالة play .
مثال لتشغيل ملف صوت:

  1. Phonon::MediaObject* audioPlayer = Phonon::createPlayer(Phonon::MusicCategory,Phonon::MediaSource('sound.mp3'));
  2. audioPlayer->play();
  3.  


بنفس الطريقة أيضا يمكن تشغيل ملف فيديو ، حيث يجب انشاء كائن من الفئة Phonon::VideoPlayer ومن ثم استدعاء الدالة play وتمرير اسم ملف الفيديو .
مثال:

  1. Phonon::VideoPlayer* videoPlayer = new Phonon::VideoPlayer(Phonon::VideoCategory,this);
  2. videoPlayer->play(Phonon::MediaSource('sound.mp3'));



انشاء العناصر الاساسية ل phonon :

ال MediaObject :
كما ذكرنا سابقا هذه الفئة تحمل الملف المراد تشغيله ، وكذلك تتحكم في ال playback مثل play,pause,seek and stop

ال MediaSource :
تمثل الملف المراد تشغيله ، والذي يمكن ان يكون على جهازك او في موقع url او في جهاز اخر على الشبكة.

ال Sinks :
وتاتي على شكلين ، الاول هو AudioOutput وهي الفئة التي تنقل الصوت الى كرت الصوت، وايضا تتحكم في درجة الصوت وال Mute.
والشكل الثاني هو VideoWidget وهي تختص بعرض ملفات الفيديو وتتحكم في ال brightness, hue, and scaling للفيديو.

مثال لتشغيل ملف صوت عن طريق بناء العناصر:

  1. Phonon::MediaObject* player=new Phonon::MediaObject(parent);
  2. player->setCurrentSource(Phonon::MediaSource('/home/audio.mp3'));
  3. Phonon::AudioOutput* audioOutput=new Phonon::AudioOutput(parent);
  4. Phonon::createPath(player,audioOutput);
  5. player->play();


صورة توضيحية :


وهذا مثال اخر لتشغيل ملف فيديو 'من دون صوت ' 

  1.  
  2. Phonon::MediaObject* player=new Phonon::MediaObject(parent);
  3. player->setCurrentSource(Phonon::MediaSource('/home/video.mpg'));
  4. Phonon::VideoWidget* videoWidget=new Phonon::VideoWidget(parent);
  5. Phonon::createPath(player,videoWidget);
  6. player->play();


ولتشغيل ملف يحوي فيديو مع الصوت يجب انشاء AudioOutput و VideoWidget كالاتي:

  1.  
  2. Phonon::MediaObject* player=new Phonon::MediaObject(parent);
  3. player->setCurrentSource(Phonon::MediaSource('/home/video.mpg'));
  4. Phonon::AudioOutput* audioOutput=new Phonon::AudioOutput(parent);
  5. Phonon::createPath(player,audioOutput);
  6.  
  7. Phonon::VideoWidget* videoWidget=new Phonon::VideoWidget(parent);
  8. Phonon::createPath(player,videoWidget);
  9. player->play();


صورة توضيحية:



عناصر اخرى في phonon:

ال SeekSlider:
تقوم هذه الفئة الرسومية بعمل slider لملف ال media وتتحكم في ال seek postion.
مثال:

  1.  
  2. Phonon::MediaObject* player=new Phonon::MediaObject(parent);
  3. player->setCurrentSource(Phonon::MediaSource('/home/audio.mp3'));
  4. Phonon::AudioOutput* audioOutput=new Phonon::AudioOutput(parent);
  5. Phonon::createPath(player,audioOutput);
  6. Phonon::SeekSlider *slider = new Phonon::SeekSlider;
  7. slider->setMediaObject(player);
  8. slider->show();
  9. player->play();
  10.  


ال VolumeSlider:
ايضا تقوم هذه الفئة الرسومية بعمل slider لكن للتحكم في الصوت.
وبنفس المثال السابق ، فقط أضف:

  1.  
  2. Phonon::VolumeSlider *volumeSlider = new Phonon::VolumeSlider;
  3. volumeSlider->setAudioOutput(audioOutput);
  4. //...etc
  5. volumeSlider->show();
  6.  


ال Effect:
وهي الفئة المختصة بعمل تاثيرات على الصوت حيث يتم انشاء كائن منها ومن ثم ادخاله على ال Path الذي يمر فيه ال media stream.

مثال:
  1.  
  2. Phonon::Effect *effect =new Phonon::Effect(Phonon::BackendCapabilities::availableAudioEffects()[0], this);
  3. path.insertEffect(effect);
  4.  


وفيه تم تطبيق اول تأثير مدعوم من ال backend .
حيث ان الدالة availableAudioEffects تعيد لنا التأثيرات المدعومة من طرف محرك الصوت لديك backend ، ومن ثم تم ادخال التأثير على ال path الذي يمر فيه الصوت ، وتستطيع حذف التأثير المدخل عن طريق الدالة removeEffect

ال EffectWidget:
فئة رسومية للتحكم في معطيات التأثير.
مثال:
  1.  
  2. Phonon::EffectWidget *effectWidget = new Phonon::EffectWidget(effect);
  3. effectWidget->show();
  4.  


كتابة برنامج Media Player :
سنقوم بكتابة مشغل صوتيات بسيط ، ولن نضيف الكثير من الخيارات فقط تشغيل وايقاف الصوت حتى يكون الدرس بسيط.

ملف main.cpp واضح وهو فقط لاستدعاء الدالة show لكائن الفئة QPlayer
ملف qplayer.h ويحتوي على ال class defintion وتطبيقه واضح.
ملف qplayer.cpp :

دالة بناء الفئة:
  1.  
  2. QPlayer::QPlayer(QWidget* parent):
  3. QWidget(parent)
  4. {
  5. 	player = new Phonon::MediaObject(this);
  6. 	audioOutput = new Phonon::AudioOutput(Phonon::MusicCategory,this);
  7. 	videoWidget = new Phonon::VideoWidget(this);
  8. 	createPath(player,audioOutput);
  9. 	createPath(player,videoWidget);
  10.  
  11. 	player->setTickInterval(1000);
  12.  
  13. 	connect(player,SIGNAL(tick(qint64)),this,SLOT(tick(qint64)));
  14.  
  15. 	setupUi();
  16.  
  17. 	setWindowTitle(tr('QPlayer v0.1'));
  18. 	setWindowIcon(QIcon(':/images/qplayer.png'));
  19. }


وفيها تم انشاء العناصر السابقة ، ايضا تم وضع قيمة ال tick وهي ثانية واحدة وهذا يعني انه كل ثانية تمر وملف الصوت يعمل سيتم عمل emit للاشارة tick وهي ضرورية في حالة اردنا معرفة مقدار الوقت الذي مضى .

الدالة setupUi تقوم بانشاء الواجهة للبرنامج .
وبقية الدوال slot تطبيقها مباشر.

  1. void QPlayer::setupUi()
  2. {
  3. 	seekSlider = new Phonon::SeekSlider(player,this);
  4. 	volumeSlider = new Phonon::VolumeSlider(audioOutput,this);
  5.  
  6. 	QLabel* fileLable=new QLabel(tr('&File Name:'));
  7.  
  8. 	fileEdit=new QLineEdit;
  9.  
  10. 	fileLable->setBuddy(fileEdit);
  11.  
  12. 	lcdTimer = new QLCDNumber;
  13. 	lcdTimer->display('00:00');
  14.  
  15. 	QPushButton* browseButton=new QPushButton(tr('&Browse'));
  16. 	playButton=new QPushButton(tr('&Play'));
  17. 	QPushButton* pauseButton=new QPushButton(tr('P&ause'));
  18. 	QPushButton* stopButton=new QPushButton(tr('&Stop'));
  19.  
  20. 	playButton->setIcon(QIcon(':/images/play.png'));
  21. 	pauseButton->setIcon(QIcon(':/images/pause.png'));
  22. 	stopButton->setIcon(QIcon(':/images/stop.png'));
  23. 	browseButton->setIcon(QIcon(':/images/folder-music.png'));
  24.  
  25. 	playButton->setEnabled(false);
  26.  
  27. 	connect(browseButton,SIGNAL(clicked()),this,SLOT(browseClicked()));
  28. 	connect(playButton,SIGNAL(clicked()),this,SLOT(playClicked()));
  29. 	connect(pauseButton,SIGNAL(clicked()),this,SLOT(pauseClicked()));
  30. 	connect(stopButton,SIGNAL(clicked()),this,SLOT(stopClicked()));
  31.  
  32. 	connect(fileEdit,SIGNAL(textChanged(const QString&)),this,SLOT(checkFileName(const QString&)));
  33.  
  34.  
  35. 	QHBoxLayout* upperLayout=new QHBoxLayout;
  36. 	upperLayout->addWidget(fileLable);
  37. 	upperLayout->addWidget(fileEdit);
  38. 	upperLayout->addWidget(browseButton);
  39.  
  40. 	QHBoxLayout* midLayout=new QHBoxLayout;
  41. 	midLayout->addWidget(seekSlider);
  42. 	midLayout->addWidget(lcdTimer);
  43.  
  44. 	QHBoxLayout* lowerLayout=new QHBoxLayout;
  45. 	lowerLayout->addWidget(playButton);
  46. 	lowerLayout->addWidget(pauseButton);
  47. 	lowerLayout->addWidget(stopButton);
  48. 	lowerLayout->addWidget(volumeSlider);
  49.  
  50. 	QVBoxLayout* layout=new QVBoxLayout(this);
  51. 	layout->addLayout(upperLayout);
  52. 	layout->addWidget(videoWidget);
  53. 	layout->addLayout(midLayout);
  54. 	layout->addLayout(lowerLayout);
  55.  
  56. 	lcdTimer->setSizePolicy(QSizePolicy(QSizePolicy::Fixed,QSizePolicy::Fixed));
  57. 	seekSlider->setSizePolicy(QSizePolicy(QSizePolicy::Expanding,QSizePolicy::Fixed));
  58. 	volumeSlider->setSizePolicy(QSizePolicy(QSizePolicy::Expanding,QSizePolicy::Fixed));
  59. }
  60.  
  61. void QPlayer::tick(qint64 time)
  62. {
  63. 	QTime displayTime(0,(time/60000)%60,(time/1000)%60);
  64. 	lcdTimer->display(displayTime.toString('mm:ss'));
  65. }
  66.  
  67. void QPlayer::playClicked()
  68. {
  69. 	player->setCurrentSource(fileEdit->text());
  70. 	player->play();
  71. }
  72.  
  73.  
  74. void QPlayer::pauseClicked()
  75. {
  76. 	player->pause();
  77. }
  78.  
  79. void QPlayer::stopClicked()
  80. {
  81. 	player->stop();
  82. 	lcdTimer->display('00:00');
  83. }
  84.  
  85. void QPlayer::browseClicked()
  86. {
  87. 	QString fileName = QFileDialog::getOpenFileName(this);
  88.  
  89. 	if ( !fileName.isEmpty() )
  90. 		fileEdit->setText(fileName);
  91. }
  92.  
  93.  
  94. void QPlayer::checkFileName(const QString& str)
  95. {
  96. 	if( !str.isEmpty() )
  97. 	    playButton->setEnabled(true);
  98. 	 else
  99. playButton->setEnabled(false);
  100. }



حمل الملفات من المرفقات .

النتيجة :



اخيرا:
مشروع phonon ما زال تحت التطوير ويعمل فيه المساهمون 'ومن ضمنهم شركة qtsoftware' على تطويره وأضافة العديد من الخصائص الغير متوفرة حاليا ، لذلك اذا أردت كتابة تطبيقات متقدمة للصوت والفيديو فان phonon لن تفيدك في الوضع الحالي ويجب عليك ان تستخدم اي مكتبة خارجية مثل FMod.
ايضا النسخة الحالية من كيوت 4.5 لا تستخدم كل خصائص phonon المتوفرة الان ، نظرا لان المشروع في تطور مستمر ، ونسخة كيوت تم بنائها على نسخة مستقرة .


الى هنا ننتهي درسنا اليوم.
أي سؤال يرحب به.

الى اللقاء.


تمت طباعة الدرس من موقع مكتبة الدروس
http://qt-ar.org/lessons/show51.html