Digitální televize Itself

Pokud je v textu chyba či Vám schází nějaké informace, informujte nás na support@mango.cloud, jako předmět uveďte název článku.

Článek popisuje nastavení pro zprovoznění OTT (mobilních) zařízení pro IPTV služby na platformě poskytované společností itself s.r.o..

Obecné pojmy

Název	Popis
itself	IPTV + OTT (mobilní) služby na platformě od itself s.r.o., využívá také Nangu.tv
nangu.tv	IPTV služby na platformě od Nangu.tv
CP	zákazník - vlastník licence Mango dle licenční smlouvy nebo pronájemce Mango

Zpět na obsah: Digitální televize Itself

---

Obecné informace

Služba je určena pro poskytovatele internetu (ISP) k doplnění svých služeb triple play. Na platformě itself se musí provést definice tarifů (tariff) a nabídky (offer) služeb. Definici provádí na základě pokynů CP přímo itself. Platforma je sdílená pro více ISP, nelze tedy do ní přistupovat přímo ze strany CP. V Mango také založíte služby s vazbou na tariff a offer z platformy itself (seznam by měl předat itself). Svázáním pak Mango dokáže informovat platformu itself o zákaznících, službách, settopboxech a identitách. Správu virtuálního operátora middleware provádí itself a Mango automaticky řídí zákazníky/služby/IPTV SetTopBoxy/OTT identity.

Jelikož je smlouva o NANGu mezi Vámi a poskytovatelem NANGu (Itself), bude po Vás Itself s.r.o. chtít nějaké prohlášení, že je možné aby OG Soft s.r.o. mohl s poskytovatelem komunikovat a předávat jim do NANGu data z Mango. Příklad oznámení pro poskytovatele Nangu: "Tímto souhlasíme, aby společnosti OG Soft s.r.o., jakožto poskytovateli platformy Mango pro naši společnost, bylo umožněno komunikovat a předávat do NANGu data z Mango a obráceně případná data z Nangu přijímat a zpracovávat v Mango."

Bližší informace o řešení společnosti itself s.r.o. naleznete na jejich stránkách itself s.r.o..

Zpět na obsah: Digitální televize Itself

---

Definice na platformě itself

Je potřeba si s itself s.r.o. domluvit skladbu tv kanálů (channel packages), nabídek (offers - obsahuje seznam channel packages) a tarifů (tariff - zahrnuje nabídku). Podle toho připraví itself s.r.o. definici, kterou si CP zanese do Mango (viz Definice bázových služeb, Definice závislých služeb - balíčků a případně Nastavení kanálů).

Pro představu, definice se provádí na platformě nangu.tv, která vypadá shodně jako je uvedené v dokumentaci Nangu.tv.

Zpět na obsah: Digitální televize Itself

---

Definice spojení s platformou itself

Definice slouží pro vytvoření spojení mezi systémy Mango a itself.
Pod zařízení Mango RM je založeno (přes modul Síť) zařízení provozovatele třídy Itself IPTV Proxy s interfacem virtual0. Nastavení parametrů tohoto zařízení je řešeno v rámci implementace, není potřeba měnit, pokud nebude požadováno ze strany itself s.r.o.

Zařízení má tyto parametry, všechny musejí být vyplněné:

• WS_URL - Adresa webové služby (URL adresa SOAP rozhraní služby)
• WS_USER - Uživatel (Uživatel pro přihlášení k webové službě)
• WS_PASSWORD - Heslo (Heslo pro přihlášení k webové službě)
• OPERATOR_NAME - Název operátora (Název operátora pro itself)

Parametry jsou nastaveny OG Softem podle pokynů od poskytovatele itself, pro každého CP odlišné.

Zpět na obsah: Digitální televize Itself

---

Definice IPTV SetTopBoxů

V případě, že využíváte plně rozhraní itself (IPTV služby na settopboxu, nikoliv pouze OTT služby), v Mango musíte založené služby přiřazovat na zařízení třídy IPTV SetTopBox (lze založit např. v modulu Koncová zařízení). Zařízení vznikají pro účely zprovoznění IPTV služeb na settopboxech koncových zákazníků, přes které lze následně provádět i správu OTT zařízení (např. registrace a odregistrace mobilních zařízení). Synchronizační skript zařízení založí i v NANGU (itself). Zařízení má pro Nangu.tv tyto parametry:

• MAC adresa (povinné)
• Adresa zařízení - IP adresa (není povinné)
• Sériové číslo - SN settopboxu (povinné)
• Uživatel - Uživatel k OTT identitě (parametr není v seznamu, přiřazuje se automaticky od služby, která bude svázána se zařízením)
• Heslo - Heslo k OTT identitě (parametr není v seznamu, přiřazuje se automaticky od služby, která bude svázána se zařízením)

Třídy služeb, které jsou aktuálně povoleny pro přiřazení k zařízením třídy IPTV SetTopBox:

• IPTV
• Triple Play
• Dual Play: internet + IPTV
• Data + IPTV
• Dual Play

Zpět na obsah: Digitální televize Itself

---

Definice OTT identity

V případě, že využíváte rozhraní itself pouze pro využívání OTT služeb, musíte založené služby přiřazovat na zařízení třídy OTT identita (lze založit např. v modulu Koncová zařízení). OTT identita slouží pro zajištění identity zákazníka s následnou možností použití jednotlivých mobilních zařízení (tablet, smartphone, herní konzole). Koncový zákazník tak může na svých mobilních zařízeních využívat IPTV služby. Zařízení má pro Nangu.tv tyto parametry:

• Uživatel - Uživatel k OTT identitě (parametr není v seznamu, přiřazuje se automaticky od služby, která bude svázána se zařízením)
• Heslo - Heslo k OTT identitě (parametr není v seznamu, přiřazuje se automaticky od služby, která bude svázána se zařízením)

Třídy služeb, které jsou aktuálně povoleny pro přiřazení k zařízením třídy OTT identita:

• IPTV
• Triple Play
• Dual Play: internet + IPTV
• Data + IPTV
• Dual Play

Zpět na obsah: Digitální televize Itself

---

Definice bázových služeb

Pokud máte v rozhraní itself připravené definice tarifů (tariff) a nabídek (offer) služeb (ZDE), tak můžete v Mango založit definice služeb, na které vytvoříte vazbu na tariff a offer z rozhraní itself. Aktivací služby, svázáním na zařízení (STB nebo i OTT zařízení) pak Mango dokáže informovat rozhraní itself o zákaznících, službách, settopboxech a identitách.

V modulu Produkty a služby založte službu třídy ITPV (nebo jiné, viz seznam podporovaných tříd služeb výše), definujte cenu paušálu a nastavte parametry.

Parametry mohou být:

• Kód tarifu (Bázová služba zákazníka, která reprezentuje "Subscription" v terminologii itself, musí mít nastaven parametr tariff_code (Kód tarifu) - odpovídá kódu tarifu na platformě itself. Synchronizační skript na základě toho vytvoří pro uživatele itself subscription s tímto tarifem, jejíž identifikátor je roven ID této bázové služby v Mango.
• Kód offeru (definujte u bázové služby, pouze pokud nejsou k bázové službě přiřazeny balíčky)
• Typ OTT identity (v rámci itself nastavte hodnotu USERNAME)
• OTT heslo (definuje se při aktivaci služby, nechte prázdné)
• OTT login (definuje se při aktivaci služby, nechte prázdné)
• PIN (může se definovat při aktivaci služby, nechte prázdné)
• Rodičovský zámek (může se definovat při aktivaci služby, nechte prázdné)

Zpět na obsah: Digitální televize Itself

---

Definice závislých služeb - balíčků

K bázovým službám lze přes návaznosti svázat volitelné balíčky (pokud je CP nabízí, standardně se v itself nastavují pouze tarify a nabídky) - v terminologii NANGU je to "Offer". V Mango jsou balíčky reprezentovány jako závislé služby třídy IPTV k aktivované bázové službě (také třídy IPTV). Každá z nich musí mít nastaven v tabulce "Parametry služby nebo produktu" parametr offer_code (Kód offer) - musí odpovídat kódu offer, jak je nastaven v rozhraní itself. Závislá služba (balíček) může mít také svojí cenu, nastavte dle potřeby.

Zpět na obsah: Digitální televize Itself

---

Limity počtu OTT zařízení

Platforma řeší limit zařízení na subscription (službu) a na operátora. Oba limity se řeší na straně nangu. Nastavení si domluvte s itself s.r.o..

Nastavení kanálů

Pro reporting programmerům můžete v modulu Televize založit kanály třídy IPTV a v případě více definic IPTV služeb s rozdílnou skladbou kanálů, můžete na záložce "Skupiny" vytvořit skupiny třídy IPTV pro jednotlivé definice služeb. Na záložce "Kanály" pak vybrané kanály přiřadíte do skupin, uvedených v tabulce "Seznam skupin kanálů". Tyto skupiny pak můžete v modulu Produkty a služby, záložce "TV" a tabulce "Seznam kanálů / skupin kanálů" přiřadit. V modulu Televize pak můžete akcí "Tisk počtu zákazníků a služeb" připravit reporting pro programmery.

Zpět na obsah: Digitální televize Itself

---

Aktivace služby a nastavení identity

Po připravení výše uvedených bodů je už možné provést aktivaci IPTV služby pro vybrané zákazníky, u kterých vyplníte povinné údaje, případně jsou údaje přebírány z parametru zákazníka (OTT login a OTT heslo: jaký údaj zákazníka je určen pro přihlášení, např. e-mailová adresa, číslo smlouvy, přístupové údaje na koncové stránky,...). Po vytvoření služby připojte tuto službu pod IPTV SetTopBox, resp. pod OTT identitu.

Synchronizační skript vytváří na nangu.tv uživatele s identifikátorem rovným ID uživatele v Mango (v nangu jde o položku customer number) a updatuje na nangu.tv informace o něm.

• Jestliže je poskytovatelem NANGU požadováno nastavení parametru PUK, bude přiděleno na zařízení až ze strany NANGU (na zařízení tedy PUK ručně nevyplňujte)
• Jestliže jsou pro bázovou službu nastaveny parametry master_pin (PIN) a parental_pin (Rodičovský zámek), nastaví je synchronizační skript pro subscription.
• V případě řešení itself se parental_pin, pokud není vyplněn, odesílá s hodnotou 0000 (pro aplikaci tv2go musí být nějaký nastaven, jinak se nelze dostat v menu aplikace do Seznam stanic - Nangu zatím nehodlá provést úpravu, aby si rodičovský zámek nastavoval uživatel sám při prvním spuštění aplikace).

Identita slouží pro rozlišení jednotlivých subscriberů (uživatelů OTT služeb). Identita se přebírá z parametrů u zařízení OTT identita (identita se získá z přiřazené služby k zařízení). Identita je definována pomocí username + password nebo pairing PIN (v případě itself to je username + password).

Parametry identit:

• Typ OTT identity (Login+heslo=USERNAME, párovací klíč=PIN)
• OTT login - Uživatelské jméno OTT identity (nabídne se při identitě USERNAME, musí být jednoznačné v rámci CP, typ textový řetězec)
• OTT heslo - Heslo OTT identity (nabídne se při identitě USERNAME, typ textový řetězec)
• OTT párovací klíč - Párovací klíč OTT identit (nabídne se při identitě PIN, typ textový řetězec)

Zpět na obsah: Digitální televize Itself

---

Předání informací o identitě koncovému zákazníkovi

CP uvede informace pro přihlášení na smluvním dokumentu nebo na svých webových stránkách (jaký údaj zákazníka je určen pro přihlášení - login a heslo, např. číslo smlouvy, přístupové údaje na koncové stránky,.... E-mailovou adresu nelze použít, Nangu nepovoluje znak @). Při implementaci lze pro přihlášení do aplikace tv2go nastavit jakýkoliv parametr zákazníka (parametr pak můžete použít v definici šablon).

Zpět na obsah: Digitální televize Itself

---

Registrace a odregistrace OTT zařízení

Registrace zařízení se provádí automaticky po přihlášení do aplikace tv2go. Odregistrace se provádí také v aplikaci tv2go, v menu Zařízení. Odregistrovat lze pouze zařízení, na kterém nejsem připojen (ten lze pouze přejmenovat). Pokud dojde k situaci, kdy je dosažen limit OTT zařízení (více o limitech) pro identitu subscribera (zákazníka), je nutné se přihlásit do aplikace registrovaným OTT zařízením a provést odregistraci nepoužívaného zařízení. Nastavení lze provést případně na IPTV SetTopBoxu (pokud CP funkcionalitu využívá).

Zpět na obsah: Digitální televize Itself

---

Aktualizace a stav zařízení

Vyvolání aktualizace zařízení je možné z Mango standardním mechanismem (akcí "Aktualizace parametrů tohoto zařízení" v modulu Koncová zařízení). Aktualizací se provede synchronizace do nangu.

Pokud je nadefinován filtr alertu, zobrazuje se stav aktualizace kromě modulu Události & Alerting také v modulu Koncová zařízení, záložce "Vše" a záložce "TV", v tabulce "Události zařízení".

Chybové kódy zapsané při aktualizaci zařízení jsou totožné s těmi, uvedenými ZDE .

Aplikace tv2go

Pro využívání IPTV služeb koncovým zákazníkem na OTT zařízeních si musí uživatel stáhnout a nainstalovat aplikaci tv2go (k dispozici je pro platformu Android a iOS). Pro platformu Android od verze 3 Honeycomb stahujte ZDE.

Pro přihlášení na mobilních zařízení (tablet, smartphone, herní konzole) použije zákazník údaj z parametru OTT login a OTT heslo.

FAQ

Otázka: Jak je zajištěn přenos dat ze zařízení do Itself, tedy pod jaké PROXY zařízení se má nově vytvořené zařízení připojit?
Odpověď: Při vytvoření zařízení vznikne automaticky parametr IPTV_ITSELF_PROXY s vazbou na zařízení Itself IPTV Proxy a toto ID se zjistí dle vybraného nadřazeného zařízení (při vytváření zařízení).

Otázka: Jak je řešen billing pro CP (za OTT zařízení se platí licenční poplatky)?
Odpověď: Itself bude pro každého operátora poskytovat měsíční souhrnný výpis. Předání bude probíhat napřímo mezi Itself a operátorem (CP). Z každé subscription lze sice vyčíst i počet zařízení, Mango ale tyto údaje z nangu nestahuje (vyčítání není moc rychlé).

Otázka: Může si koncový zákazník sám přes SelfCare objednat IPTV službu pro OTT zařízení?
Odpověď: Aktuálně s touto podporou není počítáno.

Otázka: Mám na zařízení třídy IPTV SetTopBox vyplnit parametr PUK?
Odpověď: Jestliže je poskytovatelem NANGU požadováno nastavení parametru PUK, bude přiděleno na zařízení až ze strany NANGU (na zařízení tedy PUK ručně nevyplňujte).

Máte nějaké otázky? Zeptejte se na support@mango.cloud

Zpět na obsah: Digitální televize Itself

---