👩🏾‍🤝‍👨🏽 📁 🌠 जावा एप्लिकेशन से तारांकन सर्वर के साथ सहभागिता 😡 👉🏼 🏡

तारांकन प्रबंधन इंटरफ़ेस (AMI) के माध्यम से एक जावा अनुप्रयोग से एक तारांकन सर्वर के साथ बातचीत

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

उत्तर-प्रश्न की शैली में मंचों पर जानकारी के आवश्यक बिट्स की तलाश नहीं करने के लिए, मैं जावा से एस्टरिस्क सर्वर के साथ बातचीत करने पर एक छोटा ट्यूटोरियल संलग्न कर रहा हूं।

महत्वपूर्ण: मेरा मानना है कि एक बार जब आप लेखन कोड के चरण में पहुंच चुके होते हैं, तो आपके पास पहले से ही एक काम करने वाला तारांकन सर्वर होता है जिसे आप एक्सेस कर सकते हैं।

1) काम करने के लिए इसे सुविधाजनक बनाने के लिए क्या चुनना है?

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

2) क्या पुस्तकालय कनेक्ट करने के लिए?

यह एक:

<dependency> <groupId>org.asteriskjava</groupId> <artifactId>asterisk-java</artifactId> <version>2.0.4</version> </dependency>

3) सर्वर पर देखने के लिए कौन से कॉन्फिग्रेशन की जरूरत है?

Extension.conf - वह विन्यास जो डायप्लान का वर्णन करता है। आप लगातार उससे संपर्क करते रहेंगे। यदि अधिक समझ में आने वाली भाषा में, तो इसमें स्क्रिप्ट होती है कि सर्वर एक विशिष्ट संख्या में कॉल प्राप्त करने पर क्या करेगा। सबसे पहले, एक विशिष्ट संदर्भ को डायप्लान में खोजा जाता है - यह वर्ग कोष्ठक में लिखा जाता है, जिसके बाद इस संदर्भ के टैग के तहत एक नंबर खोजा जाता है जिसके लिए आप संपर्क कर रहे हैं।

manager.conf - अपने Asterisk सर्वर के लिए उपयोगकर्ता और पासवर्ड के साथ कॉन्फ़िगर करें

इस विन्यास की सामग्री लगभग इस प्रकार होनी चाहिए:

 [user_name] secret = password read = all write = all deny=0.0.0.0/0.0.0.0 permit=0.0.0.0/255.255.255.0

user_name - उपयोगकर्ता नाम
secret - इसके लिए पासवर्ड
इनकार - आईपी पते जो इस उपयोगकर्ता के तहत उपयोग से वंचित हैं
परमिट - जिस तक पहुंचने की अनुमति है। उस आईपी को निर्दिष्ट करना सुनिश्चित करें जिसे आप परमिट में संपर्क कर रहे हैं, क्योंकि एस्टर आपके अनुरोध को रद्द कर सकता है।

sip.conf - सभी चड्डी यहाँ पंजीकृत हैं। ट्रंक एक फोन है जिसमें से हम एक ग्राहक को कॉल करेंगे।

4) कोड लिखना कहां से शुरू करें?

दो विकल्प हैं: आपको या तो एस्टरिस्क सर्वर पर कुछ कार्रवाई करने की आवश्यकता है, या सर्वर पर घटनाओं को सुनना है। हमारे अनुक्रम में दोनों शामिल हैं।

हम कार्य योजना का वर्णन करते हैं:

सर्वर से कनेक्शन खोलें;
हम काम के परिदृश्य का वर्णन करते हैं;
हम घटनाओं को सुनते हैं;
कनेक्शन बंद करें।

तदनुसार, कनेक्शन को DefaultAsteriskServer ऑब्जेक्ट के निर्माण के दौरान आरंभ किया गया है:

 import org.asteriskjava.live.AsteriskServer; import org.asteriskjava.live.DefaultAsteriskServer;

 AsteriskServer asteriskServer = new DefaultAsteriskServer(HOSTNAME, USERNAME, PASSWORD); asteriskServer.initialize();

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

 /** *    */ public class ScenarioCall extends OriginateAction { private final Logger log = LoggerFactory.getLogger(ScenarioCall.class); private String TRUNK; private final String PHONE_FOR_RINGING; private final String EXTEN_FOR_APP; private final String CONTEXT_FOR_APP; public ScenarioCall(String trunk, String phoneForRinging, String extension, String context) { this.TRUNK = trunk; this.PHONE_FOR_RINGING = phoneForRinging; this.EXTEN_FOR_APP = extension; this.CONTEXT_FOR_APP = context; this.init(); } /** *         OriginateAction */ private void init() { //  String callId = ValidValues.getValidCallId(this.PHONE_FOR_RINGING); //    String channelAsterisk = ValidValues.getValidChannel(this.TRUNK, this.PHONE_FOR_RINGING); this.setContext(CONTEXT_FOR_APP); this.setExten(EXTEN_FOR_APP); this.setPriority(1); this.setAsync(true); this.setCallerId(callId); this.setChannel(channelAsterisk); log.info("Create Scenario Call: phone '{}',chanel '{}',context '{}',extension '{}'", callId, channelAsterisk, CONTEXT_FOR_APP, EXTEN_FOR_APP); } }

इस परिदृश्य में हमें क्या समझने की आवश्यकता है? सबसे पहले, एक ट्रंक कनेक्शन बनाया जाता है। एक ट्रंक वह संख्या है जहां से आप ग्राहक को कॉल करेंगे। उसके बाद, ट्रंक और सब्सक्राइबर के बीच एक कनेक्शन बनाया जाता है, उसके बाद सब्सक्राइबर और आपके अन्य कौन से कनेक्शन की आवश्यकता है।

यह उसी क्रम में है।

 this.setContext(CONTEXT_FOR_APP)

प्रेषित मूल्य: वह संदर्भ जिसमें हम उस फ़ोन नंबर की तलाश करेंगे जिसके साथ आप सब्सक्राइबर को जोड़ना चाहते हैं (Extension.conf से)।

 this.setExten(EXTEN_FOR_APP)

प्रेषित मूल्य: वह स्क्रिप्ट जो आपके द्वारा ग्राहक से संपर्क करने के बाद निष्पादित की जाएगी (एक्सटेंशन.कॉन्फ़ से)।

 this.setCallerId(callId)

प्रेषित मूल्य: हमारे ग्राहक की संख्या

 this.setChannel(channelAsterisk)

संचरित मूल्य: स्थापित संचार चैनल, आमतौर पर इस तरह दिखता है: ट्रंक_नाम / फोन_यूज़र।

ट्रंक_नाम के लिए कहां देखें? तारांकन सर्वर पर एक sip.conf विन्यास है - सभी चड्डी वहां पंजीकृत हैं।

एक कॉल बनाएं:

 if (asteriskServer .getManagerConnection().getState().equals(ManagerConnectionState.CONNECTED) || asteriskServer .getManagerConnection().getState().equals(ManagerConnectionState.CONNECTING) || asteriskServer .getManagerConnection().getState().equals(ManagerConnectionState.INITIAL)) { try { ScenarioCall scenarioCall = new ScenarioCall(trank, phone, extension, context); CallBack callBackForScenarioCall = new CallBack(); asteriskServer.originateAsync(scenarioCall, callBackForScenarioCall); } catch (ManagerCommunicationException e) { //   , StateConnection    RECONNECTING,     } }

हमने एक कॉल बनाया, लेकिन इसे गतिशील रूप से कैसे ट्रैक किया जाए?

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

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

 /** *        asteriskConnection.originateAsync  *  CallBack -     ,     *  originateAsync. CallBack      , *       ,    onNoAnswer ,  *     onBusy,     ,  onFailure,  . *        . ,      *      (      ,    ) */ public class CallBack implements OriginateCallback { /** *     PRERING,       * OriginateCallback -    */ private ChannelState resultCall = ChannelState.PRERING; /** *    ,   .         */ @Override public void onDialing(AsteriskChannel asteriskChannel) { //   ,  resultCall, //   asteriskChannel    null, //    resultCall   //   } /** *   .      *      6 - setStatus */ @Override public void onSuccess(AsteriskChannel asteriskChannel) { //   , asteriskChannel   null, // asteriskChannel.getState()      ChannelState.UP //   } /** *      ,    *      7 - setStatus () */ @Override public void onNoAnswer(AsteriskChannel asteriskChannel) { //   , //   asteriskChannel    null, //    resultCall   //   } /** *   *      7 - setStatus () */ @Override public void onBusy(AsteriskChannel asteriskChannel) { //   , //   asteriskChannel    null, //    resultCall   //   } /** *      */ @Override public void onFailure(LiveException e) { //     , //     , // onFailure      } }

किसी श्रोता को तारांकन पर कैसे लटकाएं?

ऐसा करने के लिए, एक क्रियान्वयन वर्ग AsteriskServerListener, PropertyChangeListener बनाएँ।
AsteriskConnection वर्ग के एक उदाहरण के माध्यम से निर्मित कनेक्शन के लिए, हम लागू करते हैं:

  this.asteriskConnection.addAsteriskServerListener(this.callBackEventListener);

this.callBackEventListener - हमारे श्रोता वर्ग का एक उदाहरण, इससे पैदा हुआ:

 ** *    Asterisk *  PropertyChangeListener   ,     . *  AsteriskServerListener   ,     AsteriskConnection. */ public class CallBackEventListener implements AsteriskServerListener, PropertyChangeListener { public void onNewAsteriskChannel(AsteriskChannel channel) { channel.addPropertyChangeListener(this); } public void onNewMeetMeUser(MeetMeUser user) { user.addPropertyChangeListener(this); } public void onNewQueueEntry(AsteriskQueueEntry user) { user.addPropertyChangeListener(this); } public void onNewAgent(AsteriskAgent asteriskAgent) { asteriskAgent.addPropertyChangeListener(this); } /** *    .   {@link PropertyChangeEvent} *    , *        , *        CallBack * * @param propertyChangeEvent      */ public void propertyChange(PropertyChangeEvent propertyChangeEvent) { findEventEndCall(propertyChangeEvent); } private void findEventEndCall(PropertyChangeEvent event) { if (event.getSource() instanceof AsteriskChannel) { AsteriskChannel callBackChannel = (AsteriskChannel) event.getSource(); String callId = getStringWithOnlyDigits(callBackChannel.getCallerId().toString()); callId = ValidValues.getValidCallId(callId); if (callBackChannel.getState().toString().equals("HUNGUP") && event.getOldValue().toString().contains("RINGING")) { //      callBackChannel.removePropertyChangeListener(this); //     } else if (callBackChannel.getState().toString().equals("HUNGUP") && event.getOldValue().toString().contains("UP")) { //     callBackChannel.removePropertyChangeListener(this); //     } else if (callBackChannel.getState().toString().equals("HUNGUP")) { //      callBackChannel.removePropertyChangeListener(this); //     } } } private String getStringWithOnlyDigits(String strForParse) { String result = ""; if (strForParse != null && !strForParse.isEmpty()) { CharMatcher ASCII_DIGITS = CharMatcher.anyOf("<>").precomputed(); result = ASCII_DIGITS.removeFrom(strForParse.replaceAll("[^0-9?!]", "")); } return result; } }

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

डेटा सत्यापन के बारे में थोड़ा।

OriginateAction.setChannel में - trunk_name / phone_user पास है
phone_user - यदि यह रूसी है, तो यह आठ के आंकड़े से शुरू होना चाहिए, अगर अंतर्राष्ट्रीय संख्या एक से अधिक है।

OriginateAction.setCallerId में - क्लाइंट का फ़ोन नंबर प्रेषित होता है,
तब CallBackEventListener में यह callBackChannel.getCallerId () में आएगा।

इसे इस तरह लेंगे:

 String callId = getStringWithOnlyDigits(callBackChannel.getCallerId().toString());

अंत में, के बारे में मत भूलना:

 asteriskServer.shutdown();

यदि आपको कोई कॉल बाधित करने की आवश्यकता है, तो या तो CallBackEventListener वर्ग में
मौजूदा संचार चैनल में हम प्रदर्शन करते हैं:

 callBackChannel.hangup();

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

अपने Asterisk सर्वर के साथ शुभकामनाएँ!

आगे पढ़ने:

1) तारांकन-जावा ट्यूटोरियल

2) तारांकन प्रबंधन इंटरफ़ेस (AMI)

जावा एप्लिकेशन से तारांकन सर्वर के साथ सहभागिता

तारांकन प्रबंधन इंटरफ़ेस (AMI) के माध्यम से एक जावा अनुप्रयोग से एक तारांकन सर्वर के साथ बातचीत

More articles: