94 lines
8.6 KiB
Markdown
94 lines
8.6 KiB
Markdown
# simply-tv
|
||
|
||
Aplikacja na Android TV dla [simply-dvb](../simple-dvbt) (działa też z tvheadend). Dodaje serwer
|
||
DVB jako **źródło we wbudowanej aplikacji TV telewizora** (Android TV Input Framework): kanały z
|
||
logotypami i program TV pojawiają się na liście kanałów i w przewodniku telewizora, a obraz
|
||
odtwarza odtwarzacz telewizora ze sprzętowym dekodowaniem (HEVC, AC-3/E-AC-3, MPEG-2…).
|
||
|
||
* **Protokół**: HTSP tvheadend (port 9982) – kanały, EPG, nagrania i bilety (ticket); strumienie
|
||
po HTTP (port 9981, `/stream/channelid/<id>`), dokładnie jak klienci tvheadend.
|
||
* **Kanały i logotypy**: zapisywane w bazie TV Androida (`TvContract`), logotypy z serwera
|
||
(`/imagecache/<id>`) – bez płatnych pakietów.
|
||
* **Program TV**: 7 dni, gatunki, opisy; odświeżany co godzinę i na żądanie.
|
||
* **Nagrywanie**: na serwerze (DVR simply-dvb). Z aplikacji (*Program TV i nagrywanie*, OK na
|
||
audycji) oraz – jeśli aplikacja TV telewizora to obsługuje – z jej przewodnika. Gotowe nagrania
|
||
są w aplikacji (*Nagrania*: odtwórz, zatrzymaj, usuń) i na liście nagrań telewizora.
|
||
* **Odtwarzanie**: ExoPlayer (Media3) na powierzchni aplikacji TV; wybór ścieżki dźwiękowej i
|
||
napisów DVB z menu telewizora; nagrania z przewijaniem.
|
||
* **Własny odtwarzacz** (*Odtwarzacz simply-tv*): pełny ekran, kanał +/− i numery z pilota, OK = lista kanałów z logotypami i bieżącą audycją, pasek informacji z „teraz/następnie”. Działa niezależnie od aplikacji TV – można używać obu.
|
||
* Języki: angielski, polski (wg języka telewizora).
|
||
|
||
Docelowo: Android TV 8.0+ (testowy cel: Sony BRAVIA z Android TV 12).
|
||
|
||
## Budowanie
|
||
|
||
Potrzebny jest tylko Docker:
|
||
|
||
```sh
|
||
scripts/build-apk.sh # -> dist/simply-tv-<wersja>.apk
|
||
```
|
||
|
||
Pierwsze budowanie tworzy obraz budujący (JDK 17 + Android SDK, ok. 1,5 GB) oraz klucz podpisu w
|
||
`keystore/`. **Zachowaj katalog `keystore/`** (zrób kopię): Android instaluje aktualizację tylko
|
||
wtedy, gdy jest podpisana tym samym kluczem.
|
||
|
||
## Instalacja na telewizorze
|
||
|
||
1. TV: *Ustawienia → System → Informacje* – naciśnij 7× *Kompilacja* (tryb dewelopera).
|
||
2. TV: *Ustawienia → System → Opcje programisty* – włącz *Debugowanie przez sieć* (*Debugowanie ADB*).
|
||
3. Komputer (ta sama sieć):
|
||
```sh
|
||
scripts/install-tv.sh <adres TV> # np. 192.168.1.50
|
||
```
|
||
Za pierwszym razem telewizor zapyta, czy zezwolić temu komputerowi – wybierz *Zawsze zezwalaj*
|
||
i uruchom polecenie ponownie, jeśli się zatrzymało.
|
||
|
||
## Parowanie kodem QR
|
||
|
||
Na ekranie konfiguracji wpisz tylko adres serwera i wybierz **Paruj kodem QR**. Zeskanuj kod telefonem, zaloguj się do panelu simply-dvb i zatwierdź – telewizor dostaje własny token dostępu, nic nie trzeba wpisywać pilotem (albo wpisz 6-znakowy kod w panelu: *Dostęp → Sparuj telewizor*).
|
||
|
||
## Kilka serwerów
|
||
|
||
simply-tv trzyma listę serwerów (*Serwery* na ekranie startowym, otwiera się też z „konfiguracji kanałów” w aplikacji TV). Dla każdego serwera:
|
||
|
||
* **Używaj w odtwarzaczu** – serwer aktywny dla własnego odtwarzacza, przewodnika i nagrań. W odtwarzaczu otwórz listę kanałów (OK) i wciśnij **w lewo**, aby przełączyć serwer; ostatni kanał jest pamiętany osobno dla każdego serwera.
|
||
* **Źródło aplikacji TV wł./wył.** – czy kanały tego serwera trafiają do wbudowanej aplikacji TV telewizora. Kilka serwerów może zasilać ją jednocześnie; nazwa serwera widnieje jako sieć kanału. Wyłączenie serwera usuwa jego kanały (i nagrania) z aplikacji TV przy następnej synchronizacji.
|
||
* **Wczytaj kanały do aplikacji TV** od razu synchronizuje wszystkie włączone serwery.
|
||
|
||
## Ekran startowy
|
||
|
||
Najpierw odtwarzacz: *Oglądaj telewizję* ma fokus, więc OK otwiera go na ostatnim kanale. Pod tytułem widać ten kanał i to, co na nim teraz leci, z paskiem postępu – dane z serwera (`/api/epg/events/grid`), odświeżane po zakończeniu audycji. Niżej: Program TV, Nagrania, Aplikacja TV (wbudowana aplikacja telewizora z kanałami simply-tv), Serwery i Ustawienia; dalej stan aktywnego serwera z przyciskiem Synchronizuj, a na dole klawisze pilota w odtwarzaczu.
|
||
|
||
## Informacje na ekranie (OSD)
|
||
|
||
Przy każdej zmianie kanału, a przyciskiem INFO lub strzałką w lewo w dowolnej chwili, odtwarzacz pokazuje na dole: numer, logo i nazwę kanału; małe znaczniki z obrazem (Full HD 1920×1080 50 fps), dźwiękiem (E-AC-3 5.1), sygnałem i SNR z serwera (zielony / pomarańczowy / czerwony) oraz przepływnością faktycznie odbieraną przez telewizor, a także REC, gdy kanał jest nagrywany; zegar i datę; co leci **teraz** z godzinami, paskiem postępu, pozostałymi minutami i krótkim opisem; oraz co było **wcześniej**, co będzie **następnie** i **później**. Ponowne INFO / strzałka w lewo albo WSTECZ chowa OSD.
|
||
|
||
## Ustawienia
|
||
|
||
*Ustawienia* na ekranie startowym: OSD przy zmianie kanału, czas wyświetlania (3–15 s), szczegóły techniczne i opis w OSD; szczegółowa karta tunera przy zmianie kanału (domyślnie wyłączona – OSD pokazuje najważniejsze dane; NIEBIESKI nadal włącza ją podczas oglądania); tunelowanie wideo; start razem z telewizorem; zarządzanie serwerami; wersja. Lewa kolumna objaśnia zaznaczoną opcję.
|
||
|
||
## Klawisze pilota w odtwarzaczu
|
||
|
||
Góra / CH+ – następny kanał, dół / CH- – poprzedni · cyfry – numer kanału · OK – lista kanałów (w lewo: inny serwer, w prawo: siatka programu) · strzałka w prawo lub GUIDE – siatka programu · strzałka w lewo lub INFO – OSD (i karta tunera, jeśli włączona) · CZERWONY / REC – nagraj bieżącą audycję (ponownie: zatrzymaj) · ZIELONY – ścieżka dźwiękowa · ŻÓŁTY – napisy · NIEBIESKI – karta tunera wł./wył. · przycisk poprzedniego kanału.
|
||
|
||
**Siatka programu** (także *Program TV* na ekranie startowym): kanały w pionie, czas w poziomie, linia „teraz” i szczegóły zaznaczonej audycji u góry. Góra/dół – kanał, lewo/prawo – audycja, CH+/CH- – strona, OK – szczegóły z nagrywaniem / oglądaniem, CZERWONY – nagraj lub anuluj, ZIELONY – powrót do „teraz”, WSTECZ – zamknij. Niektóre piloty Sony zostawiają przycisk GUIDE dla przewodnika telewizora – strzałka w prawo działa zawsze.
|
||
|
||
Karta tunera (prawy górny róg, opcjonalna) pokazuje adapter, częstotliwość, synchronizację, trzy małe wykresy – sygnał/SNR, CPU serwera (cały host i proces simply-dvb, wymaga simply-dvb 0.1.13+) oraz przepływność strumienia faktycznie odbieranego przez telewizor (pod spodem przepływność multipleksu) – a także modulację/FEC, BER i liczniki błędów.
|
||
|
||
**Płynny obraz:** *Tunelowanie wideo* (*Ustawienia*, domyślnie włączone) przekazuje dekodowanie i synchronizację obrazu do toru wideo telewizora – tego samego, którego używa wbudowany tuner. Jeśli na jakimś kanale nie ma wtedy obrazu, wyłącz je. Biała linia na karcie tunera pokazuje, co telewizor robi ze strumieniem: rozdzielczość, wyświetlane klatki na sekundę, gubione klatki (na czerwono), bufor i dekoder; ostatnia linia to czasy sterownika w simply-dvb (odczyt statystyk sygnału i najdłuższa przerwa w strumieniu).
|
||
|
||
**Start razem z telewizorem:** *Uruchamiaj odtwarzacz z telewizorem* (*Ustawienia*) otwiera własny odtwarzacz na ostatnim kanale po starcie telewizora i po wybudzeniu ze stanu czuwania. Android pozwala otworzyć ekran z tła tylko z uprawnieniem *Wyświetlanie nad innymi aplikacjami* – aplikacja otwiera ten ekran ustawień; jeśli telewizor go nie ma, nadaj je raz z komputera: `adb shell appops set io.simplydvb.tv SYSTEM_ALERT_WINDOW allow`. Na ekranie głównym jest też drugi kafelek, *simply-tv Na żywo*, który od razu otwiera odtwarzacz. Przycisk TV na pilocie zawsze otwiera wbudowaną aplikację TV telewizora – kanały simply-tv też w niej działają (przez wejście TV).
|
||
|
||
## Pierwsze uruchomienie
|
||
|
||
**Najprościej – kod QR:** wpisz tylko adres serwera i wybierz *Paruj kodem QR*. Zeskanuj kod telefonem, zaloguj się do panelu simply-dvb i zatwierdź – serwer utworzy token dostępu dla telewizora, a telewizor sam go pobierze (bez wpisywania tokenu pilotem). Bez telefonu: panel → Dostęp → *Sparuj telewizor* i wpisz 6-znakowy kod z ekranu TV.
|
||
|
||
Ręcznie:
|
||
|
||
1. simply-tv otworzy ustawienia serwera: adres serwera simply-dvb, port HTSP (9982), port HTTP
|
||
(9981). W sieci lokalnej użytkownik i hasło nie są potrzebne; spoza domu dowolna nazwa
|
||
użytkownika i **token dostępu** jako hasło (panel simply-dvb → Dostęp → tokeny).
|
||
2. *Połącz i wczytaj kanały* – kanały, logotypy i program trafiają do telewizora.
|
||
3. Otwórz aplikację TV (Sony: przycisk *TV* / Wejścia) i wybierz źródło **simply-tv**. Kanał
|
||
+/−, numery i przycisk przewodnika działają jak przy wbudowanym tunerze.
|