🖋️ 🕝 🈯️ अपने स्वयं के इंटरफेस के साथ XBMC के लिए प्लग-इन लिखना: भाग II

प्रविष्टि

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

तो, चलिए संवादों पर चलते हैं।

संवादों

नियंत्रणों के विपरीत, संवादों को एक मूल कंटेनर वर्ग की आवश्यकता नहीं होती है और इसे सीधे कहा जा सकता है - संबंधित वर्ग का एक उदाहरण बनाकर और फिर वांछित विधि को कॉल करके। दूसरा अंतर यह है कि संवाद स्वचालित रूप से वर्तमान त्वचा से आवश्यक बनावट का उपयोग करते हैं, अर्थात, हमें उनके दृश्य डिजाइन के बारे में चिंता करने की आवश्यकता नहीं है। आमतौर पर, XBMC UI संवाद Tkinter में tkFileDialog / tkMessageBox मोडल संवाद या PyQt में QDialog उत्तराधिकारी संवाद से मिलते जुलते हैं।

अधिकांश लेकिन दो संवाद xbmcgui.Dialog क्लास के तरीके हैं। विधियां स्थिर हैं, अर्थात, उन्हें संबंधित वर्ग के उदाहरण के बिना बनाया जा सकता है।

संवाद xbmcgui.Dialog

अगला, हम xbmcgui.Dialog वर्ग के तरीकों का उपयोग करके कार्यान्वित संवादों पर चर्चा करेंगे।

ब्राउज़

फ़ाइलों और फ़ोल्डरों के चयन के लिए संवाद। इसके कई पैरामीटर हैं जो आपको चयन मोड को कॉन्फ़िगर करने की अनुमति देते हैं: फ़ाइल, फ़ोल्डर, एकाधिक चयन, आदि।
एक फ़ाइल या फ़ोल्डर के लिए पथ युक्त स्ट्रिंग, या चयन मोड के आधार पर पथ के साथ तार का एक रिटर्न देता है।
बिल्कुल स्पष्ट बिंदु नहीं: 3 जी कॉल पैरामीटर (s_shares) फ़ाइल \ userdata \ source.xml में टैग में से एक है: वीडियो, संगीत, चित्र या फ़ाइलें। पहले 3 विकल्प क्रमशः वीडियो, संगीत और फ़ोटो के स्रोतों तक पहुंचने के लिए उपयोग किए जाते हैं, और फ़ाइल पैरामीटर फ़ाइल प्रबंधक में जोड़े गए डिस्क / फ़ोल्डर तक पहुंच की अनुमति देता है। यदि फ़ाइल प्रबंधक खाली है, तो संपूर्ण फ़ाइल सिस्टम तक पहुंच खोली जाती है।
एक उदाहरण:

dialog = xbmcgui.Dialog() path = dialog.browse(1, 'Select file', 'video', '.avi|.mkv|.mp4')

browseMultiple

पिछली विधि का एक सबसेट। कई विकल्प लागू करता है। रास्तों की एक टुकड़ी लौटाता है।

browseSingle

एकल फ़ाइल / फ़ोल्डर का चयन करने के लिए ब्राउज़ का सबसेट भी। पथ को स्ट्रिंग के रूप में देता है।

इनपुट

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

संख्यात्मक

पिछले संवाद का एक सबसेट जो आपको संख्यात्मक जानकारी दर्ज करने की अनुमति देता है। एक स्ट्रिंग के रूप में दर्ज मूल्य भी लौटाता है।

अधिसूचना

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

yesno

यस और नो बटन के साथ डायलॉग। "हाँ" का चयन करते समय सही और अन्य मामलों में गलत।

ठीक

ओके बटन के साथ डायलॉग करें। यदि आप किसी अन्य तरीके से संवाद बंद किया गया था (उदाहरण के लिए, ESC दबाकर) तो ठीक है और गलत क्लिक करने पर वापस लौटाता है।

चुनना

एक निश्चित सेट से एक तत्व का चयन करने के लिए पाठ स्ट्रिंग की सूची। बड़ी संख्या में लाइनों के साथ, सूची स्क्रॉल करती है। चयनित पंक्ति की संख्या 0, या -1 से शुरू होती है, यदि ESC (या कोई अन्य बटन जो कार्रवाई को रद्द करता है) को दबाकर संवाद बंद कर दिया गया था।

निम्नलिखित दो संवाद हैं जो डायलॉग विधियाँ नहीं हैं।

DialogProgress

DialogProgress वर्ग एक निश्चित प्रक्रिया की प्रगति दिखाते हुए एक प्रगति पट्टी के साथ एक संवाद बॉक्स को लागू करता है।

DialogProgressBG

एक प्रगति पट्टी के साथ "पृष्ठभूमि" विंडो। यह आमतौर पर इंटरफ़ेस के ऊपरी दाएँ कोने में प्रदर्शित होता है।

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

XBMC प्लग-इन इंटरफ़ेस के संवादों और अन्य तत्वों पर सबसे अद्यतित त्वरित संदर्भ यहां पाया जा सकता है ।

सजावट और इंटरैक्टिव तत्व जोड़ें।

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

विंडो क्लास उदाहरण

हम निश्चित रूप से, addon.xml फ़ाइल के साथ शुरू करते हैं।

Addon.xml सामग्री

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <addon id="script.test.buttons" name="Buttons test script" version="0.0.1" provider-name="Roman_V_M"> <requires> <import addon="xbmc.python" version="2.0"/> </requires> <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> <extension point="xbmc.addon.metadata"> <platform>all</platform> <summary lang="en">Buttons test script</summary> <description lang="en">My buttons test script.</description> </extension> </addon>

अब सीधे प्लगइन कोड पर जाएं।

default.py

 # -*- coding: utf-8 -*- # Licence: GPL v.3 http://www.gnu.org/licenses/gpl.html #    . import os, sys #   XBMC. import xbmcgui, xbmcaddon #    Addon     . #     xbmcaddon.Addon()   , #     . _addon = xbmcaddon.Addon() #    . _addon_path = _addon.getAddonInfo('path').decode(sys.getfilesystemencoding()) #   . ACTION_PREVIOUS_MENU = 10 # Esc ACTION_NAV_BACK = 92 # Backspace #   . ALIGN_CENTER = 6 #      : # ; background_img = os.path.join(_addon_path, 'images', 'SKINDEFAULT.jpg') #    ; button_nf_img = os.path.join(_addon_path, 'images', 'KeyboardKeyNF.png') #    ; button_fo_img = os.path.join(_addon_path, 'images', 'KeyboardKey.png') #      :-). banana_img = os.path.join(_addon_path, 'images', 'banana.gif') class MyAddon(xbmcgui.Window): def __init__(self): #   . background = xbmcgui.ControlImage(1, 1, 1280, 720, background_img) self.addControl(background) #    . banana_picture = xbmcgui.ControlImage(500, 200, 256, 256, banana_img) self.addControl(banana_picture) #    (). self.set_controls() #    . self.set_navigation() def set_controls(self): #  "". self.privet_btn = xbmcgui.ControlButton(500, 500, 110, 40, u'…', focusTexture=button_fo_img, noFocusTexture=button_nf_img, alignment=ALIGN_CENTER) self.addControl(self.privet_btn) #  "". self.exit_btn = xbmcgui.ControlButton(650, 500, 110, 40, u'', focusTexture=button_fo_img, noFocusTexture=button_nf_img, alignment=ALIGN_CENTER) self.addControl(self.exit_btn) def set_navigation(self): #      "". self.privet_btn.controlRight(self.exit_btn) self.privet_btn.controlLeft(self.exit_btn) #      "". self.exit_btn.controlRight(self.privet_btn) self.exit_btn.controlLeft(self.privet_btn) #      "". self.setFocus(self.privet_btn) def onAction(self, action): #       . if action == ACTION_NAV_BACK or action == ACTION_PREVIOUS_MENU: self.close() def onControl(self, control): #   . #    ""... if control == self.privet_btn: # ...            .Dialog().ok(). xbmcgui.Dialog().ok(u', !', u'    :-)') #    "",   . elif control == self.exit_btn: self.close() if __name__ == '__main__': addon = MyAddon() addon.doModal() del addon

आगे लाइन-बाय-लाइन विश्लेषण। लाइन नंबर प्रदर्शित करने के लिए, ऐसे फ़ंक्शन के साथ एक संपादक का उपयोग करें, उदाहरण के लिए नोटपैड ++।
मैं स्पष्ट या पहले वर्णित बिंदुओं को छोड़ देता हूं।

12, 14: प्लगइन मापदंडों तक पहुंचने के लिए एडऑन क्लास का एक उदाहरण बनाएं। इस मामले में, हमें छवि फ़ाइलों तक पहुंचने के लिए प्लगइन के पथ की आवश्यकता है।

21: एक संख्यात्मक स्थिरांक जो बटन सहित कुछ नियंत्रणों में पाठ के संरेखण को निर्धारित करता है।

25-31: छवि फ़ाइलों के लिए पथ निर्धारित करें। सभी तस्वीरें प्लगइन फ़ोल्डर के सबफ़ोल्डर \ छवियों में संग्रहीत हैं।
नोट: यदि आप एक पूर्ण पथ के बिना एक फ़ाइल नाम निर्दिष्ट करते हैं, तो XBMC वर्तमान त्वचा के संसाधनों में एक तस्वीर की खोज करेगा। हालांकि, यह दुरुपयोग नहीं किया जाना चाहिए, क्योंकि विभिन्न खाल में छवि फ़ाइलों के नाम सबसे अधिक बार मेल नहीं खाते हैं।

39–43: चित्रों के साथ दो नियंत्रण बनाएं और उन्हें स्क्रीन पर प्रदर्शित करें।

49–55: 2 बटन बनाएं। बनावट की फाइलें और बटन पर पाठ के संरेखण को स्पष्ट रूप से निर्दिष्ट किया गया है।

57-65: नेविगेशन नियम बनाना। इस मामले में, हम प्रत्येक पड़ोसी बटन को दाईं और बाईं ओर असाइन करते हैं। चूंकि केवल 2 बटन हैं, प्रत्येक बटन एक-दूसरे के पड़ोसी हैं, अर्थात, जब आप बाईं या दाईं ओर तीर कुंजी दबाते हैं, तो फोकस वैकल्पिक रूप से हमारे दो बटन के बीच चला जाएगा।
67: काम करने के लिए नेविगेशन के लिए, एक बटन पर ध्यान केंद्रित करें। यदि ऐसा नहीं किया जाता है, तो नियंत्रण केवल माउस के साथ सक्रिय किया जा सकता है।

६A- 67०: ऑनएशन विधि पिछले उदाहरण की तरह ही है। मैं दोहराता हूं, यदि आप अपनी कक्षा में इस पद्धति को ओवरराइड करने का निर्णय लेते हैं, तो प्लगइन से बाहर निकलने के लिए कमांड (एस) लिखना सुनिश्चित करें!

72-80: हम नियंत्रण प्रक्रिया करते हैं। OnControl विधि दूसरे पैरामीटर के रूप में प्राप्त होती है, सक्रिय नियंत्रण का एक उदाहरण, अर्थात, नियंत्रण जिसे हमने क्लिक किया था या जिस पर हमने ENTER दबाया था जब यह फोकस में था।
77: जब आप "हैलो ..." बटन पर क्लिक करते हैं, तो एक साधारण संवाद बॉक्स "ओके" बटन के साथ दिखाई देता है।
79, 80: एक्ज़िट बटन ईएससी और बैकस्पेस कुंजी के अलावा, प्लगइन से बाहर निकलने का एक वैकल्पिक तरीका है।

यदि सब कुछ सही किया जाता है, तो हमें देखना चाहिए

यहाँ एक तस्वीर है

2 बिंदुओं पर ध्यान दें:
- सबसे पहले, एनीमेशन gif फ़ाइल में समर्थित है (जैसे पीएनजी में);
- दूसरा, बाद में बनाए गए नियंत्रण (एक केला, बटन के साथ एक चित्र) को पहले बनाई गई पृष्ठभूमि के ऊपर प्रदर्शित किया जाता है।

यदि आप "हैलो" बटन का चयन / क्लिक करते हैं, तो यह खुल जाएगा

पाठ के साथ संवाद बॉक्स।

एक उदाहरण के साथ एक पूर्ण प्लगइन यहां से डाउनलोड किया जा सकता है ।

WindowDialog वर्ग के आधार पर उदाहरण

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

हमेशा की तरह, addon.xml प्लगइन की मुख्य फाइल है।

Addon.xml सामग्री

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <addon id="script.test.buttons.alt" name="Buttons test script - Dialog" version="0.0.1" provider-name="Roman_V_M"> <requires> <import addon="xbmc.python" version="2.0"/> </requires> <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> <extension point="xbmc.addon.metadata"> <platform>all</platform> <summary lang="en">Buttons test script</summary> <description lang="en">My buttons test script.</description> </extension> </addon>

अगला कोड ही है।

default.py

 # -*- coding: utf-8 -*- # Licence: GPL v.3 http://www.gnu.org/licenses/gpl.html #    . import os, sys #   XBMC. import xbmcgui, xbmcaddon #    Addon     . #     xbmcaddon.Addon()   , #     . _addon = xbmcaddon.Addon() #    . _addon_path = _addon.getAddonInfo('path').decode(sys.getfilesystemencoding()) #   . ACTION_PREVIOUS_MENU = 10 # Esc ACTION_NAV_BACK = 92 # Backspace #   . ALIGN_CENTER = 6 #      : # ; background_img = os.path.join(_addon_path, 'images', 'ContentPanel.png') #    ; button_nf_img = os.path.join(_addon_path, 'images', 'KeyboardKeyNF.png') #    ; button_fo_img = os.path.join(_addon_path, 'images', 'KeyboardKey.png') #      :-). banana_img = os.path.join(_addon_path, 'images', 'banana.gif') class MyAddon(xbmcgui.WindowDialog): def __init__(self): #   . background = xbmcgui.ControlImage(370, 100, 500, 500, background_img) self.addControl(background) #    . banana_picture = xbmcgui.ControlImage(500, 200, 256, 256, banana_img) self.addControl(banana_picture) #    (). self.set_controls() #    . self.set_navigation() def set_controls(self): #  "". self.privet_btn = xbmcgui.ControlButton(500, 500, 110, 40, u'…', focusTexture=button_fo_img, noFocusTexture=button_nf_img, alignment=ALIGN_CENTER) self.addControl(self.privet_btn) #  "". self.exit_btn = xbmcgui.ControlButton(650, 500, 110, 40, u'', focusTexture=button_fo_img, noFocusTexture=button_nf_img, alignment=ALIGN_CENTER) self.addControl(self.exit_btn) def set_navigation(self): #      "". self.privet_btn.controlRight(self.exit_btn) self.privet_btn.controlLeft(self.exit_btn) #      "". self.exit_btn.controlRight(self.privet_btn) self.exit_btn.controlLeft(self.privet_btn) #      "". self.setFocus(self.privet_btn) def onAction(self, action): #       . if action == ACTION_NAV_BACK or action == ACTION_PREVIOUS_MENU: self.close() def onControl(self, control): #   . #    ""... if control == self.privet_btn: # ...            xbmcgui.Dialog().ok(). xbmcgui.Dialog().ok(u', !', u'    :-)') #    "",   . elif control == self.exit_btn: self.close() if __name__ == '__main__': addon = MyAddon() addon.doModal() del addon

पिछले उदाहरण की तुलना में, केवल 3 लाइनें बदल गई हैं।
25: एक और पृष्ठभूमि बनावट।
33: WindowDialog से विरासत।
37: पृष्ठभूमि छवि के अन्य निर्देशांक और आकार।

परिणाम की जाँच करें।

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

इस उदाहरण से पूरा प्लगइन यहाँ से डाउनलोड किया जा सकता है ।

निष्कर्ष

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

जानकारी के स्रोत

XBMC पायथन एपीआई सारांश
HOW-TO: XBMC के लिए पायथन लिपियों को लिखें ।

पिछले लेख

एक्सबीएमसी के लिए एक सरल प्लगइन का विस्तृत शरीर रचना विज्ञान ।
हम अपने स्वयं के इंटरफ़ेस के साथ XBMC के लिए प्लग-इन लिख रहे हैं: भाग I - सिद्धांत और सबसे सरल उदाहरण ।

अपने स्वयं के इंटरफेस के साथ XBMC के लिए प्लग-इन लिखना: भाग II - संवाद और सजावट