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
nangu.tv	IPTV služby na platformě od Nangu.tv
itself	IPTV + OTT (mobilní) služby na platformě od itself s.r.o., využívá také 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

---