Vkontakte ने Android के लिए SDK पेश किया

डेवलपर्स के लिए अनुभाग में दूसरे दिन VKontakte ने एंड्रॉइड के लिए एसडीके पोस्ट किया।

लोकप्रिय सामाजिक नेटवर्क VKontakte ने विकासशील अनुप्रयोगों के लिए टूलकिट्स के अपने सेट को फिर से भर दिया है, जिसमें पहले से ही फ्लैश और जावास्क्रिप्ट एसडीके हैं, साथ ही आईओएस के लिए एसडीके, और एंड्रॉइड के लिए एक और एसडीके है।

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

लोग बोर्ड पर Android के अप्रासंगिक संस्करणों के साथ उपकरणों के मालिकों के बारे में नहीं भूल गए - एसडीके के साथ आने वाले परीक्षण आवेदन में एंड्रॉइड 2.2+ की आवश्यकताएं हैं

साथ ही, संरक्षण के मुद्दे को भी नजरअंदाज नहीं किया गया है।
कट के तहत विवरण।

कहाँ से लाऊँ?

VK Android SDK GitHub पर डाउनलोड के लिए उपलब्ध है ।

कैसे जुड़ें?

परियोजना को एस.डी.के.

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

यदि आप एंड्रॉइड स्टूडियो में ग्रैडल का उपयोग नहीं कर रहे हैं, तो आपको प्लग-इन को "मुख्य" से "vksdk" में बदलना होगा।

मेनिफेस्ट में, आपको गतिविधि com.vk.sdk.VKOpenAuthActivity रजिस्टर करनी होगी।

वीके पर परियोजना

डेवलपर्स ने एक सुरक्षा प्रणाली बनाई है, जिसके कारण कोई अन्य एप्लिकेशन आपका प्रतिरूपण नहीं कर पाएगा।

• सबसे पहले, स्टैंडअलोन एप्लिकेशन बनाने के बाद, आपको इसकी सेटिंग्स में पैकेज का नाम निर्दिष्ट करना होगा।
• दूसरे, आपको सेटिंग्स में अपने आवेदन की मुख्य गतिविधि का नाम बताना होगा।
• तीसरा, (यह सबसे महत्वपूर्ण है), आपको कॉलों को हटाने के बाद, अपने आवेदन की कुंजी के फिंगरप्रिंट को निर्दिष्ट करना होगा। उदाहरण के लिए, डिबग और रिलीज़ कई हैं। Keytool उपयोगिता ने मुझे तीन उंगलियों के निशान दिए - MD5, SHA1 और SHA256। VKontakte SHA1 में रुचि रखता है।

कैसे करें इस्तेमाल?

प्राधिकरण

आवेदन शुरू करते समय, आपको एसडीके को इनिशियलाइज़ करना होगा:
VKSdk.initialize(VKSdkListener listener, String appId, VKAccessToken token);

प्राधिकरण निम्नलिखित तरीकों में से एक में अनुशंसित है:
VKSdk.authorize(String... scope);
VKSdk.authorize(String[] scope, boolean revoke, boolean forceOAuth);
डिफ़ॉल्ट रूप से, प्राधिकरण VKontakte क्लाइंट के माध्यम से होता है। यदि यह उपयोगकर्ता के डिवाइस या फ़ोर्सऑथ == सच पर स्थापित नहीं है, तो प्राधिकरण पेज एक अलग गतिविधि में खुलता है।

चूंकि लाइब्रेरी में इंटरफ़ेस तत्व शामिल हैं, इसलिए इसे मॉनिटर करने की आवश्यकता है कि डिस्प्ले पर क्या हो रहा है। इसके लिए, VKUIHelper क्लास का उपयोग किया जाता है। इसलिए, सभी गतिविधि में, आपको इस तरह से तरीकों को ओवरराइड करने की आवश्यकता है:

 @Override protected void onResume() { super.onResume(); VKUIHelper.onResume(this); } @Override protected void onDestroy() { super.onDestroy(); VKUIHelper.onDestroy(this); } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { VKUIHelper.onActivityResult(requestCode, resultCode, data); } 

गतिविधि उदाहरण:

 public class LoginActivity extends Activity { private static String sTokenKey = "VK_ACCESS_TOKEN"; private static String[] sMyScope = new String[]{VKScope.FRIENDS, VKScope.WALL, VKScope.PHOTOS, VKScope.NOHTTPS}; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); VKSdk.initialize(sdkListener, "id_", VKAccessToken.tokenFromSharedPreferences(this, sTokenKey)); setContentView(R.layout.activity_login); VKSdk.authorize(sMyScope, true, false); } @Override protected void onResume() { super.onResume(); VKUIHelper.onResume(this); } @Override protected void onDestroy() { super.onDestroy(); VKUIHelper.onDestroy(this); } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { VKUIHelper.onActivityResult(requestCode, resultCode, data); } private VKSdkListener sdkListener = new VKSdkListener() { @Override public void onCaptchaError(VKError captchaError) { new VKCaptchaDialog(captchaError).show(); } @Override public void onTokenExpired(VKAccessToken expiredToken) { VKSdk.authorize(sMyScope); } @Override public void onAccessDenied(VKError authorizationError) { new AlertDialog.Builder(LoginActivity.this) .setMessage(authorizationError.errorMessage) .show(); } @Override public void onReceiveNewToken(VKAccessToken newToken) { newToken.saveTokenToSharedPreferences(LoginActivity.this, sTokenKey); Intent i = new Intent(LoginActivity.this, MainActivity.class); startActivity(i); } @Override public void onAcceptUserToken(VKAccessToken token) { Intent i = new Intent(LoginActivity.this, MainActivity.class); startActivity(i); } }; } 

क्वेरी का निष्पादन

आप SDK में उपलब्ध मॉडल का उपयोग करके अनुरोध कर सकते हैं:
VKRequest request = VKApi.users().get();
या सीधे निर्दिष्ट विधि का नाम निर्दिष्ट करें:
VKRequest request = new VKRequest("status.get");
मापदंडों के साथ एक ही बात:
VKRequest request = VKApi.users().get(VKParameters.from(VKApiConst.USER_IDS, "1,2"));
VKRequest request = new VKRequest("friends.get", VKParameters.from(VKApiConst.FIELDS, "sex,bdate,city"));

फ़ोटो डाउनलोड करने के लिए विशेष प्रकार के अनुरोध हैं - एक एल्बम पर अपलोड करने के लिए VKUploadAlbumPhotoRequest और एक दीवार पर अपलोड करने के लिए VKUploadWallPhotoRequest। दोनों के दो निर्माता हैं:

 VKRequest request = VKApi.uploadWallPhotoRequest(VKUploadImage image, int user_id, int group_id); VKRequest request = VKApi.uploadAlbumPhotoRequest(VKUploadImage image, int album_id, int group_id); VKRequest request = VKApi.uploadWallPhotoRequest(File image, int user_id, int group_id); VKRequest request = VKApi.uploadAlbumPhotoRequest(File image, int album_id, int group_id); 

अपनी दीवार या समूह की दीवार पर एक फोटो अपलोड करते समय user_id == 0, अन्यथा - उस उपयोगकर्ता की आईडी जिसकी दीवार पर हम फोटो अपलोड करने के लिए बकवास करते हैं।
समूह Group_id == लक्ष्य समूह की आईडी की दीवार / एल्बम में फ़ोटो अपलोड करते समय, अन्यथा group_id == 0 (उदाहरण के लिए, आपके एल्बम पर फ़ोटो अपलोड करना)।
Album_id में, क्रमशः, फोटो एल्बम का पहचानकर्ता।

VKUploadImage ऑब्जेक्ट के रूप में, बिटमैप ऑब्जेक्ट और VKImageParameters ऑब्जेक्ट के रूप में अपनी छवि प्रकार (png, jpg) और गुणवत्ता मान (jpg के लिए) को उसके निर्माता के रूप में स्थानांतरित करना आवश्यक है।

ऑडियो रिकॉर्डिंग, वीडियो और दस्तावेजों के एनालॉग्स अभी तक लागू नहीं किए गए हैं, लेकिन मुझे इसे करने में कोई समस्या नहीं है। :-)

अनुरोध निष्पादित करने से पहले, आप इसके कुछ मापदंडों को बदल सकते हैं:

 //    .      API Error   . //  : 1.  0  infinity. request.attempts = 0; //    (HTTPS). //  false       scope (nohttps). //  : true. request.secure = false; //    ( ). //    false      -    . //  : true. useSystemLanguage = false; //  false        ,   SDK. //  : true. request.parseModel = false; 

यह अनुरोध request.executeWithListener(VKRequestListener listener); विधि request.executeWithListener(VKRequestListener listener); द्वारा निष्पादित किया जाता है request.executeWithListener(VKRequestListener listener);
सर्वर रिस्पांस (VKResponse) श्रोता में आता है।
अनुरोध अनुरोध उदाहरण:

 request.executeWithListener(new VKRequestListener() { @Override public void onComplete(VKResponse response) { //    response. } @Override public void onError(VKError error) { // .    error. } @Override public void attemptFailed(VKRequest request, int attemptNumber, int totalAttempts) { //  .         . } }); 

आप एक बैच में कई क्वेरी चला सकते हैं। ऐसा करने के लिए, एक बहु-अनुरोध बनाएँ, ताकि बोलने के लिए:
VKBatchRequest batch_req = new VKBatchRequest(VKRequest... requests);
जैसा कि आप देख सकते हैं, एक पैकेज में किसी भी संख्या में अनुरोध हो सकते हैं।
एक बहु-क्वेरी को एक एकल के साथ-साथ एक दूसरे श्रोता के साथ निष्पादित किया जाता है:

 batch_req.executeWithListener(new VKBatchRequestListener() { @Override public void onComplete(VKResponse[] responses) { //   responses (    ,     ) } @Override public void onError(VKError error) { // .    error. } }); 

प्रतिक्रिया प्रसंस्करण

यदि प्रतिक्रिया ऐसी वस्तु की अपेक्षा करती है जिसका जावा प्रतिनिधित्व अभी तक SDK मॉडल में नहीं है, तो यह parseModel = false; सेट करने के लिए समझ में आता है parseModel = false; और प्राप्त JSON को स्वतंत्र रूप से संसाधित करें। अन्यथा, परिणामी वस्तु को आवश्यक प्रकार से डालना पर्याप्त है।

निष्कर्ष

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

एंड्रॉइड एसडीके के लिए आधिकारिक दस्तावेज यहां पाया जा सकता है ।

आपका ध्यान देने के लिए धन्यवाद।