💯 🦀 🏇🏼 एक्सबीएमसी के लिए एक सरल प्लगइन का विस्तृत शरीर रचना विज्ञान 👨🏿‍🍳 🚝 🏴󠁧󠁢󠁳󠁣󠁴󠁿

प्रस्तावना

हैबे पर एक समान लेख पहले ही प्रकाशित किया गया था, लेकिन इसने वीडियो के साथ साइट को पार्स करने पर ध्यान केंद्रित किया - प्लगइन का व्यापारिक तर्क, इसलिए बोलने के लिए, और XBMC के साथ बातचीत के मुद्दों को पारित करने में उठाया गया था। मैं इस बारे में बात करना चाहता हूं कि एक एक्सबीएमसी प्लगइन में पायथन स्क्रिप्ट (बाद में - पायथन) को क्या बदल जाता है।
यह प्लगइन सेटिंग्स के आधार पर, सामान्य या उच्च गुणवत्ता में साइट www.cnet.com से वीडियो पॉडकास्ट देखने के लिए है। इस प्लगइन का आधिकारिक XBMC रिपॉजिटरी में उपलब्ध CNET पॉडकास्ट दर्शक प्लगइन से कोई लेना-देना नहीं है। यह पूरी तरह से 0 से एक प्रशिक्षण परियोजना के रूप में XBMC प्लगइन्स के वास्तविक लेखन के एक स्वतंत्र अध्ययन के भाग के रूप में लिखा गया है। प्लगइन विस्तृत दर्शकों के लिए उपयोगी होने का दावा नहीं करता है, न ही विशेष रूप से उत्कृष्ट सॉफ्टवेयर समाधानों के लिए। हालांकि, यह पूरी तरह से काम कर रहा है, और इसमें "गंभीर" प्लगइन्स में निहित अधिकांश तत्व हैं: मेटाडाटा के साथ एक एक्सएमएल फाइल, एक मुख्य स्क्रिप्ट, एक बाहरी आयातित मॉड्यूल, एक सेटिंग पैनल, स्थानीयकरण फाइलें, संसाधन फाइलें (चित्र)। मुझे उम्मीद है कि प्लगइन और यह लेख दोनों शुरुआती प्लगइन लेखकों और अनुभवी पायथन प्रोग्रामर्स के लिए एक शुरुआती बिंदु के रूप में काम कर सकता है जो एक्सबीएमसी के लिए प्लगइन्स लिखने में शामिल होना चाहते हैं।

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

नोट: शब्द "सेवा" का उपयोग पाठ में कुछ फ़ाइलों और फ़ोल्डरों के लिए किया जाता है। इसका मतलब है कि XBMC ऐसे फ़ोल्डर और फ़ाइलों को खोजता है जो सीधे प्लगइन कोड में उन्हें इंगित किए बिना। "सेवा"! = "आवश्यक", और सरल प्लगइन्स में कोई सेवा फ़ाइलें नहीं हो सकती हैं।

सामान्य जानकारी

अजगर को XBMC प्लगइन्स लिखने के लिए उपयोग किया जाता है। Windows के तहत XBMC 2.7 संस्करण के साथ संकलित करता है, और लिनक्स के तहत, जैसा कि मैं इसे समझता हूं, पायथन संस्करण विधानसभा में उपयोग किए गए स्थापित विकास पुस्तकालयों पर निर्भर करता है। किसी भी स्थिति में, प्लग-इन कोड लिखते समय, आपको पायथन 2.7 की वाक्य रचना और क्षमताओं पर ध्यान देना चाहिए।
XBMC में पायथन पूरी तरह से कार्यात्मक है: लगभग पूरे मानक पुस्तकालय है, सिवाय, शायद, टिंकर / ttk / tix (जो स्पष्ट रूप से यहां बहुत ही शानदार हैं)। XBMC के साथ बातचीत करने के लिए पांच मॉड्यूल जोड़े गए हैं: xbmc, xbmcgui, xbmcplugin, xbmcaddon और xbmcvfs, जो एक साथ XBMC पायथन एपीआई बनाते हैं। मॉड्यूल पर एक संक्षिप्त संदर्भ यहां पाया जा सकता है । दुर्भाग्य से, प्रमाण पत्र में गलतियां हैं।
इसके अलावा, कंसोल के बजाय प्रिंट स्टेटमेंट XBMC लॉग को सूचना स्तर के साथ लिखता है, जिसका उपयोग डिबगिंग के दौरान किया जा सकता है, उदाहरण के लिए, आउटपुट वेरिएबल मान के लिए।
शब्दावली के बारे में थोड़ा: शुरू में, एक्सबीएमसी के डेवलपर्स ने किसी भी ऐड-ऑन के लिए "एडऑन" शब्द का इस्तेमाल किया, जो बदले में प्लग-इन (सामग्री स्रोतों), स्क्रिप्ट (प्रोग्राम), स्क्रैपर्स (मीडिया सामग्री के लिए लोडर) और अन्य में विभाजित हैं। हालांकि, समय के साथ, "एडऑन" और "प्लग-इन" की अवधारणाएं भ्रमित होती हैं, और अब वे अक्सर किसी भी ऐड-ऑन को संदर्भित करने के लिए उपयोग की जाती हैं।

आईडीई सेटअप

जैसा कि पहले ही उल्लेख किया गया है, पायथन में XBMC प्लगइन्स लिखे गए हैं। इस भाषा में एक कार्यक्रम अनिवार्य रूप से एक पाठ फ़ाइल है जिसे आप किसी भी पाठ संपादक के साथ काम कर सकते हैं, जो विंडोज नोटपैड से शुरू होता है और "उन्नत विकल्प" के साथ समाप्त होता है, जैसे कि नोटपैड ++। हालांकि, किसी भी अधिक या कम जटिल कोड को लिखने के लिए, IDE (एकीकृत विकास पर्यावरण) का उपयोग करना बेहतर है, जो कई सुविधाएं प्रदान करता है: कोड हाइलाइटिंग, कीवर्ड पूरा करना, कोड ब्राउज़र, वस्तुओं पर एक संक्षिप्त संदर्भ, आदि। कई पायथन प्रोग्रामर अक्सर एक गुच्छा का उपयोग करते हैं। ग्रहण + PyDev, लेकिन व्यक्तिगत रूप से, मैं लाइटर PyScripter को पसंद करता हूं, जिसमें एक पूर्ण आईडीई के लगभग सभी कार्य हैं, सिवाय, शायद, कोड (कोड तह)। यह सच है कि परियोजना 2012 से विकसित नहीं हो रही है, लेकिन पायथन 2.x के लिए इसकी क्षमताएं पर्याप्त से अधिक हैं।
आईडीई में पायथन में प्लगइन्स के विकास की सुविधा के लिए, अच्छे लोगों (मेरे सहित) ने पायथन प्लग-इन का एक सेट संकलित किया है जो एक्सबीएमसी पायथन एपीआई के वास्तविक मॉड्यूल की नकल करता है। इन मॉड्यूल को परियोजना आयात पथों में जोड़ा जाना चाहिए ("गुण"> "PYTHONPATH"> "स्रोत फ़ोल्डर्स" ग्रहण / PyDev या "अतिरिक्त पायथन पथ ..." PyScripter में), और हमें लाभ मिलता है - कोड पूरा होने और कक्षाओं के लिए एक संक्षिप्त मदद काम करना शुरू। XBMC पायथन एपीआई तरीके और अन्य तत्व।

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

प्लगइन संरचना

मेरे "प्रशिक्षण" प्लगइन में निम्नलिखित संरचना है:

addon.xml changelog.txt default.py fanart.jpg icon.png License.txt \resources\ settings.xml \language\ \English strings.po \Russian\ strings.po \Ukrainian\ strings.po \lib\ feeds.py \thumbnails\

अब इन सभी फ़ाइलों और फ़ोल्डरों के उद्देश्य के बारे में और अधिक।

addon.xml

addon.xml प्लग-इन सेवा फ़ाइल है जिसमें अंतर्निहित XBMC प्लग-इन सभी आवश्यक जानकारी लेता है। यह केवल आवश्यक प्लग-इन फ़ाइल है, और कुछ प्रकार के प्लग-इन (स्क्रैपर्स, रिपॉजिटरी, आदि) में प्रोग्राम कोड या अन्य सेवा फाइलें बिल्कुल नहीं हो सकती हैं।

फ़ाइल सामग्री:

 <?xml version="1.0" encoding="UTF-8"?> <!--   --> <addon id="plugin.video.cnet" version="0.0.1" name="CNET Video Podcasts" provider-name="Roman_V_M"> <!--  --> <requires> <import addon="xbmc.python" version="2.1"/> </requires> <!--  ()  --> <extension point="xbmc.python.pluginsource" library="default.py"> <provides>video</provides> </extension> <!--  --> <extension point="xbmc.addon.metadata"> <summary lang="en">CNET Video Podcasts</summary> <summary lang="ru">- CNET</summary> <summary lang="uk">і- CNET</summary> <description lang="en">Addon for watching CNET video podcasts from XBMC.</description> <description lang="ru">   - CNET  XBMC.</description> <description lang="uk">   і-і CNET  XBMC.</description> <platform>all</platform> </extension> </addon>

अब सामग्री के बारे में अधिक। लाइन नंबर प्रदर्शित करने के लिए, इस सुविधा का समर्थन करने वाले टेक्स्ट एडिटर में फ़ाइल खोलें।

लाइनों 3-6 में प्लगइन के बारे में बुनियादी जानकारी होती है: एक अद्वितीय पहचानकर्ता जो प्लगइन फ़ोल्डर के नाम से मेल खाता है; संस्करण; XBMC इंटरफ़ेस पर प्रदर्शित नाम; प्लगइन के लेखक।

लाइनों 8-10 में बाहरी निर्भरता के बारे में जानकारी होती है - काम करने के लिए प्लगइन के लिए आवश्यक अन्य घटक। जैसा कि आप देख सकते हैं, इस प्लगइन को केवल XBMC पायथन एपीआई संस्करण 2.1 की आवश्यकता है। यह संस्करण XBMC 13.x (गोथम) में समर्थित है।
यदि आपके प्लग-इन को किसी अन्य प्लग-इन की आवश्यकता है, तो हम इसे उसी टैग में यहाँ इंगित करते हैं। उदाहरण के लिए, यदि किसी कारण से आपके प्लगइन को Youtube प्लगइन की आवश्यकता होती है, तो निम्न टैग को अनुभाग में जोड़ें:

 <import addon="plugin.video.youtube" version="4.0.0"/>

प्लगइन स्थापित करते समय सैद्धांतिक रूप से, लापता निर्भरता स्वचालित रूप से स्थापित की जानी चाहिए।

12-14 लाइनों में प्लगइन के प्रकार के बारे में जानकारी होती है। extension point="xbmc.python.pluginsource" अर्थ है कि यह एक सामग्री स्रोत प्लगइन है, library="default.py" एक प्लगइन आरंभ स्क्रिप्ट को इंगित करता है, और वीडियो का अर्थ है कि यह एक वीडियो प्लगइन है। यदि प्लगइन अलग-अलग सामग्री तक पहुंच प्रदान करता है, तो टैग में आप रिक्त स्थान द्वारा अलग-अलग उपलब्ध सामग्री के प्रकार निर्दिष्ट कर सकते हैं। संभावित मूल्य वीडियो, संगीत और छवि हैं। ये मान निर्धारित करते हैं कि यह प्लगइन किस अनुभाग में प्रदर्शित किया जाएगा: "वीडियो", "संगीत" या "फोटो"। विभिन्न प्रकार की सामग्री तक पहुँचने के लिए एक प्लगइन कई वर्गों में प्रदर्शित किया जा सकता है।
जैसा कि पहले ही उल्लेख किया गया है, "xbmc.python.pluginsource" का अर्थ है कि यह एक सामग्री स्रोत प्लगइन है। यही है, XBMC डेवलपर्स की शब्दावली का उपयोग करते हुए, यह स्क्रिप्ट और अन्य प्रकार के ऐड-ऑन के विपरीत एक वास्तविक प्लग-इन है। स्रोत प्लग-इन और स्क्रिप्ट प्लग-इन (सॉफ़्टवेयर प्लग-इन) के बीच मुख्य अंतर यह है कि स्रोत प्लग-इन उपयोगकर्ता को बहु-स्तरीय सूचियों (निर्देशिका) के रूप में मल्टीमीडिया सामग्री के साथ प्रस्तुत करता है जिसमें फ़ोल्डर (आभासी और / या वास्तविक) और फाइलें (स्थानीय और / या) होती हैं। नेटवर्क पर), जबकि स्क्रिप्ट में एक मनमाना इंटरफ़ेस हो सकता है (एपीआई की क्षमताओं के भीतर) या बिल्कुल नहीं। प्रोग्राम स्क्रिप्ट के मामले में, दोहरे उद्धरण चिह्नों में पैरामीटर "xbmc.python.script" और टैग में दिखेगा

    executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .

executable, . .:
<extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension>
«». - «», «» «» (video, music image ), - , runtime- ( ).

.

16—22 . XBMC. 23 , .

icon.png
icon.png — () , XBMC. — PNG 256x256 .

fanart.jpg
fanart.jpg — (), . — JPG 1280x720 . : (). , «» , / .

changelog.txt
changelog.txt .

License.txt
License.txt . , . , , XBMC.

default.py
default.py — . «default.py» , ( library= extension), default.py, — , .
- PEP 8, , ____, .

: # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html # import sys, os, urllib2, socket, xml.dom.minidom # XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui # _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') # sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds # def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') # URL-encoded def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name # RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing # ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) # . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) # . . list_item.setProperty('fanart_image', fanart) # URL, . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') # . isFolder=True , (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) # -- , . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) # xbmcplugin.endOfDirectory(addon_id) # . switch_view() # . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') # "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') # "-" # . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: # . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) # . . list_item.setProperty('fanart_image', fanart) # . isFolder=False , . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) # . xbmcplugin.endOfDirectory(addon_id) def main(): # . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') # . feed = get_feed_name() # XBMC ( ), . if feed: # . quality = _addon.getSetting('quality') # . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: # . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) # . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: # ( ), xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) # XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: # XBMC ( ), , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) # . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main()

. .

11—15 — . , , , , PEP 8.

:

11: . , addon.xml, ( ).

12: Addon .

13: runtime- (handle). — , 2- XBMC. addDirectoryItem(). . , - - , - () , XBMC API. , . XBMC ( ) - 3 sys.argv: URL, runtime- (, ), URL-encoded . -, , , sys.argv . , runtime- , addDirectoryItem(), - . URL .

14: URL . URL ''plugin://'' + ( ) + ''/''. URL : "plugin://plugin.video.cnet/". URL ( ) , . , , , XBMC , ( — ) . , , .
(), , . , «», «» «» XBMC « », , , . - , — , — , . , (- ) — XBMC. «» , ( ) . . addDirectoryItem() , . .

15: getAddonInfo('path') , , , , . : Windows, ( , ASCII), , (exeption). , Windows . decode('utf-8'). , , Windows.
getAddonInfo('path') — ( XBMC) . os.path.dirname(__file__) , os.getcwd() . , , , XBMC.

18—19: feeds /resources/lib. cnet.com, URL (dictionary). , , — www.cnet.com/podcasts — , — , , .

22—23: . .getLocalizedString() , UTF-8. , , , , .

26—32: - URL-encoded . - , . , XBMC URL-encoded . URL (. ) URL-encoded .
. , plugin.video.acme, , , . «Action» «Movies» plugin://plugin.video.acme/?=Movies&=Action. addDirectoryItem ( ). , plugin.video.acme, sys.argv[2] «?=Movies&=Action». , , , : XBMC . XBMC (, ), , , (, «Action» «Movies»). .
: , . URL, plugin://.
: xbmcplugin.addDirectoryItem, - , isFolder=False. isFolder=True XBMC , .

35—49: RSS- . XML - . , - (, , ).

52—64: cnet.com — , . .

57: xbmcgui.ListItem. , . , , , () ().

59: . , , .

61: . . , .

63: . , sys.argv[1]. , - . , addDirectoryItem() . isFolder=True XBMC, — , . . , . url , , .

65: . , , .

67: XBMC, .

69: (). , , ( , ), , , , . Container.SetViewMode() , MyVideoNav.xml, MyMusicNav.xml MyPics.xml , .
, . — Youtube.

72—77: . . 500 «» Confluence, 512 — «-» «Aeon-Nox». .

80—89: , . , feed_list(), , URL isFolder False, . . ( ) , .
: isFolder=False , , xbmcplugin.addDirectoryItem. , ( ). xbmcplugin.addDirectoryItem .

92—119: . , . .

101: , . , , .

114: XBMC. _string(), XBMC. .

\resources
\resources — , .

settings.xml
settings.xml — , , XML, , «». «» .

: <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings>

— (labelenum) (HD SD). label= , , . id="" (. 101 default.py).
settings.xml « XBMC Addon Developers Guide » ( ). , , .
XML \userdata\addon_data\ XBMC. Windows , , %AppData%\XBMC, Linux — $HOME/.xbmc.

\language
\language . , , , , strings.po. \English, \Russian \Ukrainian, . . , . , , \English . , , .

strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr " ."

, .po GNU Gettext. XBMC Gettext: .mo, , msgctxt. : XBMC XML, www.transifex.net . -, .po , Gettext.
, getLocalizedString() msgctxt. : XBMC + . , . , , , , , . .
, . , .
, settings.xml .
, XBMC, . .

\lib
\lib , . \lib . , : , . . , . , , , , , , .

\thumbnails
\thumbnails cnet.com. \lib, , .


. XBMC. ( XBMC " "). print xbmc.log().
XBMC.
, XBMC Eclipse + PyDev. .


XBMC . , , . «» .
, , , .


, , Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development
«XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL
XBMC Python API: mirrors.xbmc.org/docs/python-docs

PS
Post factum . . XBMC , . .


XBMC : I — .

    executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .     executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     . 
    executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .     executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     . 
    executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .     executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     . 
    executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .     executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     . 
    executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .     executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     . 
    executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .     executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .     executable, . .: 
 <extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension> 
      «». -       «», «»  «» (video, music  image    ),       -    ,     runtime- (  ). 
 
        . 
 
  16—22         .      XBMC.   23 ,      . 
 
 icon.png 
 icon.png —     () ,     XBMC.   — PNG 256x256           . 
 
 fanart.jpg 
 fanart.jpg —     (),         .   — JPG 1280x720 . :         (). ,  «» , /  . 
 
 changelog.txt 
   changelog.txt       . 
 
 License.txt 
  License.txt    .    ,       .  ,    ,          XBMC. 
 
 default.py 
  default.py —   .   «default.py»  ,         (   library=   extension),    default.py, — ,  . 
      -  PEP 8,   ,           ____,      . 
 
  : # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html #      import sys, os, urllib2, socket, xml.dom.minidom #    XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui #    _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') #    sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds #       def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') #  URL-encoded    def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name #  RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing #      ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) #   . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) # URL,        . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') #     . isFolder=True ,    (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) #   --  ,  . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) #   xbmcplugin.endOfDirectory(addon_id) #    . switch_view() #         . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') #  "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') #  "-" #   . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: #   . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) #  . . list_item.setProperty('fanart_image', fanart) #    . isFolder=False ,     . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) #  . xbmcplugin.endOfDirectory(addon_id) def main(): #   . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') #        . feed = get_feed_name() #      XBMC ( ),     . if feed: #       . quality = _addon.getSetting('quality') #   . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: #   . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) #   . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: #      ( ),      xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) #        XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: #     XBMC ( ),     , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) #     . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main() 
 
   .   . 
 
  11—15 —   .        ,      , ,   ,    PEP 8. 
 
  : 
 
 11:   .      ,   addon.xml,    (      ). 
 
 12:    Addon     . 
 
 13:  runtime-  (handle).  —   ,    2-      XBMC.            addDirectoryItem().        .    ,   -   -   ,   -    () ,                 XBMC API.      ,  .     XBMC       (  ) -  3    sys.argv:   URL, runtime- (,   ),       URL-encoded . -,   ,    ,    sys.argv    .    ,  runtime-    ,  addDirectoryItem(),  -   .   URL     . 
 
 14:   URL .  URL      ''plugin://'' + ( ) + ''/''.  URL     : "plugin://plugin.video.cnet/".  URL        (   )   ,  .  , ,   , XBMC  ,    ( — )        . ,  ,   . 
   (),  ,         .  ,       «», «»  «» XBMC    « »,      ,         ,  .            -  ,      —    ,   —   ,    . ,    (- ) —                XBMC.    «» ,               (  ) .           .  addDirectoryItem()        ,    .    . 
 
 15:  getAddonInfo('path')     ,    , ,      ,     .       :  Windows,       (   ,   ASCII),     ,            (exeption).    ,    Windows   .        decode('utf-8').  ,     ,           Windows. 
   getAddonInfo('path') —    (   XBMC)    .  os.path.dirname(__file__)   ,  os.getcwd()   . ,  ,     ,  XBMC. 
 
 18—19:    feeds   /resources/lib.      cnet.com,  URL        (dictionary). , ,      — www.cnet.com/podcasts —     ,     — ,     ,        . 
 
 22—23:      .  .getLocalizedString()         ,           UTF-8.     ,  ,  ,   ,     . 
 
 26—32: -      URL-encoded .       - ,   .    ,       XBMC              URL-encoded .          URL     (. )  URL-encoded   . 
   . ,     plugin.video.acme,        ,   ,        .      «Action»  «Movies»    plugin://plugin.video.acme/?=Movies&=Action.      addDirectoryItem      (   ). ,           plugin.video.acme,    sys.argv[2]    «?=Movies&=Action».   ,        ,  ,    :   XBMC  .    XBMC       (,    ),    , ,      (,     «Action»  «Movies»).        . 
 :            ,     .         URL,   plugin://. 
 :             xbmcplugin.addDirectoryItem,    -  ,  isFolder=False.  isFolder=True XBMC    ,       . 
 
 35—49:  RSS-     .      XML   - .         ,      -            (, , ). 
 
 52—64:       cnet.com —  ,   .   . 
 
 57:          xbmcgui.ListItem.           ,   .    ,  ,  ,          ()   (). 
 
 59:     .  ,       ,         . 
 
 61:      .            . ,            . 
 
 63:      .      ,   sys.argv[1]. ,      - . ,       addDirectoryItem()  .  isFolder=True  XBMC,     —  , . .         ,       .   url      ,  ,                 . 
 
 65:   .   ,         ,    . 
 
 67:  XBMC,    . 
 
 69:     ().   ,  ,      ( ,  ),         ,   ,     ,     .  Container.SetViewMode()          ,      MyVideoNav.xml, MyMusicNav.xml  MyPics.xml    ,    . 
  ,      .       —  Youtube. 
 
 72—77:    .         .  500   «»   Confluence,   512 —  «-»  «Aeon-Nox».         . 
 
 80—89:    ,      .     ,    feed_list(),   ,  URL           isFolder     False, . .    (  )  ,   . 
 :    isFolder=False        ,          ,      xbmcplugin.addDirectoryItem. ,             (     ).  xbmcplugin.addDirectoryItem  . 
 
 92—119:   . ,     .        . 
 
 101:    ,     .       ,       ,  . 
 
 114:       XBMC.         _string(),        XBMC.     . 
 
 \resources 
  \resources — ,        . 
 
 settings.xml 
 settings.xml —  ,     ,   XML,    ,      «».         «»    . 
 
  : <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings> 
 
          —  (labelenum)      (HD  SD).  label=      ,        ,       .           id="" (.  101 default.py). 
     settings.xml         « XBMC Addon Developers Guide » ( ).       ,       ,         . 
        XML   \userdata\addon_data\     XBMC.  Windows ,  , %AppData%\XBMC,  Linux — $HOME/.xbmc. 
 
 \language 
  \language  .  ,    ,  ,     ,     strings.po.      \English, \Russian  \Ukrainian, . .     ,    . ,   ,      \English    . ,          ,     . 
 
     strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr "     ." 
 
  ,    .po GNU Gettext.  XBMC    Gettext:      .mo,        ,    msgctxt.     :  XBMC        XML,        www.transifex.net          . -,        .po   ,     Gettext. 
    ,     getLocalizedString()    msgctxt.     :    XBMC +   . ,          .  ,           , ,  ,   ,      .        . 
         ,      . ,      . 
                ,         settings.xml      . 
  ,            XBMC,         .              . 
 
 \lib 
   \lib     ,   .  \lib  .     ,        :     ,      . . ,      . ,  , ,     ,  ,   ,    . 
 
 \thumbnails 
   \thumbnails      cnet.com.   \lib,    ,           . 
 
  
     .         XBMC.        (    XBMC   "  ").           print   xbmc.log(). 
        XBMC. 
  , XBMC      Eclipse + PyDev.       . 
 
  
        XBMC .    ,     ,    .        «»   . 
   ,     ,    ,      . 
 
   
 ,   ,   Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development 
  «XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL 
     XBMC Python API: mirrors.xbmc.org/docs/python-docs 
 
 PS 
 Post factum   .       .   XBMC     ,      .          . 
 
  
    XBMC   :  I —     .

executable, . .:
<extension point="xbmc.python.script" library="default.py"> <provides>executable</provides> </extension>
«». - «», «» «» (video, music image ), - , runtime- ( ).

.

16—22 . XBMC. 23 , .

icon.png
icon.png — () , XBMC. — PNG 256x256 .

fanart.jpg
fanart.jpg — (), . — JPG 1280x720 . : (). , «» , / .

changelog.txt
changelog.txt .

License.txt
License.txt . , . , , XBMC.

default.py
default.py — . «default.py» , ( library= extension), default.py, — , .
- PEP 8, , ____, .

: # -*- coding: utf-8 -*- # Name: plugin.video.cnet # Licence: GPL v.3: http://www.gnu.org/copyleft/gpl.html # import sys, os, urllib2, socket, xml.dom.minidom # XBMC import xbmc, xbmcplugin, xbmcaddon, xbmcgui # _ADDON_NAME = 'plugin.video.cnet' _addon = xbmcaddon.Addon(id=_ADDON_NAME) _addon_id = int(sys.argv[1]) _addon_url = sys.argv[0] _addon_path = _addon.getAddonInfo('path').decode('utf-8') # sys.path.append(os.path.join(_addon_path, 'resources', 'lib')) import feeds # def _string(string_id): return _addon.getLocalizedString(string_id).encode('utf-8') # URL-encoded def get_feed_name(): paramstring = sys.argv[2] if paramstring: feed_name = feeds.NAMES[paramstring.replace('?feed=', '')] else: feed_name = '' return feed_name # RSS- def rss_parser(url): listing = [] try: HEADER = {'User-Agent' : 'Mozilla/5.0 (Windows NT 6.1; rv:18.0) Gecko/20100101 Firefox/20.0'} request = urllib2.Request(url, None, HEADER) rss = xml.dom.minidom.parse(urllib2.urlopen(request, None, 3)) except urllib2.URLError, socket.timeout: pass else: titles = rss.getElementsByTagName('title') links = rss.getElementsByTagName('link') for title, link in zip(titles[2:], links[2:]): title = title.toxml().replace('<title><![CDATA[', '').replace(']]></title>', '') link = link.toxml().replace('<link>', '').replace('</link>', '') listing.append([title, link]) return listing # ( ). def feed_list(addon_id, addon_url, fanart, thumbpath, feeds): names = dict.keys(feeds) for name in names: thumb = os.path.join(thumbpath, feeds[name]['thumb']) # . list_item = xbmcgui.ListItem(name, thumbnailImage=thumb) # . . list_item.setProperty('fanart_image', fanart) # URL, . url = addon_url + '?feed=' + name.replace(' ', '').replace('*', '') # . isFolder=True , (). xbmcplugin.addDirectoryItem(addon_id, url, list_item, isFolder=True) # -- , . xbmcplugin.addSortMethod(addon_id, xbmcplugin.SORT_METHOD_LABEL_IGNORE_THE) # xbmcplugin.endOfDirectory(addon_id) # . switch_view() # . def switch_view(): skin_used = xbmc.getSkinDir() if skin_used == 'skin.confluence': xbmc.executebuiltin('Container.SetViewMode(500)') # "". elif skin_used == 'skin.aeon.nox': xbmc.executebuiltin('Container.SetViewMode(512)') # "-" # . def podcast_list(addon_id, fanart, thumb, listing): for item in listing: # . list_item = xbmcgui.ListItem(item[0], thumbnailImage=thumb) # . . list_item.setProperty('fanart_image', fanart) # . isFolder=False , . xbmcplugin.addDirectoryItem(addon_id, item[1], list_item, isFolder=False) # . xbmcplugin.endOfDirectory(addon_id) def main(): # . thumbpath = os.path.join(_addon_path, 'resources', 'thumbnails') fanart = os.path.join(_addon_path, 'fanart.jpg') # . feed = get_feed_name() # XBMC ( ), . if feed: # . quality = _addon.getSetting('quality') # . listing = rss_parser(url=feeds.FEEDS[feed][quality]) if listing: # . xbmc.log('%s: Started - Opening podcasts List' % _ADDON_NAME, xbmc.LOGNOTICE) thumb = os.path.join(thumbpath, feeds.FEEDS[feed]['thumb']) # . podcast_list(addon_id=_addon_id, fanart=fanart, thumb=thumb, listing=listing) else: # ( ), xbmc.log('%s: Failed to retrieve %s feed data!' % (_ADDON_NAME, feed), xbmc.LOGERROR) # XBMC. xbmc.executebuiltin('Notification(%s,%s)' % (_string(100501), _string(100502))) else: # XBMC ( ), , xbmc.log('%s: Started - Opening feeds List' % _ADDON_NAME, xbmc.LOGNOTICE) # . feed_list(addon_id=_addon_id, addon_url=_addon_url, fanart=fanart, thumbpath=thumbpath, feeds=feeds.FEEDS) if __name__ == '__main__': main()

. .

11—15 — . , , , , PEP 8.

:

11: . , addon.xml, ( ).

12: Addon .

13: runtime- (handle). — , 2- XBMC. addDirectoryItem(). . , - - , - () , XBMC API. , . XBMC ( ) - 3 sys.argv: URL, runtime- (, ), URL-encoded . -, , , sys.argv . , runtime- , addDirectoryItem(), - . URL .

14: URL . URL ''plugin://'' + ( ) + ''/''. URL : "plugin://plugin.video.cnet/". URL ( ) , . , , , XBMC , ( — ) . , , .
(), , . , «», «» «» XBMC « », , , . - , — , — , . , (- ) — XBMC. «» , ( ) . . addDirectoryItem() , . .

15: getAddonInfo('path') , , , , . : Windows, ( , ASCII), , (exeption). , Windows . decode('utf-8'). , , Windows.
getAddonInfo('path') — ( XBMC) . os.path.dirname(__file__) , os.getcwd() . , , , XBMC.

18—19: feeds /resources/lib. cnet.com, URL (dictionary). , , — www.cnet.com/podcasts — , — , , .

22—23: . .getLocalizedString() , UTF-8. , , , , .

26—32: - URL-encoded . - , . , XBMC URL-encoded . URL (. ) URL-encoded .
. , plugin.video.acme, , , . «Action» «Movies» plugin://plugin.video.acme/?=Movies&=Action. addDirectoryItem ( ). , plugin.video.acme, sys.argv[2] «?=Movies&=Action». , , , : XBMC . XBMC (, ), , , (, «Action» «Movies»). .
: , . URL, plugin://.
: xbmcplugin.addDirectoryItem, - , isFolder=False. isFolder=True XBMC , .

35—49: RSS- . XML - . , - (, , ).

52—64: cnet.com — , . .

57: xbmcgui.ListItem. , . , , , () ().

59: . , , .

61: . . , .

63: . , sys.argv[1]. , - . , addDirectoryItem() . isFolder=True XBMC, — , . . , . url , , .

65: . , , .

67: XBMC, .

69: (). , , ( , ), , , , . Container.SetViewMode() , MyVideoNav.xml, MyMusicNav.xml MyPics.xml , .
, . — Youtube.

72—77: . . 500 «» Confluence, 512 — «-» «Aeon-Nox». .

80—89: , . , feed_list(), , URL isFolder False, . . ( ) , .
: isFolder=False , , xbmcplugin.addDirectoryItem. , ( ). xbmcplugin.addDirectoryItem .

92—119: . , . .

101: , . , , .

114: XBMC. _string(), XBMC. .

\resources
\resources — , .

settings.xml
settings.xml — , , XML, , «». «» .

: <?xml version="1.0" encoding="UTF-8"?> <settings> <category label="128"> <setting id="quality" type="labelenum" label="100500" values="HD|SD" default="HD" /> </category> </settings>

— (labelenum) (HD SD). label= , , . id="" (. 101 default.py).
settings.xml « XBMC Addon Developers Guide » ( ). , , .
XML \userdata\addon_data\ XBMC. Windows , , %AppData%\XBMC, Linux — $HOME/.xbmc.

\language
\language . , , , , strings.po. \English, \Russian \Ukrainian, . . , . , , \English . , , .

strings.po: # XBMC Media Center language file msgid "" msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Language: ru\n" msgctxt "#100500" msgid "Quality:" msgstr ":" msgctxt "#100501" msgid "Access error!" msgstr " !" msgctxt "#100502" msgid "Failed to retrieve the feed data." msgstr " ."

, .po GNU Gettext. XBMC Gettext: .mo, , msgctxt. : XBMC XML, www.transifex.net . -, .po , Gettext.
, getLocalizedString() msgctxt. : XBMC + . , . , , , , , . .
, . , .
, settings.xml .
, XBMC, . .

\lib
\lib , . \lib . , : , . . , . , , , , , , .

\thumbnails
\thumbnails cnet.com. \lib, , .


. XBMC. ( XBMC " "). print xbmc.log().
XBMC.
, XBMC Eclipse + PyDev. .


XBMC . , , . «» .
, , , .


, , Wiki XBMC: http://wiki.xbmc.org/index.php?title=Category:Addon_Development
«XBMC Addon Developers Guide»: yadi.sk/d/NvfFuXYw92paL
XBMC Python API: mirrors.xbmc.org/docs/python-docs

PS
Post factum . . XBMC , . .


XBMC : I — .

एक्सबीएमसी के लिए एक सरल प्लगइन का विस्तृत शरीर रचना विज्ञान

प्रस्तावना

सामान्य जानकारी

आईडीई सेटअप

प्लगइन संरचना

addon.xml

More articles: