🔢 🐭 🏂🏽 मोबाइल एसडी-टू-प्ले गेम्स में फेसबुक एसडीके (आईओएस) का एकीकरण ✍🏿 🚫 🧑🏻

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

एक सामान्य मोबाइल फ्री-टू-प्ले गेम में, फेसबुक एकीकरण निम्नलिखित सुविधाएँ प्रदान करता है:

फेसबुक पर उपयोगकर्ता खाते के माध्यम से प्राधिकरण की संभावना। इस तरह का प्राधिकरण अच्छा है कि हम खेल उपयोगकर्ता के लिए उसकी ओर से न्यूनतम प्रयास के साथ एक विशिष्ट पहचानकर्ता बनाएँ। खिलाड़ी को लॉगिन का आविष्कार करने, ईमेल पता दर्ज करने आदि की आवश्यकता नहीं है। आखिरकार, हम एक मोबाइल एप्लिकेशन के बारे में बात कर रहे हैं, जहां लगातार पाठ डेटा दर्ज करना कुछ थकाऊ है। यह अच्छी तरह से मान्यता प्राप्त लोगो "एफ" के साथ एक बार एक बटन दबाने के लिए पर्याप्त है। डेवलपर्स के लिए फायदे हैं - खिलाड़ी की प्रगति को विभिन्न प्लेटफार्मों पर विभिन्न उपकरणों के बीच सिंक्रनाइज़ किया जा सकता है, मुख्य बात यह है कि फेसबुक इन प्लेटफार्मों पर है।
दोस्तों को अनुरोध (ऐप अनुरोध) भेजने की क्षमता। अनुरोध वे संदेश हैं जो खिलाड़ी के फेसबुक पेज (और फेसबुक एप्लिकेशन में) पर दिखाई देते हैं और इसमें गेम से संबंधित जानकारी होती है। विशिष्ट अनुरोधों में दोस्तों से खेल के लिए निमंत्रण, "मुझे भेजने / मुझे कुछ देने" जैसे अनुरोध शामिल हैं या "मुझे स्तर पास करने में मदद करें"। अंत में, किसी व्यक्ति को इस पर क्लिक करने और गेम (या ऐप स्टोर में गेम पेज) पर जाने के लिए केवल एक अनुरोध की आवश्यकता होती है। अनुरोधों का उपयोग करना नए खिलाड़ियों को आकर्षित करने और पुराने खिलाड़ियों को मुफ्त में गेम में वापस लाने के लिए एक शक्तिशाली तंत्र है।
एक समय में पोस्ट भेजने की क्षमता। यह पोस्टिंग आपको गेम को किसी को भी रिपोर्ट करने की अनुमति देता है जो समयरेखा को पढ़ता है। खेल आमतौर पर खिलाड़ी की उपलब्धियों के बारे में जानकारी रखते हैं, जो एक प्रतिस्पर्धी घटक जोड़ता है।
अपने फेसबुक अकाउंट से खिलाड़ी के बारे में जानकारी प्राप्त करने की क्षमता। सबसे अधिक बार, ऐसी जानकारी में खिलाड़ी का नाम, उसका अवतार और, संभवतः, उसके दोस्तों के अवतार शामिल हैं। स्पॉइलर के तहत एक वास्तविक जीवन में फ्री-टू-प्ले गेम में अवतार का उपयोग करने का एक उदाहरण।
अवतार के साथ खेल

फेसबुक के एकीकरण को आसान बनाने के लिए, हमने एक डेमो एप्लिकेशन बनाया है जो क्लाइंट की तरफ से आपकी जरूरत की लगभग सभी चीजों को लागू करता है।

डेमो ऐप

Objective-C में आवेषण के साथ डेमो एप्लिकेशन C ++ (हमारे अधिकांश फ्री-टू-प्ले गेम्स की तरह) में लिखा गया है और Cocos2d-x इंजन पर सबसे सरल अनुप्रयोग है (आप इसे यहां डाउनलोड कर सकते हैं )। एक आयत स्क्रीन के चारों ओर घूमती है और इन सीमाओं तक पहुँचने पर स्क्रीन की सीमाओं से परिलक्षित होती है।

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

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

तकनीकी कार्यान्वयन विवरण

पहुँच अधिकार

पहली बात जब आप एक क्लाइंट पर फेसबुक को एकीकृत करते हैं, तो एक सत्र की अनुमति के लिए एक सत्र बनाया जाता है, जिसमें फेसबुक विभिन्न विकल्प प्रदान करता है। आवेग को रोकना महत्वपूर्ण है और एक ही बार में सब कुछ तक पहुंच अधिकार का अनुरोध नहीं करना चाहिए। जब उन्हें वास्तव में जरूरत होती है, तो एक्सेस अधिकारों का अनुरोध करने का यह अच्छा अभ्यास है। सत्र बनाते समय, हम केवल मूल अधिकारों का अनुरोध करते हैं।

+ (NSArray*) getBasicPermissions { NSArray* permissions = [[NSArray alloc] initWithObjects: @"user_birthday", nil]; return permissions; }

इस स्थिति में, प्राधिकरण के दौरान निम्नलिखित संवाद प्रदर्शित किए जाएंगे।

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

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

 + (void) requestPublishPermissions { if (hasPublishPermissions) return; NSArray *permissions = [[NSArray alloc] initWithObjects: @"publish_actions", @"publish_stream", nil]; [[FBSession activeSession] requestNewPublishPermissions:permissions defaultAudience:FBSessionDefaultAudienceFriends completionHandler:^(FBSession *session, NSError *error) { hasPublishPermissions = [[FBSession activeSession].permissions containsObject:@"publish_actions"] && [[FBSession activeSession].permissions containsObject:@"publish_stream"]; if (g_handler) { g_handler->OnGetPublishPermissions(hasPublishPermissions); } }]; }

इस स्थिति में, निम्न संवाद दिखाया जाएगा।

यह याद रखना महत्वपूर्ण है कि एक खिलाड़ी अपनी ओर से प्रकाशित करने से इनकार कर सकता है, लेकिन प्राधिकरण को अनुमति दे सकता है। इन मामलों को सावधानी से संभालना चाहिए।

मित्रों से अनुरोध

दोस्तों (एप्लिकेशन अनुरोध) के अनुरोधों के कार्यान्वयन को प्रलेखन में पर्याप्त विवरण में वर्णित किया गया है , लेकिन कई सूक्ष्मताएं हैं। एक बुनियादी क्वेरी कार्यान्वयन के साथ, नीचे दिखाया गया संवाद बॉक्स दिखाया जाएगा।

इस कार्यान्वयन के लिए कोड स्पॉइलर के तहत है।

कार्यान्वयन

 + (void) requestFriend { // more details here // https://developers.facebook.com/docs/ios/send-requests-using-ios-sdk/ if (!friendsCache) { friendsCache = [[FBFrictionlessRecipientCache alloc] init]; } [friendsCache prefetchAndCacheForSession:nil]; [FBWebDialogs presentRequestsDialogModallyWithSession:nil message:@"Help me, friend!" title:@"Help me!" parameters:nil handler:^(FBWebDialogResult result, NSURL *resultURL, NSError *error) { if (error) { NSLog(@"Error sending request"); } else { if (result == FBWebDialogResultDialogNotCompleted) { NSLog(@"User canceled request"); } else { NSDictionary *urlParams = [FacebookController parseURLParams:[resultURL query]]; if (![urlParams valueForKey:@"request"]) { NSLog(@"User canceled request"); } else { NSLog([NSString stringWithFormat: @"Request Sent: %@", [urlParams valueForKey:@"request"]]); } } } } friendCache:friendsCache]; }

क्वेरी विंडो का व्यवहार मापदंडों के बाद पारित मापदंडों का उपयोग करके नियंत्रित किया जा सकता है : जब संवाद कहा जाता है। उदाहरण के लिए, मापदंडों का निम्नलिखित सेट आपको अग्रिम में ज्ञात मित्र को अनुरोध भेजने की अनुमति देता है।

 NSString *friendId=@"100006530868327"; NSMutableDictionary* params = [[NSMutableDictionary alloc] init]; params[@"to"] = friendId;

इस मामले में फेसबुक एसडीके एक संशोधित ऐप अनुरोध विंडो दिखाएगा और यहां तक कि सुझाव देगा कि यह मित्र बाद के अनुरोधों पर खिड़की नहीं दिखाएगा।

समयरेखा पोस्टिंग

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

 NSMutableDictionary<FBGraphObject> *object = [FBGraphObject openGraphObjectForPostWithType:@"aw_test:badge" title:@"Sample Badge" image:@"https://fbstatic-a.akamaihd.net/images/devsite/attachment_blank.png" url:@"http://samples.ogp.me/473380876115865" description:@""];; [FBRequestConnection startForPostWithGraphPath:@"me/objects/aw_test:badge" graphObject:object completionHandler:^(FBRequestConnection *connection, id result, NSError *error) { // handle the result }];

"कार्रवाई के लिए कोड" टैब में आप कार्रवाई के लिए कोड प्राप्त कर सकते हैं। टाइमलाइन में कहानी बनाने के लिए, आपको पहले एक ऑब्जेक्ट बनाना होगा, फिर इस ऑब्जेक्ट के साथ एक एक्शन बनाना होगा।
अजीब तरह से, यह कोड काम नहीं करता है। यदि आप इसे बिना संशोधनों के परियोजना में शामिल करते हैं, तो एक वर्ग में एक अनिर्धारित चयनकर्ता द्वारा दुर्घटना होगी। इसे ठीक करने के लिए, आपको बनाए गए खुले ग्राफ़ ऑब्जेक्ट के मापदंडों में कुछ पंक्तियों को जोड़ना होगा।

 object[@"create_object"] = @"true"; object[@"fbsdk:create_object"] = @"true";

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

कार्यान्वयन

 + (void) createOpenGraphObjectWithType:(NSString *) type title:(NSString *) title url:(NSString *) url image:(NSString *) image handler: (OpenGraphObjectCreationHandler) handler { NSMutableDictionary<FBOpenGraphObject> *object = [FBGraphObject openGraphObjectForPostWithType:type title:title image:image url:url description:@""]; object[@"create_object"] = @"true"; object[@"fbsdk:create_object"] = @"true"; [FBRequestConnection startForPostOpenGraphObject:object completionHandler:^(FBRequestConnection *connection, id result, NSError *error) { if (!error && result != nil) { NSLog([NSString stringWithFormat:@"Posting object '%@' (id=%@) is created!", title, [result objectForKey:@"id"]]); handler([result objectForKey:@"id"]); } else { NSLog([NSString stringWithFormat:@"Posting object creation error: %@", error]); } }]; } + (void) postStory { NSString* badge_title = @"Blue Badge"; NSString* badge_url = @"http://demo.tom3.html5.services.alawar.com/images/tester/blue_badge.htm"; NSString* badge_image = @"http://demo.tom3.html5.services.alawar.com/images/tester/blue_badge.png"; int rnd = arc4random() % 2; if (rnd == 0) { badge_title = @"Red Badge"; badge_url = @"http://demo.tom3.html5.services.alawar.com/images/tester/red_badge.htm"; badge_image = @"http://demo.tom3.html5.services.alawar.com/images/tester/red_badge.png"; } [FacebookController createOpenGraphObjectWithType:@"aw_test:badge" title:badge_title url:badge_url image:badge_image handler:^(NSString *objectId) { // action NSMutableDictionary<FBGraphObject> *action = [FBGraphObject graphObject]; action[@"badge"] = objectId; action[@"fb:explicitly_shared"] = @"1"; [FBRequestConnection startForPostWithGraphPath:@"me/aw_test:find" graphObject:action completionHandler:^(FBRequestConnection *connection, id result, NSError *error) { if (!error && result != nil) { NSLog([NSString stringWithFormat:@"Posted (id=%@)!", [result objectForKey:@"id"]]); } else { NSLog([NSString stringWithFormat:@"Posting error: %@", error]); } }]; }]; }

एक चौकस पाठक नोट करेगा कि कार्रवाई के लिए एक अतिरिक्त पैरामीटर को कोड में जोड़ा गया है।

 action[@"fb:explicitly_shared"] = @"1";

यदि यह पैरामीटर सेट नहीं है, तो बनाया गया इतिहास उपयोगकर्ता की हाल की गतिविधियों में जाएगा, न कि समयरेखा पर। यदि सब कुछ सही ढंग से किया जाता है, तो उपयोगकर्ता के समय में नीचे दिए गए आंकड़े के समान कुछ का निरीक्षण करना संभव होगा।

से निपटने के लिए अंतिम बिंदु: वस्तुओं का विवरण कहाँ और कैसे संग्रहीत किया जाता है। ऑब्जेक्ट का विवरण कुछ खुले सर्वर पर विशेष रूप से चिह्नित एचटीएमएल-दस्तावेज़ के रूप में संग्रहीत किया जाता है। छवियों को खुले सर्वरों पर भी होस्ट किया जाता है, जहां से फेसबुक उन्हें अपलोड करता है।

एक निष्कर्ष के बजाय

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