Im Normalfall startet ein Gerät zunächst in seine eigene Benutzeroberfläche. Die OXOMI TV App muss dort anschließend manuell aufgerufen werden. Für den unbeaufsichtigten Betrieb - etwa auf einem Bildschirm in der Ausstellung - ist es sinnvoll, die App stattdessen als Startanwendung (Launcher) einzurichten. Das Gerät startet dann unmittelbar in die OXOMI TV App, auch nach einem Stromausfall oder einem Neustart.
Erfordert tiefergehende Systemkenntnisse
Die Einrichtung erfolgt über die Android Debug Bridge (adb) und damit nicht über die Benutzeroberfläche des Geräts oder Ihres OXOMI-Portals. Sie sollte daher von einem Techniker oder Administrator durchgeführt werden.
Eingriff in die Systemkonfiguration
Das Austauschen des Startbildschirms ist ein Eingriff in die Systemkonfiguration des Geräts. Es kann nicht garantiert werden, dass die Einrichtung auf allen Geräten und Android-Versionen funktioniert. Es ist außerdem möglich, dass die Einrichtung nach einem Update des Geräts oder der App nicht mehr funktioniert.
Nur mit Android-TV-Oberfläche möglich
Die hier beschriebene Vorgehensweise funktioniert ausschließlich auf Geräten mit Android-TV-Oberfläche (Leanback). Auf Geräten mit Google-TV-Oberfläche lässt sich die Startanwendung nicht austauschen: Dort begrenzt das System die Priorität von Startanwendungen anderer Anbieter, sodass sich die mitgelieferte Oberfläche immer durchsetzt. Prüfen Sie daher vor der Einrichtung, welche Oberfläche Ihr Gerät verwendet.
Ersetzt den System-Startbildschirm
Bei diesem Vorgang wird die Startanwendung des Geräts ersetzt. Solange die Einrichtung aktiv ist, ist die gewohnte Android-TV-Oberfläche nicht mehr erreichbar. Wie Sie diesen Zustand wieder aufheben, beschreibt der Abschnitt „Einrichtung zurücksetzen“.
Für die Einrichtung benötigen Sie:
- ein Gerät mit Android-TV-Oberfläche,
- eine bestehende adb-Verbindung zu diesem Gerät,
- die auf dem Gerät installierte OXOMI TV App.
Hinweis
ADB ist ein Kommandozeilenwerkzeug, das Teil des Android SDK ist. Es ermöglicht die Kommunikation mit einem Android-Gerät zu Entwicklungszwecken. Weiterführende Informationen zu ADB finden Sie in der offiziellen Dokumentation von Google.
Welche Oberfläche das Gerät verwendet, erkennen Sie an der installierten Startanwendung:
adb shell pm list packages | grep -i launcher
Erscheint dabei das Paket com.google.android.tvlauncher, handelt es sich um ein Gerät mit Android-TV-Oberfläche und die Einrichtung ist möglich. Erscheint stattdessen com.google.android.apps.tv.launcherx, verwendet das Gerät die Google-TV-Oberfläche – in diesem Fall kann die OXOMI TV App nicht als Startanwendung festgelegt werden.
Ob die App installiert ist und unter welchem Paketnamen, lässt sich wie folgt prüfen:
adb shell pm list packages | grep -i oxomi
Erwartet wird das Paket com.scireum.oxomitv. Die nachfolgenden Befehle beziehen sich auf diesen Namen.
Die Einrichtung besteht aus zwei Schritten. Beide sind erforderlich – der erste allein genügt in der Regel nicht.
Die App als Startanwendung festlegen
Der folgende Befehl weist der OXOMI TV App die Rolle der Startanwendung zu:
adb shell cmd package set-home-activity com.scireum.oxomitv/com.scireum.oxomitv.MainActivity
Hinweis
Die Meldung Error: Failed to set default home bedeutet, dass unter diesem Namen kein Paket installiert ist. Prüfen Sie in diesem Fall den Paketnamen wie im Abschnitt „Voraussetzungen“ beschrieben.
Die mitgelieferte Startanwendung deaktivieren
Anschließend wird die Startanwendung des Geräts deaktiviert:
adb shell pm disable-user --user 0 com.google.android.tvlauncher
Dieser Schritt ist notwendig, weil die mitgelieferte Startanwendung mit einer höheren Priorität hinterlegt ist als Anwendungen von Drittanbietern. Ohne die Deaktivierung würde sie sich weiterhin durchsetzen, auch wenn die OXOMI TV App bereits als Startanwendung festgelegt ist.
Danach startet das Gerät direkt in die OXOMI TV App. Die Einstellung bleibt über einen Neustart hinweg erhalten.
Um wieder die gewohnte Oberfläche des Geräts zu erhalten, machen Sie beide Schritte rückgängig.
Die mitgelieferte Startanwendung wieder aktivieren
adb shell pm enable com.google.android.tvlauncher
Die Rolle der Startanwendung zurückgeben
adb shell cmd package set-home-activity com.google.android.tvlauncher/.MainActivity
Anschließend startet das Gerät wieder in seine gewohnte Android-TV-Oberfläche.
Hinweis
Auch innerhalb der Android-TV-Geräte kann das Verhalten je nach Modell und Android-Version abweichen. Auf manchen Geräten genügt bereits der erste Schritt, während die Deaktivierung der mitgelieferten Startanwendung entfällt. Prüfen Sie das Ergebnis daher stets auf dem tatsächlich eingesetzten Gerät – insbesondere, ob die Einrichtung einen Neustart übersteht.