Qt: Vkontakte API और Phonon के साथ काम करना

लेख वास्तविक जीवन के उदाहरणों और एक विस्तृत विवरण में सॉफ्टवेयर इंटरफेस जैसे कि Vkontakte API और फ़ोनॉन के साथ Qt की बातचीत का वर्णन करता है।
लेख के अंत में, स्रोत कोड वाले रिपॉजिटरी का एक लिंक जिसे आप स्वतंत्र रूप से डाउनलोड और चला सकते हैं।

मैं तुरंत ध्यान देना चाहूंगा कि मैं गुरु नहीं हूं, और प्रोग्राम कोड हो सकता है, इसे बेहतर तरीके से लागू किया जाएगा। मैं आपके सुधारों, टिप्पणियों और आलोचनाओं को सहर्ष स्वीकार करूंगा।
जानकारी की नकल नहीं करने के लिए, मैं विकी से लिंक का संकेत दूंगा।
इसके अलावा, शायद, यह ध्यान दिया जाना चाहिए कि कार्यक्रम का परीक्षण और विकास ग्नू / लिनक्स / जेंटू (केडीई) मंच पर किया गया था और मैंने अन्य प्लेटफार्मों और वितरणों के तहत इसका परीक्षण नहीं किया, लेकिन यह काम करना चाहिए।

सामान्य एल्गोरिथ्म:

1. सामाजिक नेटवर्क में Vkontakte API (इसके बाद VK) के माध्यम से प्राधिकरण।
2. अपने पसंदीदा ऑडियो रिकॉर्डिंग की एक सूची प्राप्त करना।
3. फोनन के लिए परिणामी सूची से पटरियों की एक सूची बनाना।
4. चयनित गीत को डाउनलोड करने की क्षमता को लागू करना।

प्राधिकरण

प्रलेखन के अनुसार, प्राधिकरण के लिए एक घटक जोड़ना आवश्यक है जो हमें वेब ब्राउज़ करने की अनुमति देगा। Qt के पास इसके लिए WebKit है । घटक को पृष्ठ vkontakte.ru/login.php के साथ लोड किया जाना चाहिए जहां उपयोगकर्ता प्राधिकरण प्रक्रिया से गुजर सकता है। यदि प्राधिकरण सफल होता है, तो VK पृष्ठ /login_success.html पर रीडायरेक्ट करेगा और हमारे लिए आवश्यक डेटा जोड़ देगा, जैसे सत्र पहचानकर्ता, नमक और उपयोगकर्ता पहचानकर्ता, जिसे हमें लिंक से निकालने (पार्स) करने की आवश्यकता होगी।
हम प्रोजेक्ट के लिए आवश्यक मॉड्यूल कनेक्ट करते हैं:
QT += webkit \
network \
xml \
phonon
चूंकि VC, XML (या JSON) में डेटा लौटाता है, इसलिए हमें अपने जीवन को सरल बनाने और पहिए को फिर से मजबूत करने के लिए XML मॉड्यूल कनेक्ट करने की आवश्यकता है।
नेटवर्क मॉड्यूल आपको वीके से आवश्यक गीत डाउनलोड करने और आमतौर पर नेटवर्क के साथ काम करने की अनुमति देगा।

फोनन मॉड्यूल हमें स्थानीय या नेटवर्क से हमारे वीडियो को चलाने की अनुमति देगा। यह वीडियो फ़ाइलों को चलाने का भी समर्थन करता है। इस कार्यक्रम इंटरफ़ेस के साथ काम करना खुशी की बात है, लेकिन इसके बारे में थोड़ा बाद में।
वीके के साथ काम करने के लिए, मेरे पास कंस्ट्रक्टर में एक वीकेयूथ क्लास है जिसमें मैं अपना एप्लिकेशन पहचानकर्ता पास करता हूं। आप वीके में अपना आवेदन पंजीकृत करके प्राप्त कर सकते हैं।

1. #include <QApplication>
2. # अलग करें <QObject>
3. # चालू "मेनविंडो.एच"
4. "VKAuth.h"
6. int main ( int argc, char ** argv )
7. {
8. QApplication app ( argc, argv ) ;
10. QApplication :: setApplicationName ( "VKaudio" ) ;
11. QApplication :: setApplicationVersion ( "0.01a" ) ;
13. मेनविंडो विंडो ;
14. VKAuth vkAuth ( "2169954" ) ; // मेरी एप्लीकेशन आई.डी.
16. QObject :: कनेक्ट ( और vkAuth, SIGNAL ( असफल ) ))
17. & एप्लिकेशन, SLOT ( छोड़ें ) ( )
18. ) ;
19. QObject :: कनेक्ट ( और vkAuth, SIGNAL ( सफलता ( QStringList ) ) ,
20. विंडो, एसएलओटी ( स्लाॅटस असफल ( QStringList ) )
21. ) ;
22. vkAuth। शो ( ) ;
23. वापसी एप्लिकेशन। निष्पादन ( ) ;
24. }

प्राधिकरण के सफल होने पर वीकेयूथ क्लास एक सफलता संकेत भेजता है, और एक तर्क के रूप में यह गीतों के लिंक की एक सूची और एक असफल संकेत को पारित करता है यदि उपयोगकर्ता प्राधिकरण से इनकार करता है।
सफल प्राधिकरण का संकेत आवेदन की मुख्य विंडो (स्वयं खिलाड़ी) के स्लॉट से जुड़ा हुआ है जो स्थानांतरित सूची को ऑडियो रिकॉर्डिंग की सूची में जोड़ता है, इस प्रक्रिया को बाद में और अधिक विवरण में वर्णित किया जाएगा। प्रोग्राम शटडाउन स्लॉट (निकास) से कनेक्ट करने के लिए प्राधिकरण से एक उपयोगकर्ता इंकार संकेत।

1. VKAuth :: VKAuth ( QString ऐप, QWidget * माता-पिता ) : QWebView ( माता-पिता )
2. {
4. QObject :: कनेक्ट ( यह , SIGNAL ( urlChanged ( QUrl ) ))
5. स्लॉट ( स्लोटलिंकचेंज ( QUrl ) )
6. ) ;
7. m_app = app ;
8. loadLoginPage ( ) ;
9. }

जैसा कि मैंने ऊपर लिखा है, आवेदन पहचानकर्ता और पूर्वज वस्तु के लिए एक सूचक कंस्ट्रक्टर को पास किया जाता है। वर्ग QWebView से विरासत में मिला है जो वेबकीट के साथ काम करता है और हमें उपयोगकर्ता को आवश्यक वेब पेज प्रदर्शित करने की अनुमति देता है। QWebView में एक सिग्नल होता है जिसे हर बार एक पेज एड्रेस में बदलाव के लिए भेजा जाता है। चूंकि सफल प्राधिकरण के मामले में, वीके एक पुनर्निर्देशन (पते का परिवर्तन) करता है, यह संकेत हमें इस पल को पकड़ने के लिए बहुत उपयुक्त है। एक तर्क के रूप में, यह एक नया लिंक देता है, जिसे हम पार्स करेंगे।
LoadLoginPage () विधि प्राधिकरण के लिए आवश्यक पृष्ठ को लोड करने के लिए लागू होती है

1. शून्य VKAuth :: loadLoginPage ( ) {
2. QUAL url ( " vkontakte.ru/login.php" ) ;
4. यूआरएल। addQueryItem ( "ऐप" , m_app ) ;
5. यूआरएल। addQueryItem ( "लेआउट" , "पॉपअप" ) ;
6. यूआरएल। addQueryItem ( "प्रकार" , "ब्राउज़र" ) ;
7. यूआरएल। addQueryItem ( "सेटिंग्स" , "8" ) ;
9. लोड ( url ) ;
10. }

QUrl वर्ग बहुत सुविधाजनक लिंक के साथ काम करता है।
क्वार्क लिंक को भागों में तोड़ता है।



AddQueryItem विधि लिंक के लिए GET पैरामीटर जोड़ता है, जहां पहला तर्क पैरामीटर का नाम है और दूसरा इसका मान है।
पैरामीटर और संभावित मानों वाली तालिका:

हमें उपयोगकर्ता को उसकी ऑडियो रिकॉर्डिंग तक पहुंच की अनुमति देने के लिए हमें सेटिंग्स मान की आवश्यकता है।
हम उत्पन्न URL को QwebView :: लोड () क्लास विधि से पास करते हैं और यह प्राधिकरण के लिए पेज लोड करेगा।

मान लें कि उपयोगकर्ता अधिकृत है - वीके एक पुनर्निर्देशन करता है, एक सिग्नल को एक नए पते के साथ भेजा जाता है और नियंत्रण को स्लॉट स्लॉट में स्थानांतरित कर दिया जाता है, जो पता बदलने के लिए सिग्नल को संसाधित करने के लिए जिम्मेदार है।

1. शून्य VKAuth :: स्लॉटलिंकचार्जित
2. {
3. अगर ( "/api/login_success.html" == url। पथ ( ) ) {
4. QRegExp regexp ( " \" मध्य \ " : ([^,] +), \" गुप्त \ " : \" ([^,] +) \ " , \" सिड \ " : \" ([^,] + ) \ " " ) ;
5. स्ट्रस्ट्रिंग str = url। टुकड़ा ( ) ;
7. अगर ( - 1 ! = regexp। indexIn ( str ) ) {
9. m_mid = regexp। टोपी ( 1 ) ;
10. m_secret = regexp। टोपी ( 2 ) ;
11. m_sid = regexp। टोपी ( 3 ) ;
13. क्विक अनुरोध ( " api.vkontakte.ru/api.php?" ) ;
14. QString सिग ( getSig ( m_mid, m_secret, "api_id =" + m_app + "विधि = audio.get" + "uid =" + m_mid + "v = 3.0" ) ) ;
16. अनुरोध। addQueryItem ( "api_id" , m_app ) ;
17. अनुरोध। addQueryItem ( "विधि" , "ऑडियो.गेट" ) ;
18. अनुरोध। addQueryItem ( "uid" , m_mid ) ;
19. अनुरोध। addQueryItem ( "v" , "3.0" ) ;
20. अनुरोध। addQueryItem ( "sig" , sig ) ;
21. अनुरोध। addQueryItem ( "सिड" , m_sid ) ;
24. QNetworkAccessManager * प्रबंधक = नया QNetworkAccessManager ( यह ) ;
25. m_http = manager - > get ( QNetworkRequest ( request ) ) ;
26. QObject :: कनेक्ट ( m_http, SIGNAL ( समाप्त ( ) ) , यह , SLOT ( स्लॉटडोन ( ) ) ) ;
28. }
29. } और अगर ( "/api/login_failure.html" == url। पथ ( ) ) {
30. असफल होना ( ) ;
31. }
32. }
33. QByteArray VKAuth :: getSig ( QString मध्य, QString रहस्य, QString params = "" ) {
34. QString str ;
36. str। परिशिष्ट ( मध्य ) ;
37. अगर ( params है। Ismpty ( ) )
38. str। append ( परम ) ;
39. str। एपेंड ( गुप्त ) ;
41. वापसी QCryptographicHash :: हैश ( str .Utf8 ( ) , QCryptographicHash :: Md5 ) । हेक्स ( ) ;
42. }

जिस स्लॉट में हम जाँच करते हैं कि हम कहाँ तक अनुप्रेषित थे, अगर redirection login_success.html पर था तो प्राधिकरण सफल था ( प्रलेखन के अनुसार)।
हम एक नियमित अभिव्यक्ति बनाते हैं जो वीके के साथ आगे के काम के लिए आवश्यक डेटा प्राप्त करने में हमारी मदद करेगी, अर्थात्:
मध्य, रहस्य, किनारा।

ऑडियो रिकॉर्डिंग की सूची प्राप्त करने के लिए, हमें ऑडियो.गेट विधि को कॉल करना होगा ।
Qhttp वर्ग उच्च-स्तरीय HTTP प्रोटोकॉल के साथ काम करना सरल करता है ।
हम आवश्यक मापदंडों को GET मापदंडों के रूप में पास करते हैं और एक हैश (विधि - getSig) बनाते हैं।
Qhttp :: किया गया संकेत, जो अनुरोध पूरा होने पर (प्रतिक्रिया प्राप्त करने पर) भेजा जाता है, स्लॉट स्लॉट से जुड़ा होता है।

1. शून्य VKAuth :: स्लॉटडोन ( बूल त्रुटि ) {
2. अगर ( त्रुटि )
3. असफल होना ( ) ;
4. और {
5. QStringList सूची ; // एमपी 3 के साथ सूची
7. QDomDocument डोम ;
8. डोम। setContent ( m_http - > readAll ( ) ) ;
9. QDomElement root = डोम। फर्स्टचाइल्डमेंट ( ) ; // <प्रतिक्रिया> जड़ तत्व
10. QDomNode AudioElement = रूट। फर्स्टचाइल्डमेंट ( ) ; // <ऑडियो>
12. जबकि ( ऑडियो-क्लीयरेंस .Null ( ) ) {
13. QString url = AudioElement
14. । प्रवेश ( )
15. । एलिमेंट्सबिजनाम ( "url" )
16. । आइटम ( 0 )
17. । प्रवेश ( ) // <url>
18. । पाठ ( ) ;
19. सूची। append ( url ) ;
20. AudioElement = AudioElement। अगलासिबलिंग ( ) ; // अगला तत्व
21. }
22. सफलता ( सूची ) का उत्सर्जन ; // प्लेलिस्ट के साथ लोड प्लेयर विंडो
23. छिपाना ( ) ; // इस विंडो को छिपाएं
24. }
26. m_http - > close ( ) ;
27. }

स्लॉट VKAuth :: स्लॉटडोन प्राप्त XML को पढ़ता है और एमपी 3 गाने के लिंक की एक सूची बनाता है और फिर उसी सूची के साथ एक सफलता संकेत भेजता है, कनेक्शन को बंद करता है और विंडो को छुपाता है। प्राधिकरण ने प्राप्त गीतों की सूची पारित की।

phonon

फ़ोनॉन का उपयोग करना बहुत सरल है, आपको एक मेटा ऑब्जेक्ट (MediaObject क्लास) बनाने की ज़रूरत है, ऑडियो (और / या वीडियो) आउटपुट बनाएँ और उन्हें फ़ोनन :: createPath के माध्यम से संयोजित करें।
MainWindow :: appendToList () विधि में, हम परिणामस्वरूप सूची को एमपी 3 फाइलों में सूची में जोड़ते हैं।

1. शून्य MainWindow :: appendToList ( ) {
2. अगर ( VKAudioList। isEmpty ( ) )
3. वापसी;
5. int index = स्रोत। आकार ( ) ;
6. foreach ( QString स्ट्रिंग, VKAudioList ) {
7. फोनन :: मीडिया स्रोत ( स्ट्रिंग ) ;
9. सूत्रों का कहना है। परिशिष्ट ( स्रोत ) ;
10. }
11. यदि ( स्रोत। ismmpty ( ) )
12. metaInformationResolver - > setCurrentSource ( स्रोत। at ( index ) ) ;
13. }

चयनित गीत डाउनलोड करें

एक गीत डाउनलोड करने के लिए, आपको इसे चुनने की आवश्यकता है और प्रोग्राम विंडो के शीर्ष पर डाउनलोड पर क्लिक करें, एक संवाद दिखाई देगा जिसमें आपको फ़ाइल डाउनलोड करने के लिए एक स्थान चुनना होगा, स्वाभाविक रूप से आपको फ़ाइल बनाने (लिखने) की अनुमति होनी चाहिए।
बटन क्लिक सिग्नल MainWindow :: slotDownload () स्लॉट से जुड़ा है।

1. शून्य मेनवूड :: स्लॉटडाउनलोड ( ) {
2. पथ पथ = QFileDialog :: getExistingDirectory ( यह , "सेव टू ..." ) ;
4. अगर ( पथ। isEmpty ( ) ) {
5. m_file = new QFile ;
6. int आइटम = musicTable - > currentRow ( ) ;
7. फ़ोनन :: MediaSource src = स्रोत। at ( आइटम ) ;
8. m_pSrcUrl = new QUrl ( src। url ( ) ) ;
9. m_file - > setFileName ( पथ + "/" + MusicTable - > आइटम ( आइटम, musicTable - > currentColumn ( ) ) - > पाठ ( ) + ".mp3" ) ;
11. अगर ( m_file - > खुला ( QIODevice :: ReadWrite ) ) {
12. m_pTcpSocket = नया QTcpSocket ( यह ) ;
14. m_pTcpSocket - > connectToHost ( m_pSrcUrl - > होस्ट ( ) , 80 , QIODevice :: ReadWrite ) ;
15. कनेक्ट ( m_pTcpSocket, SIGNAL ( कनेक्टेड ) ) , यह , SLOT ( स्लॉट कनेक्टेड ( ) ) ) ;
16. कनेक्ट ( m_pTcpSocket, SIGNAL ( ReadyRead ( ) ) , यह , SLOT ( slotReadyRead ( ) ) ) ;
17. कनेक्ट ( m_pTcpSocket, SIGNAL ( त्रुटि ( QAbstractSocket :: SocketError ) ) ,
18. यह , SLOT ( स्लॉटडाउनलोडर ( QAbstractSocket :: SocketError ) )
19. ) ;
20. कनेक्ट ( m_pTcpSocket, SIGNAL ( डिस्कनेक्ट ) ( ) ) , यह , SLOT ( स्लॉटडिसकनेक्टेड ( ) ) ) ;
21. } और
22. QMessageBox :: चेतावनी ( यह , "चेतावनी" , "फ़ाइल खोलें Err!" ) ;
23. }
25. }

एक निर्देशिका चुनने और सफलतापूर्वक एक गीत की एक फ़ाइल खोलने (बनाने) के बाद, जिसे अभी तक डाउनलोड नहीं किया गया है, आपको वीके सर्वर को एक अनुरोध भेजने की आवश्यकता है ताकि यह हमें "गीत" दे सके। यह हमें QtcpSocket की मदद करता है जो टीसीपी / आईपी के साथ कार्य को कार्यान्वित और सरल करता है। VK सर्वर से सफलतापूर्वक कनेक्ट होने के बाद, हम उसे HTTP अनुरोध भेजते हैं:

1. शून्य मेनवूड :: स्लॉट कनेक्ट ( ) {
2. m_pTcpSocket - > लिखना ( QString ( "GET" + m_pSrcUrl - > पाथ ( ) + " \ r \ n " )) .Ascicii ( ) ) ;
3. }

जिसके लिए वह हमें गीत की सामग्री देता है, जिसे हमें फ़ाइल में लिखना होता है:

1. शून्य मेनवॉइड :: स्लॉटरैरी रीड ( ) {
2. m_file - > लिखना ( m_pTcpSocket - > read ( m_pTcpSocket - > bytesAvailable ( ) ) ) ;
3. }

वीके गीत की सभी सामग्री देने के बाद, यह कनेक्शन को बंद कर देता है, और हमें बस फ़ाइल को बंद करना होगा।

1. शून्य मेनवॉन्ड :: स्लॉटडिसकनेक्टेड ( ) {
2. m_file - > करीब ( ) ;
3. m_pTcpSocket - > करीब ( ) ;
4. }

जैसा कि वादा किया गया है, लेख की शुरुआत में, रिपॉजिटरी ( मर्क्यूरियल ) का लिंक: https://bitbucket.org/denis_medved/vkaudio
मैक्स शेली और bhv को अद्भुत पुस्तक "Qt 4.5: प्रोफेशनल C ++ प्रोग्रामिंग" और निश्चित रूप से पूरे खुले समुदाय के लिए बहुत धन्यवाद।

अद्यतन :
अप्रचलित QHttp और QTcpSocket के बजाय, QNetworkAccessManager का उपयोग किया जाता है।