23.4.2023, 11:45
(Tento příspěvek byl naposledy změněn: 17.5.2023, 17:31 uživatelem JiRo.
Důvod úpravy: Překlepy, doplnění informace.
)
Doplněk přidává do kontextového menu Kodi další položky, které nabízejí řadu specifických a dále popsaných funkcí. Koncepce řešení umožňuje autorovi přidávat další funkce dle libosti a možností, které Kodi nabízí. Doplněk využívá možnost definice kontextového menu nezávislého na konkrétním doplňku, přímo v jeho definičním souboru addon.xml. Z tohoto pohledu je množina funkcí otevřená a pokud někdo přijde s nápadem, jakou funkci by bylo vhodné doplnit, stačí v tomto tématu námět zveřejnit návrh a já se o to (pokud to funkce Kodi dovolí) pokusím.
Historie
Na konec nezbytného úvodu něco málo k historii. Doplněk Context Menu jsem v základní a velmi primitivní podobě více než rok používal v instalcích Kodi mých přátel a známých, a také samozřejmě mých vlastních. Teprve dotaz a námět v příspěvku Context menu add-on mě inspiroval k doplnění a rozšíření funkcí do (zatím) konečné podoby. Děkuji tímto @MiLaCzech: nejen za inspiraci, ale také za pomoc při odladění funkce přepínání výběru streamu v doplňku Stream Cinema Community.
Popis řešení a funkcí
V doplňku v současné verzi fungují tři úrovně výběru položek v menu (aplikují se v uvedeném pořadí):
- podle nastavení doplňku - to umožňuje uživateli vybrat si, které položky v menu mohou být zobrazeny
- podle stavu dalších doplňků - pokud je položka v menu vázána na nějaký další doplněk, kontroluje se, zda je doplněk instalovaný a povolený a pokud tomu tak není, tak se položka v menu neobjeví
- podle okamžitého kontextu - zobrazení položek v menu může být podmíněno aktuálním obsahem položky v seznamu, na které bylo kontextové menu vyvoláno
Uživatelsky definované položky
Od verze 0.1.4 včetně umožňuje doplněk uživatelsky definovat další položky kontextového menu. V současné chvíli je možné definovat až 4 položky a každou z nich umístit do jedné ze čtyř pozic (viz Dostupné položky a jejich funkce níže). Pro každou položku je možné v nastavení doplňku definovat:
- Povolení položky - povoluje její zobrazení ve zvolené pozici - defaultně Nepovoleno, tzn. položka nebude zobrazena
- Pozice - definuje pozici zobrazení položky v jedné ze čtyř pozic označených jako Horní, 1/4, 3/4 a Dolní) - defaultně Nedefinovaná, tzn. položka nebude zobrazena
- Název - označení položky v kontextovém menu - defaultně prázdný řetězec
- Styl - stylu fontu názvu Normální, Tučné, Kurzíva a Tučná kurzíva - defaultně Normální
- Barva - barva fontu názvu Bílá, Šedá, Modrá, Zelená, Žlutá a Červená - defaultně Bílá
- Příkaz - Kodi built-in příkaz, který se vykoná při aktivaci položky kontexového menu - defaultně prázdný řetězec.
- Aby se daná položka v kontextovém menu zobrazila je třeba současně jak Povolení položky, tak vybrat jednu ze čtyř pozic jejího umístění (tedy jinou než defaultně Nedefinovaná)
- Položky se, kromě možnosti každou povolit či zakázat, zobrazují nepodmíněně a není možné (v dané chvíli) žádnou podmínku (odvozenou od aktuálního kontextu) pro jejich (ne)zobrazení definovat. Původně jsem si myslel, že to půjde, ale ukázalo se, že je to jen velmi obtížně realizovatelné. Zatím to tedy spadá do oblasti To-Do.
- Seznam Kodi built-in příkazů najdete ve Wiki Kodi v List of built-in functions, v kombinaci s příkazem Action() je pak možné použít i Action IDs.
- Uživatelsky definované položky - pozice označená jako Horní
- Automatický výběr streamu SCC pro přehrávání - změní stav Automatický výběr streamu pro přehrávání v nastavení doplňku SCC v sekci Streamy. Funguje jako tzv. "toggle". Zároveň se v kontextovém menu zobrazuje stav do kterého se po jeho aktivaci nastavení přepne (AUTO/RUČNĚ).
- Automatický výběr streamu SCC pro stahování - změní stav Automatický výběr streamu pro stahování v nastavení doplňku SCC v sekci Streamy. Funguje jako tzv. "toggle". Zároveň se v kontextovém menu zobrazuje stav do kterého se po jeho aktivaci nastavení přepne (AUTO/RUČNĚ).
- Uživatelsky definované položky - pozice označená jako 1/4
- Hudba na pozadí prezentace
- Přehrát upoutávku - spustí přehrávání upoutávky (trailer-u), pokud existuje. V tomto případě se (zatím) v doplňku nekontroluje, zda jsou případně k dispozici doplňky, kterými se upoutávky přehrávají (Youtube, Tubed atp.)
- Item Info
- Hledat v SCC - spustí funkci Hledat z doplňku SCC, s volitelnou možností převzít jako parametr hledání text aktuální položky - Pozn. 1
- Hledat na Webshare - spustí funkci Hledat na Webshare z doplňku SCC, s volitelnou možností převzít jako parametr hledání text aktuální položky - Pozn. 1
- [NEW] Hledat v SC - spustí funkci Hledat z doplňku SC, s volitelnou možností převzít jako parametr hledání text aktuální položky - Pozn. 3
- Hledat na Youtube - spustí funkci Hledat z doplňku Youtube, s volitelnou možností převzít jako parametr hledání text aktuální položky - Pozn. 2
- Obnovení obsahu - provede tzv. Refresh, tedy nové načtení aktuálně zobrazeného seznamu
- Odstranit - u položky, kde je to v rámci Kodi možné a povolené, se provede její "odstranění". Odstraněním je míněná akce (Action ID Delete) v daném kontextu, dle typu a stavu položky. Pokdu není v daném kontextu tato akce definovaná, neprovede se samozřejmě nic.
- Uživatelsky definované položky - pozice označená jako 3/4
- Nastavení doplňku - spustí funkci nastavení doplňku v případě, že aktuálně zobrazený seznam byl nějakým doplňkem vytvořený
- Nastavení Kodi - spustí funkci nastavení Kodi
- Nastavení menu - spustí funkci nastavení doplňku Context Menu
- Uživatelsky definované položky - pozice označená jako Dolní
Pozn. 1: předpokládá instalovaný doplněk Stream Cinema Community
Pozn. 2: předpokládá instalovaný doplněk Youtube
Pozn. 3: předpokládá instalovaný doplněk Stream Cinema CZ a SK
Každou z funkcí, kromě těch aktuálně zablokovaných, je možné v nastavení doplňku Context Menu povolit či zakázat. Pokud je zakázána, tak se v kontext menu, i když budou ostatní podmíny k jejímu zobrazení splněny, nezobrazí.
Instalace
Doplněk je určen pouze pro Kodi verze 20 (Nexus) a případně vyšší. Důvodem je, že používá funkce, které jsou v Kodi dostupné právě od této verze. Úpravu doplňku pro nižší verze Kodi nepředpokládám.
V současné chvíli je doplněk v Alpha verzi a proto je jeho instalace možná pouze z níže připojeného zip souboru. I případné aktualizace budou tedy přidávány zatím pouze do tohoto příspěvku. Předpokládám, že v nějaké dohledné době doplněk umístím na Github a poté i do repozitáře XBMC-Kodi CZ/SK, a pak už vše bude fungovat standardně dle očekávání a pravidel. Budu o tom v tomto tématu informovat.
Doplněk se v Kodi instaluje do sekce Místní nabídky/Context Menus. Po první instalaci je třeba restartovat Kodi a doporučuji restartovat Kodi i po každé další instalaci. Tento postup je třeba provést s ohledem na funkce Kodi, které jsou v tomto doplňku použity. Konkrétně jde o změny, kdy v nové verzi doplňku dojde ke změně v definici položek kontextového menu v addon.xml. Tato změna se totiž v Kodi projeví až po dalším spuštění Kodi, následující po této instalaci.
Update
Nová verze 0.1.8 (2023-05-17) se změnami:
- přidáno vyhledávání v SC
- vyčištění hledaného textu od formátovacích značek SC
