🙌 🗓️ 🕵🏻 Vreen vk.api के साथ काम करने के लिए एक सरल और सुविधाजनक पुस्तकालय है 🤲🏽 🌽 👾

मैं आपके लिए vk api के साथ काम करने के लिए एक नया Qt पुस्तकालय प्रस्तुत करता हूं, जो कि किसी भी डेस्कटॉप और मोबाइल एप्लिकेशन को बनाते समय आपके लिए उपयोगी हो सकता है जो vk के साथ इंटरैक्ट करता है। यह परियोजना qutIM के लिए vkontakte प्लगइन से पैदा हुई थी और एक अलग स्वतंत्र पुस्तकालय में विकसित हुई, जिसे अब हर कोई उपयोग कर सकता है।

संक्षिप्त समीक्षा

Vreen, vk.com api के ऊपर एक आवरण है, जिसे C ++ 11 / Qt में लिखा गया है, जो मोबाइल और डेस्कटॉप अनुप्रयोगों को जल्दी और आसानी से बनाने के लिए डिज़ाइन किया गया है, साथ ही मौजूदा अनुप्रयोगों में vk.com एपीआई के साथ सहभागिता भी करता है। पुस्तकालय कई प्राधिकरण तरीकों का समर्थन करता है और यदि आवश्यक हो तो आपको अपना खुद का जोड़ने की अनुमति देता है। इसके अलावा vreen में qml के लिए एक पूर्ण बाइंडिंग है, जो आपको C ++ में एक भी लाइन लिखे बिना एप्लिकेशन बनाने की अनुमति देता है। आवश्यक निर्भरता की संख्या को कम करने के लिए, सभी प्राधिकरण विधियों को स्थिर पुस्तकालयों को अलग करने के लिए ले जाया जाता है।

मुख्य विशेषताएं:

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

मूल बातें:

एपीआई के साथ काम करने के लिए आधार कक्षाएं:

कनेक्शन एक QNetworkAccessManager- आधारित वर्ग है जो प्राधिकरण करता है और सीधे API अनुरोधों को लागू करता है।
जवाब - वर्ग अनुरोध के निष्पादन की निगरानी करता है।
लॉन्गपोल - एक वर्ग जो घटनाओं के लिए सर्वर को प्रदूषित करता है।
रोस्टर एक मित्र सूची प्रबंधन वर्ग है।
क्लाइंट एक बेस क्लास है जो सब कुछ एक साथ सिलाई करता है।

एपीआई अनुरोध करना:
एक साधारण अनुरोध:

QVariantMap args; args.insert("uids", join(ids)); args.insert("fields", fields.join(",")); auto reply = d->client->request("users.get", args); reply->connect(reply, SIGNAL(resultReady(const QVariant&)), this, SLOT(_q_friends_received(const QVariant&)));

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

  QVariantMap args; //TODO add chat messages support and contact check args.insert("uid", message.toId()); args.insert("message", message.body()); args.insert("title", message.subject()); return request ("messages.send", args, [](const QVariant &response) -> QVariant { return response.toInt(); });

दिए गए मान के प्रकार को स्पष्ट रूप से इंगित करने के लिए, आप निम्नलिखित टेम्प्लेट जादू को लागू कर सकते हैं:

  typedef ReplyBase<int> SendMessageReply; QVariantMap args; //TODO add chat messages support and contact check args.insert("uid", message.toId()); args.insert("message", message.body()); args.insert("title", message.subject()); return request<SendMessageReply> ("messages.send", args, [](const QVariant &response) -> QVariant { return response.toInt(); });

परिणामस्वरूप, SendMessageReply :: result () स्लॉट में, यह QVariant के बजाय int वापस आ जाएगा।

  auto reply = static_cast<Vreen::SendMessageReply*>(sender()); m_unreachedMessagesCount--; int mid = reply->result();

सामान्य तौर पर, एपीआई के साथ सभी इंटरैक्शन सरल और पारदर्शी होते हैं।

सभा और सभा

Vreen सबमॉड्यूल का उपयोग करता है और इसलिए स्रोत प्राप्त करने का सबसे अच्छा तरीका है।

 $ git clone git://github.com/gorthauer/vreen.git $ cd vreen $ git submodule update --init

निर्माण करने के लिए, आपको cmake 2.8, Qt 4.7.4, और C ++ 11 (gcc 4.4+, clang 3.0+, msvc2010 +) के लिए बुनियादी समर्थन के साथ किसी भी संकलक की आवश्यकता है।
विधानसभा अपने आप में काफी तुच्छ है:

 $ mkdir build $ cd build $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr $ make $ make install (sudo)

यदि आपके पास रिलीज़ या रिलीज़ संस्करण बनाने के बारे में प्रश्न हैं, तो यह केवल सबसे अच्छा है कि सीमेक प्रलेखन देखें। एक प्रयोगात्मक विकल्प के रूप में, क्यूब्स का उपयोग करके विधानसभा का समर्थन किया जाता है। क्यूमेक 'का उपयोग करके एक पुस्तकालय का निर्माण संभव है, लेकिन यह विधि आधिकारिक तौर पर समर्थित नहीं है।

C ++ प्रोजेक्ट में उपयोग करें

संबंध

Vreen में अन्य परियोजनाओं से कनेक्ट करने के लिए, pkg-config का उपयोग किया जाता है, इसलिए, vreen को एक ब्राउज़र के माध्यम से मानक प्राधिकरण विधि से जोड़ने के लिए, बस प्रो फ़ाइल में लाइनें जोड़ें।

 CONFIG += link_pkgconfig PKGCONFIG += vreen \ vreenoauth

उन प्रणालियों के लिए जो pkgconfig का समर्थन नहीं करते हैं, आप या तो मैन्युअल रूप से LIBS और INCLUDEPATH जोड़ सकते हैं या cmake या qbs के लिए खोज स्क्रिप्ट लिख सकते हैं।
जो लोग मुझे क्यूटी के लिए एक prf फ़ाइल लिखने में मदद कर सकते हैं।

के उपयोग

चलो एक उदाहरण के रूप में लेते हैं एक छोटा सा कंसोल एप्लिकेशन जो दोस्तों की सूची से सभी फोन नंबर खींच लेगा।

आरंभ करने के लिए, बस क्लाइंट को इनिशियलाइज़ करें, कनेक्शन विधि, एप्लिकेशन आइडेंटिफ़ायर का संकेत देते हुए, और उसे ऐप से ऐप तक पहुंचने की अनुमति के साथ एक विंडो बनाने के लिए भी कहें।

  auto auth = new Vreen::OAuthConnection(3220807, this); //  clientId   auth->setConnectionOption(Vreen::Connection::ShowAuthDialog, true); //     . auth->setConnectionOption(Vreen::Connection::KeepAuthData, true); //     setConnection(auth); connect(this, SIGNAL(onlineStateChanged(bool)), SLOT(onOnlineChanged(bool))); connect(roster(), SIGNAL(syncFinished(bool)), SLOT(onSynced(bool)));

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

  roster()->sync(QStringList() << QLatin1String("first_name") << QLatin1String("last_name") << QLatin1String("contacts"));

रोस्टर सिंक्रनाइज़ेशन को सफलतापूर्वक पूरा करने के बाद, हम बस परिणाम प्रदर्शित करते हैं:

  qDebug() << tr("-- %1 contacts recieved").arg(roster()->buddies().count()); foreach (auto buddy, roster()->buddies()) { QString homeNumber = buddy->property("_q_home_phone").toString(); QString mobileNumber = buddy->property("_q_mobile_phone").toString(); qDebug() << tr("name: %1, home: %2, mobile: %3").arg(buddy->name()) .arg(homeNumber.isEmpty() ? tr("unknown") : homeNumber) .arg(mobileNumber.isEmpty() ? tr("unknown") : mobileNumber); }

संपर्कों के लिए नियमित रूप से अभी तक लागू नहीं किए गए सभी गुणों में उपसर्ग _q_ होगा, जबकि बाकी को गेटर्स के माध्यम से या Q_PROPERTY में निर्दिष्ट नामों के माध्यम से प्राप्त किया जा सकता है।

दूसरे उदाहरण के रूप में, qml api का उपयोग करके देखें और मित्रों की सूची प्राप्त करें।
Qml में आयात Vreen समर्थन:

 import com.vk.api 1.0

और एक ग्राहक बनाएँ:

  Client { id: client connection: conn //        C++   } OAuthConnection { id: conn Component.onCompleted: { //        ,      photoview' setConnectionOption(Connection.ShowAuthDialog, true); setConnectionOption(Connection.KeepAuthData, true); } clientId: 3220807 displayType: OAuthConnection.Popup //        }

हम क्लाइंट.connectToHost के माध्यम से बस कनेक्ट करेंगे, जो दिखाई देने वाली पुष्टि विंडो में, आप अपना लॉगिन और पासवर्ड दर्ज करने में सक्षम होंगे, इसलिए आप इनपुट के लिए अलग फ़ील्ड नहीं बना सकते हैं, लेकिन अपने आप को एक अत्यंत संक्षिप्त संकेत तक सीमित कर सकते हैं।

संवादों की सूची प्रदर्शित करने के लिए, आप com.vk.api 1.0 से तैयार मॉडल का उपयोग कर सकते हैं:

  DialogsModel { id: dialogsModel client: client }

हाल के संवादों की सूची प्राप्त करने के लिए, बस कनेक्ट करने के बाद, एक सूची का अनुरोध करें:

  Connections { target: client onOnlineChanged: { if (client.online) { client.roster.sync(); dialogsModel.getDialogs(0, //    15, //  160 //   ); } } }

प्रतिनिधि को उपलब्ध मॉडल गुण इसके कार्यान्वयन के लिए कोड में देखे जा सकते हैं:

  roles[SubjectRole] = "subject"; roles[BodyRole] = "body"; roles[FromRole] = "from"; roles[ToRole] = "to"; roles[ReadStateRole] = "unread"; roles[DirectionRole] = "incoming"; roles[DateRole] = "date"; roles[IdRole] = "mid"; roles[AttachmentRole] = "attachments"; roles[ChatIdRole] = "chatId";

इन क्षेत्रों का उपयोग करके, आप संवादों की पूरी तरह से साफ-सुथरी दिखने वाली सूची प्राप्त कर सकते हैं:

इसी तरह, एक फोटो एल्बम बनाएं:

और मैं यह नोट करना चाहता हूं कि एक फोटो एल्बम बनाने के मामले में, हम qml के माध्यम से सीधे vk.api के साथ काम करते हैं

  function getAll(ownerId, count, offset) { if (!offset) offset = 0; if (!count) count = 200; var args = { "owner_id" : ownerId, "offset" : offset, "count" : count, "extended" : 0 } var reply = client.request("photos.getAll", args) reply.resultReady.connect(function(response) { var count = response.shift() for (var index in response) { var photo = response[index] model.append(photo) } }) }

यह बहुत संक्षिप्त और संक्षिप्त रूप से निकलता है।

निष्कर्ष

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

Vreen vk.api के साथ काम करने के लिए एक सरल और सुविधाजनक पुस्तकालय है