Document filtering of sources for Android TV (#11816)

* Document filtering of sources for Android TV

* Revise documentation for source filtering

* Document 'exclude_unnamed_apps' parameter

* Fix typo
This commit is contained in:
Jeff Irion 2020-02-05 05:38:33 -08:00 committed by Franck Nijhof
parent 2533e33823
commit 12019086bd
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3

View File

@ -77,10 +77,15 @@ get_sources:
default: true default: true
type: boolean type: boolean
apps: apps:
description: A dictionary where the keys are app IDs and the values are app names that will be displayed in the UI; see example below. ([These app names](https://github.com/JeffLIrion/python-androidtv/blob/5c39196ade3f88ab453b205fd15b32472d3e0482/androidtv/constants.py#L267-L283) are configured in the backend package and do not need to be included in your configuration.) description: A dictionary where the keys are app IDs and the values are app names that will be displayed in the UI; see example below. If a name is not provided, the app will never be shown in the sources list. ([These app names](https://github.com/JeffLIrion/python-androidtv/blob/5c39196ade3f88ab453b205fd15b32472d3e0482/androidtv/constants.py#L267-L283) are configured in the backend package and do not need to be included in your configuration.)
required: false required: false
default: {} default: {}
type: map type: map
exclude_unnamed_apps:
description: If this is true, then only the apps you specify in the `apps` configuration parameter and [those specified in the backend library](https://github.com/JeffLIrion/python-androidtv/blob/5c39196ade3f88ab453b205fd15b32472d3e0482/androidtv/constants.py#L267-L283) will be shown in the sources list.
required: false
default: false
type: boolean
device_class: device_class:
description: "The type of device: `auto` (detect whether it is an Android TV or Fire TV device), `androidtv`, or `firetv`." description: "The type of device: `auto` (detect whether it is an Android TV or Fire TV device), `androidtv`, or `firetv`."
required: false required: false
@ -107,15 +112,19 @@ turn_off_command:
# Example configuration.yaml entry # Example configuration.yaml entry
media_player: media_player:
# Use the Python ADB implementation with a user-provided key to setup an # Use the Python ADB implementation with a user-provided key to setup an
# Android TV device. Provide an app name, override the default turn on/off # Android TV device. Provide some app names and don't display other apps
# commands, and provide custom state detection rules. # in the sources menu. Override the default turn on/off commands, and
# provide custom state detection rules.
- platform: androidtv - platform: androidtv
name: Android TV name: Android TV
device_class: androidtv device_class: androidtv
host: 192.168.0.222 host: 192.168.0.222
adbkey: "/config/android/adbkey" adbkey: "/config/android/adbkey"
exclude_unnamed_apps: true
apps: apps:
com.amazon.tv.launcher: "Fire TV" com.amazon.tv.launcher: "Fire TV"
some.background.app: # this will never show up in the sources list
another.background.app: "" # this will also never show up in the sources list
turn_on_command: "input keyevent 3" turn_on_command: "input keyevent 3"
turn_off_command: "input keyevent 223" turn_off_command: "input keyevent 223"
state_detection_rules: state_detection_rules: