टेलीग्राम क्लाइंट लिखना आसान है

टेलीग्राम और अन्य लोकप्रिय दूतों के बीच क्या अंतर है? वह खुला है!
अन्य दूतों के पास भी एक एपीआई है, लेकिन किसी कारण से, टेलीग्राम को सबसे लोकप्रिय के सबसे खुले रूप में जाना जाता है?

साथ शुरू करने के लिए, टेलीग्राम के पास वास्तव में पूरी तरह से खुला ग्राहक है
कोड । दुर्भाग्य से, हम हर दिन सीधे GitHub पर कमिट नहीं करते हैं, लेकिन हमारे पास एक खुले लाइसेंस के तहत एक कोड है। टेलीग्राम वास्तुकला का अर्थ है कि बॉट और एपीआई दोनों के लगभग एक ही तरीके हैं - https://core.telegram.org/methods ।

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

आवेदन का सार

हम मुख्य रूप से नक्शे और नेविगेशन से निपटते हैं, इसलिए हमने तुरंत जियोलोकेशन से संबंधित कुछ चीजों पर ध्यान दिया। मुझे वास्तव में पसंद आया कि टेलीग्राम में, अन्य सभी अनुप्रयोगों से पहले, वास्तविक समय ( https://telegram.org/blog/live-locations ) में अपना स्थान साझा करने का एक सुविधाजनक तरीका था और मैं अक्सर इसका उपयोग करता हूं: मुझे खुद को उन्मुख करने में मदद करें, अपना रास्ता दिखाएं। सबसे महत्वपूर्ण बात यह है कि "आप कब होंगे?" सिद्धांत रूप में, यह अधिकांश लोगों के लिए पर्याप्त है, लेकिन हमेशा की तरह ऐसे परिदृश्य होते हैं जब सरल अवसर पर्याप्त नहीं होते हैं। उदाहरण के लिए, यह 10 से अधिक लोगों का समूह हो सकता है, विभिन्न उपकरणों के साथ (कुछ उपकरण फोन नहीं हो सकते हैं) और विभिन्न लोग। इन लोगों के लिए एक समूह में संदेशों का आदान-प्रदान करना सुविधाजनक होगा, साथ ही एक दूसरे को मानचित्र पर आगे बढ़ते देखना होगा।

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

1. चैट करने के लिए वास्तविक समय में स्थान भेजते समय बेहतर प्रबंधन।
2. नक्शे पर संपर्कों का स्थान देखें।
3. एक बाहरी एपीआई (बॉट) के माध्यम से बीकन उपकरणों की चैट से कनेक्ट करना।

हमने कैसे किया

सौभाग्य से, हम जो भी कोड लिखते हैं वह ओपन-सोर्स होता है, इसलिए मैं तुरंत इसके कार्यान्वयन के लिए एक लिंक दे सकता हूं - बॉट इंप्लीमेंटेशन और टेलीग्राम क्लाइंट इंप्लीमेंटेशन एट कोटलिन ।

बॉट - मूल बातें

बॉट के कार्यान्वयन पर बहुत सारे दस्तावेज और उदाहरण हैं, लेकिन फिर भी मैं कुछ कमियों के बारे में बात करना चाहता हूं। शुरू करने के लिए, हमने सर्वर साइड लिखा
जावा में और org.telegram लाइब्रेरी को चुना: टेलीग्रामबॉट्स। चूंकि हमारा सर्वर एक नियमित स्प्रिंगबूट है, इसलिए आरंभीकरण अत्यंत सरल है:

// Gradle implementation "org.telegram:telegrambots:3.6" TelegramBotsApi telegramBotsApi = new TelegramBotsApi(); telegramBotsApi.registerBot(new TelegramLongPollingBot() {...}); 

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

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

समाधान सरल है - पाठ संदेश भेजें, और ग्राहक पाठ को पार्स करेगा और नक्शे पर स्थान दिखाएगा। दुर्भाग्य से, मानक टेलीग्राम क्लाइंट में केवल पाठ संदेश दिखाई देंगे, लेकिन आप नक्शे को खोलने के लिए एक लिंक डाल सकते हैं।

बॉट - नुकसान

दुर्भाग्य से, बॉट को 2.5 गुना ज्यादा लिखना पड़ा। मुख्य समस्या संचार का गलत डिज़ाइन है।

1. किसी कारण से, पहले तो यह एक अच्छा विचार था कि अगर बॉट चैट में भाग लेने वाला और संदेश भेजने वाला होगा। लेकिन, यह पत्राचार की गोपनीयता और बॉट के साथ बातचीत के संदर्भ में बुरा है। सही निर्णय, इनलाइन बॉट का उपयोग करें। इस प्रकार, यह गारंटी दी जाती है कि बॉट अपने स्थान के अलावा कुछ भी नहीं देखता है और इसका उपयोग किसी भी चैट में किया जा सकता है। मानवीय रूप से, आपके बॉट को किसी तरह की सामान्य चैट में खींचना अनौपचारिक है, लेकिन आपको बॉट से एक पर बात करने और इसे कॉन्फ़िगर करने की आवश्यकता है, और फिर वह किसी भी चयनित चैट को आवश्यक संदेश भेजने में सक्षम होगा।
2. टेलीग्राम संदेश एपीआई में ऐतिहासिक रूप से 2 प्रकार की बातचीत होती है: पाठ के नीचे बटन (इनलाइन बटन) [ https://core.telegram.org/bots/2-0-intro#switch-to-inline-buttons ]) और सीधे बॉट के उत्तर। पाठ। सामान्य तौर पर, बॉट के उत्तर निराशाजनक रूप से पुराने हैं। कार्यान्वयन के दृष्टिकोण से बटन थोड़ा अधिक जटिल हैं, लेकिन यह उपयोग में आसानी के लिए पूरी तरह से भुगतान किया जाता है और उनका उपयोग सभी गैर-पाठ इनपुट के लिए किया जाना चाहिए।
3. एक बॉट के उदाहरण के रूप में, आप लोकप्रिय @vote_bot या हमारे @osmand_bot देख सकते हैं।

टेलीग्राम क्लाइंट

हम तैयार टेलीग्राम क्लाइंट के उदाहरणों को खोजने में सक्षम नहीं थे, सिवाय मुख्य एक के, लेकिन सरल tdlib संरचना ने हमें कुछ ही दिनों में एक बुनियादी ग्राहक बनाने में मदद की।

 task downloadTdLibzip { doLast { ant.get(src: 'https://core.telegram.org/tdlib/tdlib.zip', dest: 'tdlib.zip', skipexisting: 'true') ant.unzip(src: 'tdlib.zip', dest: 'tdlib/') } } task copyNativeLibs(type: Copy) { dependsOn downloadTdLibzip from "tdlib/libtd/src/main/libs" into "libs" } task copyJavaSources(type: Copy) { dependsOn downloadTdLibzip from "tdlib/libtd/src/main/java/org/drinkless/td" into "src/org/drinkless/td" } dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) } 

टेलीग्राम के लगभग सभी इंटर्नल C ++ में लिखे गए हैं और एंड्रॉइड के दृष्टिकोण से, केवल एपीआई क्लास 1.5 एमबी प्रॉक्सी तरीकों TdApi.java पर दिखाई देता है। बॉट्स के दस्तावेज़ीकरण और विधियों के नाम की तुलना करके, आप बस यह पता लगा सकते हैं कि कहां स्थानांतरित करना है।

 fun init(): Boolean { return if (libraryLoaded) { // create client client = Client.create(UpdatesHandler(), null, null) true } else { false } } 

 private fun requestUserPhoto(user: TdApi.User) { val remotePhoto = user.profilePhoto?.small?.remote if (remotePhoto != null && remotePhoto.id.isNotEmpty()) { downloadUserFilesMap[remotePhoto.id] = user client!!.send(TdApi.GetRemoteFile(remotePhoto.id, null)) { obj -> when (obj.constructor) { TdApi.Error.CONSTRUCTOR -> { val error = obj as TdApi.Error val code = error.code if (code != IGNORED_ERROR_CODE) { listener?.onTelegramError(code, error.message) } } TdApi.File.CONSTRUCTOR -> { val file = obj as TdApi.File client!!.send(TdApi.DownloadFile(file.id, 10), defaultHandler) } else -> listener?.onTelegramError(-1, "Receive wrong response from TDLib: $obj") } } } } 

टेलीग्राम क्लाइंट - नुकसान

1. पंजीकरण / लॉगिन और लॉगआउट। पंजीकरण करते समय, विभिन्न परिदृश्यों को ध्यान में रखना आवश्यक है: जब एक्सेस कोड एसएमएस द्वारा या किसी अन्य टेलीग्राम क्लाइंट, टू-फैक्टर प्राधिकरण, आदि को भेजा जाता है। सबसे बड़ी चुनौती परीक्षण है। 3 बार से अधिक किसी भी प्राधिकरण ने 24 घंटे के लिए खाते को अवरुद्ध करने का नेतृत्व किया, इसलिए लॉगआउट का परीक्षण विशेष रूप से मजेदार था। इस तथ्य के बावजूद कि पंजीकरण केवल एक बार की आवश्यकता है, यह शायद एकीकरण का सबसे कठिन हिस्सा है।
2. संदेशों को पढ़ने के लिए कैसे और किस क्रम में निर्धारित करें। किसी भी क्लाइंट के पास सभी चैट में सभी संदेशों तक पहुंच है, लेकिन उन्हें क्रमिक रूप से पढ़ा जाना चाहिए। हमारे मामले में, 99% संदेशों को त्यागने की आवश्यकता है। पहले, किसी कारण से, हमने लॉगिन के साथ पिछले 3 दिनों के लिए सभी संदेशों को पढ़ा, लेकिन बाद में इसने केवल समस्याएं पैदा कीं और जब हमने पुनः आरंभ किया, तो संदेश गायब हो गए। इसलिए, अब हम केवल नए संदेश पढ़ते हैं, और उन संदेशों के लिए जिन्हें हमें ज़रूरत है, हम आंतरिक डेटाबेस में आईडी को सहेजते हैं।

क्या हुआ?

संभवतः, सभी नुकसानों को जानने के बाद, कोई भी सब कुछ तेजी से कई बार कर सकता था, लेकिन तीन लोगों के लिए यह लगभग 1-2 महीने हो गया। अंतिम ऐप Google Play पर पाया जा सकता है।

इस कहानी में मुख्य प्रश्न यह है कि टेलीग्राम के दृष्टिकोण से यह बातचीत कितनी सही है और क्या उपयोगकर्ता इस तरह के एकीकरण को पसंद करते हैं। किसी भी मामले में, विचार ही आला है और यह पहले से ही व्यक्तिगत ग्राहकों को मिल गया है।

मुझे आपके सवालों के जवाब देने में खुशी होगी।