TelegramBot। बुनियादी कार्यक्षमता। स्टिकर और इमोटिकॉन्स। (भाग 3)

पीएम में अक्सर पूछे जाने वाले प्रश्नों में से एक है मुस्कुराहट (इमोजीस) और स्टिकर के साथ काम करना।

उनके साथ कैसे काम करना है, मैं कौन से उपकरण का उपयोग करता हूं, आदि।

इस भाग में, हम इस तरह की चीजों पर विचार करेंगे: स्टिकर के साथ एक संदेश कैसे बनाया जाए, स्टिकर के साथ प्राप्त संदेश को कैसे संसाधित किया जाए, संदेश पाठ में सभी इमोटिकॉन्स (इमोजी) कैसे खोजें, इमोटिकॉन्स का उपयोग करके एक संदेश कैसे बनाएं।

कौन परवाह करता है, कृपया, बिल्ली के नीचे।

परंपरा से, हम लेख को इसके स्रोत के लिंक के साथ शुरू करते हैं :)

लेख में चर्चा किए गए सभी कोड को Part3-Stick_and_Emoji शाखा में संकलित किया गया है।

स्टिकर

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

Stickers.java

import org.telegram.telegrambots.api.methods.send.SendSticker; public enum Stickers { FUNNY_JIM_CARREY("CAADBQADiQMAAukKyAPZH7wCI2BwFxYE"), ; String stickerId; Stickers(String stickerId) { this.stickerId = stickerId; } public SendSticker getSendSticker(String chatId) { if ("".equals(chatId)) throw new IllegalArgumentException("ChatId cant be null"); SendSticker sendSticker = getSendSticker(); sendSticker.setChatId(chatId); return sendSticker; } public SendSticker getSendSticker() { SendSticker sendSticker = new SendSticker(); sendSticker.setSticker(stickerId); return sendSticker; } } 

यहां सब कुछ सरल है। हम स्टिकर को एक नाम देते हैं जो हमारे लिए समझ में आता है। और कुछ तरीकों के साथ, हमें उपयोगकर्ता को भेजने के लिए एक तैयार वस्तु मिलती है।

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

हमारे पास हमारे द्वारा बनाई गई मूल कार्यक्षमता है:
TelegramBot। बुनियादी कार्यक्षमता। (भाग 2)
हमारे बॉट के लिए किसी भी तरह से स्वीकृत स्टिकर को संसाधित करना शुरू करने के लिए, हमें आवश्यकता है:

• निर्धारित करें कि उन्होंने हमें एक स्टिकर भेजा
• संकेत दें कि स्टिकर के साथ संदेशों को संसाधित करने के लिए कौन से हैंडलर जिम्मेदार हैं
• एक हैंडलर चलाएं जो प्रतिक्रिया में उपयोगकर्ता के लिए एक संदेश उत्पन्न करेगा

कार्य : जब चैट में एक स्टिकर प्राप्त होता है, तो बॉट को प्रतिक्रिया में स्टिकर आईडी के साथ एक पाठ संदेश भेजना चाहिए।

हमने कमांड की सूची में STICKER कमांड को जोड़ा

भेजे गए अद्यतन के विश्लेषक में, हम यह निर्धारित करने की कोशिश करेंगे कि क्या हमारे पास एक पाठ संदेश है या इसमें एक स्टिकर है:

MessageReciever.java लाइन 57

  if (message.hasText()) { parsedCommand = parser.getParsedCommand(message.getText()); } else { Sticker sticker = message.getSticker(); if (sticker != null) { parsedCommand = new ParsedCommand(Command.STICKER, sticker.getFileId()); } } 

क्योंकि हमें भेजे गए संदेश की जटिल प्रसंस्करण करने की आवश्यकता नहीं है, फिर हम तथाकथित "सिस्टम संदेशों" को संभालने के लिए जिम्मेदार मौजूदा हैंडलर को स्टिकर वाले संदेशों की प्रक्रिया को सौंपेंगे:
MessageReciever.java लाइन 86

  case START: case HELP: case ID: case STICKER: SystemHandler systemHandler = new SystemHandler(bot); log.info("Handler for command[" + command.toString() + "] is: " + systemHandler); return systemHandler; 

तदनुसार, SystemHandler में हमें यह निर्दिष्ट करने की आवश्यकता है कि प्राप्त STICKER कमांड को कैसे संसाधित किया जाए:
SystemHandler.java लाइन 31

  case STICKER: return "StickerID: " + parsedCommand.getText(); 

परिणामस्वरूप, हमारे बॉट में कोई भी स्टिकर भेजते समय, हम प्रतिक्रिया में इसकी आईडी प्राप्त करेंगे:

इमोटिकॉन या इमोजी

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

उदाहरण के लिए, ईवेंट शेड्यूलर बॉट में



बटन पर और संदेश के पाठ में एक ही आइकन का उपयोग करना, आप उपयोगकर्ता को सहजता से और अपने इंटरफ़ेस को समझने की अनुमति देते हैं, संदेश और बटन को अतिरिक्त पाठ के साथ अव्यवस्थित करते हैं।

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

ठीक है, निश्चित रूप से, स्टिकर के साथ सादृश्य द्वारा, आइए अपने लिए थोड़ा सहायक लिखें जो हमें आवश्यक कोड दिखाएगा और यहां तक ​​कि हमें उन्हें सही ढंग से संसाधित करने की गारंटी है।

सबसे पहले, निम्नलिखित निर्भरता pom.xml में जोड़ें:

  <dependency> <groupId>com.vdurmont</groupId> <artifactId>emoji-java</artifactId> <version>3.3.0</version> </dependency> 

ईमानदारी से, मुझे याद नहीं है कि मैं इसके पार कहाँ आया था, लेकिन तब से मैं इसका उपयोग केवल तभी करता हूँ जब मुझे अपने बॉट में इमोटिकॉन्स के साथ कुछ करने की आवश्यकता होती है।

पुस्तकालय में कई अलग-अलग उपकरण हैं:



जिज्ञासु और जिज्ञासु वह होगा जहाँ घूमना है :)

बॉट का उपयोग करके इमोटिकॉन भेजने में क्या लगता है? आपको यूनिकोड संदेश के पाठ में वांछित इमोजी को एम्बेड करना होगा।

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

मैं आपको एक रास्ता दिखाना चाहता हूं जो मेरे लिए मुस्कुराहट के साथ काम करने के लिए सबसे सुविधाजनक निकला।

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

टैग को कॉलन में फंसाया जाना चाहिए और कुछ प्रकार के अनूठे पाठ होते हैं जो वांछित स्माइली का संकेत देते हैं।

यदि किसी संदेश को दर्ज करने के लिए क्षेत्र में आप एक कॉलन के साथ शुरू होने वाले संदेश को टाइप करना शुरू करते हैं, तो टेलीग्राम स्वयं दिखाना शुरू कर देगा कि कौन से इमोजी में टैग का दर्ज पाठ है:



और जब आप सही इमोटिकॉन टैग दर्ज करते हैं और एक और बृहदान्त्र डालते हैं - पाठ एक स्माइली में बदल जाएगा। यदि आप बाईं माउस बटन को इमोटिकॉन पर रखते हैं तो टैग भी प्रदर्शित किए जाते हैं।



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

और हम, टैग को जानते हुए, इस तरह से यूनिकोड इमोटिकॉन प्राप्त कर सकते हैं:

 String emoji_kissing = EmojiParser.parseToUnicode(":kissing:"); 

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

 import com.vdurmont.emoji.EmojiParser; public enum Icon { PLUS(":heavy_plus_sign:"), MINUS(":heavy_minus_sign:"), CHECK(":white_check_mark:"), NOT(":x:"), DOUBT(":zzz:"), FLAG(":checkered_flag:") private String value; public String get() { return EmojiParser.parseToUnicode(value); } Icon(String value) { this.value = value; } } 

और इस तरह यह कोड इस वर्ग और एक विशिष्ट इमोटिकॉन का उपयोग करते हुए दिखेगा:

  row.add(new InlineKeyboardButton() .setText(Icon.CHECK.get() + " I'm going") 

यह इस बटन का कोड है:



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

ठीक है, यह सुनिश्चित करने के लिए कि कौन सी मुस्कुराहट हम दिखा सकते हैं और कौन सी नहीं, हम इस कार्य को अपने सहायक को सौंप देंगे।

टास्क: यदि भेजे गए संदेश में कोई विशिष्ट कमांड नहीं है, लेकिन पाठ में इमोटिकॉन्स शामिल हैं - उपयोगकर्ता को संदेश के रूप में स्क्रीन पर इन इमोटिकॉन्स को प्रदर्शित करें और उनकी विशेषताओं (टैग और विवरण) का संकेत दें।

कमांड की सूची में TEXT_CONTAIN_EMOJI कमांड जोड़ें
कमांड.जवा लाइन 8

 public enum Command { ... TEXT_CONTAIN_EMOJI, ... } 

उस पार्सर में जो यह निर्धारित करता है कि हमारे संदेश में किस तरह की कमांड निहित है, निम्नलिखित पाठ जोड़ें:

Parser.java लाइन 38

  if (result.getCommand() == Command.NONE) { List<String> emojiContainsInText = EmojiParser.extractEmojis(result.getText()); if (emojiContainsInText.size() > 0) result.setCommand(Command.TEXT_CONTAIN_EMOJI); } 

यदि हम यह निर्धारित करते हैं कि संदेश में कोई विशिष्ट कमांड नहीं है, लेकिन इसमें इमोटिकॉन्स हैं, तो हम वापस लौटते हैं कि हमने TEXT_CONTAIN_EMOJI कमांड को पार्स किया।

एक अलग हैंडलर बनाएं जो केवल इस कमांड को प्रोसेस करेगा:
EmojiHandler.java

 import com.example.telegrambot.bot.Bot; import com.example.telegrambot.command.ParsedCommand; import com.vdurmont.emoji.Emoji; import com.vdurmont.emoji.EmojiManager; import com.vdurmont.emoji.EmojiParser; import org.apache.log4j.Logger; import org.telegram.telegrambots.api.objects.Update; import java.util.HashSet; import java.util.Set; public class EmojiHandler extends AbstractHandler { private static final Logger log = Logger.getLogger(EmojiHandler.class); public EmojiHandler(Bot bot) { super(bot); } @Override public String operate(String chatId, ParsedCommand parsedCommand, Update update) { String text = parsedCommand.getText(); StringBuilder result = new StringBuilder(); Set<String> emojisInTextUnique = new HashSet<>(EmojiParser.extractEmojis(text)); if (emojisInTextUnique.size() > 0) result.append("Parsed emojies from message:").append("\n"); for (String emojiUnicode : emojisInTextUnique) { Emoji byUnicode = EmojiManager.getByUnicode(emojiUnicode); log.debug(byUnicode.toString()); String emoji = byUnicode.getUnicode() + " " + byUnicode.getAliases() + " " + byUnicode.getDescription(); result.append(emoji).append("\n"); } return result.toString(); } } 

यह कोड केवल संदेश पाठ से इमोटिकॉन्स का चयन करता है, अद्वितीय लोगों के साथ एक सेट बनाता है, उनके गुणों से टैग और विवरण का चयन करता है, और इससे एक पाठ संदेश उत्पन्न करता है।

काम का परिणाम इस तरह दिखता है:



वर्ग कोष्ठक में हमें वे टैग मिलते हैं जिनका उपयोग हम इमोटिकॉन्स सम्मिलित करने के लिए कर सकते हैं। आप देख सकते हैं कि 1 से अधिक टैग कभी-कभी एक इमोटिकॉन को संदर्भित करते हैं।

और इस सहायक की मदद से, हम ठीक से समझ सकते हैं कि हमारी लाइब्रेरी कौन से इमोटिकॉन्स को समझती है और कौन से इसे अनदेखा करता है।

उदाहरण के लिए, आप यहां देख सकते हैं:



कोड के साथ मुस्कुराएं : face_with_monocle: किसी कारण से इस लाइब्रेरी द्वारा इसका पता नहीं लगाया गया है।

तो, हमारे पास एक हैंडलर है। हम उसे कैसे कार्य पास करते हैं?

क्योंकि हम पहले से ही जानते हैं कि इमोटिकॉन्स के साथ एक पाठ संदेश को TEXT_CONTAIN_EMOJI कमांड के रूप में पाया जाता है - MessageReciever में हमें यह इंगित करने की आवश्यकता है कि इस कमांड को संसाधित करने के लिए एक अलग इमोजीहैंडलर हैंडलर जिम्मेदार है।

MessageReciever.java लाइन 94

  case TEXT_CONTAIN_EMOJI: EmojiHandler emojiHandler = new EmojiHandler(bot); log.info("Handler for command[" + command.toString() + "] is: " + emojiHandler); return emojiHandler; 

खुशी में कार्यक्रम और सवाल पूछने में संकोच नहीं करते :)

पुनश्च
आप इस कार्यक्षमता के साथ बॉट को महसूस कर सकते हैं: https://t.me/test_habr_bot ।