Integrace hledání v doplňku Stream Cinema Community (SCC)
UPOZORNĚNÍ!
Na základě
zjištění @
rendlt: upozoňuji na to, že uvedená úprava neumožňuje z vyhledaného seznamu jednoduše (výběrem titulu a potvrzením
ENTER/
OK) spouštět seriály. K problematice se detailně vyjařuji v
příspěvku.
Ověřená funkčnost pro skin od verze
0.4.36~nexus.
Nevím od které verze (skin trvale nesleduji), ale určitě od verze 0.4.36~nexus, dříve uvedený postup integrace hledání v doplňku SCC nefunguje. Autor zásadním způsobem změnil některé klíčové funkce skinu. Pro integraci to má spíše pozitivní důsledek, protože se celý proces integrace výrazně zjednodušil.
Co je pro integraci potřeba?
- soubor scc.png s ikonou SCC
- upravený soubor skinvariables-shortcut-config.json
- upravený soubor setup_search_path.json
Všechny tři soubory jsou obsahem zip souboru, který najdete na konci tohoto příspěvku. V zip jsou již umístěny do příslušných adresářů skinu, takže postačí je do skinu, tedy do adresáře
skin.arctic.fuse, po rozbalení nakopírovat 1:1.
V čem spočívá vlastní integrace?
Aby si zkušení uživatelé mohli hledání v SCC integrovat i do novějších verzí skinu, uvádím dále, co je obsahem vlastní integrace. Je samozřejmě nutné mít přehled o tom, jaké změny ve skinu budou dále probíhat a zda nebude nutné celý proces upravit. Popisuji úpravy tak, aby případné úpravy integrace mohl mírně zkušený skinner provést i tehdy, pokud změny budou rozsáhlejší. Nebráním se v případě potřeby pomoci radou, ale rozhodně nebudu další vývoj skinu sledovat a na změny aktivně reagovat. Bude ale stačit, když mě v případě složitějších změn zde upozorníte a jsem pak připraven případně pomoci.
A teď tedy k vlastnímu popisu principu integrace:
ad. 1 soubor s ikonou scc.png
Používé se k zobrazení ikony v případě nastavení widgetu hledání. Pokud tento soubor chybí, nejde o zásadní funkční problém, prostě jen bude místo pro ikonu prázdné.
Soubor s ikonou
scc.png je umístěn v adresáři skinu
extras/icons
ad.2 upravený soubor skinvariables-shortcut-config.json
V tomto souboru se jednak do parametru
"icons" vkládá cesta k souboru s ikonou skinu, viz řádek:
Kód:
"DefaultSCC.png": "special://skin/extras/icons/scc.png",
Já jsem tuto definici umístil hned na první pozici v parametru
"icons", ale je zcela lhostejné, kam bude v tomto parametru vložena.
Dále se v souboru, do parametru
"grouping://shortcuts/search/", vkládá definice položky vlastního wigetu pro výsledky hledání v SCC:
Kód:
{
"name": "SCC",
"icon": "special://skin/extras/icons/scc.png",
"path": "DefaultSearch-SCC",
"node": "videos",
"link": "true"
},
Já jsem tuto definici umístil hned na první pozici v parametru
"grouping://shortcuts/search/", ale je zcela lhostejné, kam bude v tomto parametru vložena. Umístění na 1. pozici má ale výhodu v tom, že při přidání widgetu s hledáním v SCC se položka objeví 1. v nabídnutém seznamu.
Soubor
skinvariables-shortcut-config.json je umístěn v adresáři skinu
shortcuts.
ad. 3 upravený soubor setup_search_path.json
Klíčový definiční soubor, obsahuje příkazů volání/request rozdělený na dvě části, přičemž se předpokládá, že při konečném sestavení volání/request se mezi tyto dvě části vloží hledaný řetězec. V případě hledání v SCC jde tedy o volání pluginu s příslušnými parametry, na základě kterých plugin vrací obsah container-u s výsledky hledání, které pak skin použije jako parametr pro odpovídající widget.
Obě části volání/request se vloží do paremetru
"widget_path" (1. část):
Kód:
{
"condition": "{item_path}==DefaultSearch-SCC",
"value": "plugin://plugin.video.stream-cinema-2-release/get_media/?media_type=%2A&render_type=search&url=%252Fapi%252Fmedia%252Ffilter%252Fv2%252Fsearch%253Fvalue%253D"
},
a
"widget_path_end" (2. část):
Kód:
{
"condition": "{item_path}==DefaultSearch-SCC",
"value": "%2526order%253Ddesc%2526sort%253Dscore%2526type%253D%25252A%2526size%253D50?"
},
Já jsem tuto definici umístil hned na první pozici v obou parametrech. Ale je úplně jedno, na které pozici bude parametr umístěn. Na nic dalšího to vliv nemá.
Soubor
setup_search_path.json je umístěn v adresáři skinu
shortcuts/template_generator.
Vytvoření widgetu pro zobrazení výsledku hledání v SCC
Poté co se v příslušných adresářích vytvoří resp. upraví (nebo do nich nakopírují) výše uvedení tři soubory, je třeba ještě definovat vlastní widget výsledků hledání. Pro to se použije už standardní funkce nastavení skinu dle následujcíího postupu:
- v hlavním menu zvolit Nastavení, násleně v submenu dále opět Nastavení
- na stránce Nastavení zvolit Vzhled/Nastavení
- na stránce Vzhled Nastavení vybrat Menus a v okně zvolit Customise widgets
- na stránce Upravit: Home zvolit ikonu lupy
- v okně Shortcuts/Hledat > Widgets přidat a nastavit novou položku. V nabízených seznamech už byste měli vidět (vždy na 1. pozici) odpovídající funkce/parametry SCC/DefaultSearch-SCC. Typicky se nastavují položky Shortcut, Styl, Limit, .... Tohle je ale už obvyklý postup, který by uživatel tohoto skinu měl znát, proto se o něm detailně nezmiňuji.
- Postupně s použitím Back se budeš vracet, po zobrazení stránky Vzhled Nastavení se objeví dotaz Rebuild shortcuts/Rebuild shortcuts template to include recent changes?, na který, pokud jsi s nastavením spokojen, dáš Ano. Dojde k rebuildu definičních souborů skinu.
- Nyní už, po dalších Back, se dostaneš na Home stránku skinu a můžete začít funkci Hledat v SCC používat.
. Tahle chyba patrně souvisí s tím, že se do jednoho seznamu (tedy seznamu titulů na základě vyhledaného textu) umisťují jak filmy, tak seriály. Jak jsi ostatně i ty správně identifikovat, "špatný media type" 
. Nejsem teď schopný na to reagovat a s určitostí říci, zda je to jeden z důsledků jednoho z "kostlivců ve skříni SCC", nedržení se zásad a pravidel Kodi (což je evergreen, na který upozorňuji už od jeho vzniku), nebo naopak, podobný druh problému na straně skinu. To si vyžádá asi delší čas a já se tomu budu moci plně věnovat asi až po svátcích.
Pamatuji si, jak se na mě před lety snesla sprška hejtů, že umím jen kritizovat, když jsme poukazoval na takové a podobné problémy plynoucí z nedoržování pravidel a zásad Kodi. Odpovědí autora SCC bylo jeho obligátní "v doplňu to funguje". Bohužel, dnes nás to opět dostihlo. Nejsem si jistý, zda tohle dokáži nějak jednoduše a efektivně vyřešit, proto