From d0cf5e012fffa5a95a40dc8eef7b390924358353 Mon Sep 17 00:00:00 2001
From: tronikos <tronikos@users.noreply.github.com>
Date: Mon, 17 Apr 2023 00:50:34 -0700
Subject: [PATCH] Android TV Remote integration documentation (#26659)

Co-authored-by: Marc Randolph <mrand@users.noreply.github.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
---
 .../_integrations/androidtv_remote.markdown   | 357 ++++++++++++++++++
 .../androidtv_remote/lovelace_example.png     | Bin 0 -> 26354 bytes
 2 files changed, 357 insertions(+)
 create mode 100644 source/_integrations/androidtv_remote.markdown
 create mode 100644 source/images/integrations/androidtv_remote/lovelace_example.png

diff --git a/source/_integrations/androidtv_remote.markdown b/source/_integrations/androidtv_remote.markdown
new file mode 100644
index 00000000000..ff4874af3dd
--- /dev/null
+++ b/source/_integrations/androidtv_remote.markdown
@@ -0,0 +1,357 @@
+---
+title: Android TV Remote
+description: Instructions on how to integrate Android TV remotes into Home Assistant.
+ha_category:
+  - Remote
+ha_release: 2023.5
+ha_iot_class: Local Push
+ha_config_flow: true
+ha_codeowners:
+  - '@tronikos'
+ha_quality_scale: platinum
+ha_domain: androidtv_remote
+ha_zeroconf: true
+ha_platforms:
+  - diagnostics
+  - remote
+ha_integration_type: device
+---
+
+The Android TV Remote integration allows you to control an Android TV device by sending [commands](https://github.com/tronikos/androidtvremote2/blob/main/TvKeys.txt) and launching apps. For this to work the Android TV device needs to have [Android TV Remote Service](https://play.google.com/store/apps/details?id=com.google.android.tv.remote.service) which is pre-installed on most devices.
+
+{% include integrations/config_flow.md %}
+
+## Entity
+
+This integration adds a `remote` entity which turns on/off the Android TV device.
+The entity has the `current_activity` attribute that shows the current foreground app on the Android TV.
+
+## Services
+
+You can use the `remote.turn_off`, `remote.turn_on`, `remote.toggle`,  and `remote.send_command` services from the [remote](/integrations/remote/) platform.
+
+For a list of the most common commands you can send to the Android TV via `remote.send_command` see: [TvKeys](https://github.com/tronikos/androidtvremote2/blob/main/TvKeys.txt).
+For a full list see [here](https://github.com/tronikos/androidtvremote2/blob/main/src/androidtvremote2/remotemessage.proto#L90).
+
+If `activity` is specified in `remote.turn_on` it will open the specified URL in the associated app.
+
+Examples of URLs to pass as activity for some popular apps:
+
+| App | URL |
+| --- | --- |
+| YouTube | https://www.youtube.com
+| Netflix | https://www.netflix.com/title
+| Prime Video | https://app.primevideo.com
+| Disney+ | https://www.disneyplus.com
+
+Examples of service calls:
+
+```yaml
+# Open the currently selected item on the Android TV
+service: remote.send_command
+data:
+  command: DPAD_CENTER
+target:
+  entity_id: remote.living_room_tv
+```
+
+```yaml
+# Long press on the currently selected item on the Android TV
+service: remote.send_command
+data:
+  command: DPAD_CENTER
+  hold_secs: 0.5
+target:
+  entity_id: remote.living_room_tv
+```
+
+```yaml
+# Launch YouTube
+service: remote.turn_on
+data:
+  activity: https://www.youtube.com
+target:
+  entity_id: remote.living_room_tv
+```
+
+```yaml
+# Open a specific YouTube video:
+service: remote.turn_on
+data:
+  activity: https://www.youtube.com/watch?v=dQw4w9WgXcQ
+target:
+  entity_id: remote.living_room_tv
+```
+
+## Dashboard example
+
+You have to manually create buttons in Lovelace to send commands to the Android TV device or launch apps on it.
+
+Below is an example for you to start with. Many of the buttons support long press.
+
+![Screenshot Android TV Remote example](/images/integrations/androidtv_remote/lovelace_example.png)
+
+{% details "Lovelace example" %}
+
+Replace all instances of `living_room_tv` with your entity ID.
+
+```yaml
+type: vertical-stack
+cards:
+  - type: entities
+    entities:
+      - entity: remote.living_room_tv
+  - square: true
+    columns: 3
+    type: grid
+    cards:
+      - type: button
+        show_icon: false
+        tap_action:
+          action: none
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:arrow-up-bold
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: DPAD_UP
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: button
+        show_icon: false
+        tap_action:
+          action: none
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:arrow-left-bold
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: DPAD_LEFT
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:circle
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: DPAD_CENTER
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: DPAD_CENTER
+            hold_secs: 0.5
+          target:
+            entity_id: remote.living_room_tv
+      - type: button
+        icon: mdi:arrow-right-bold
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: DPAD_RIGHT
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:arrow-left
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: BACK
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: BACK
+            hold_secs: 0.5
+          target:
+            entity_id: remote.living_room_tv
+      - type: button
+        icon: mdi:arrow-down-bold
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: DPAD_DOWN
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:home-outline
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: HOME
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: HOME
+            hold_secs: 0.5
+          target:
+            entity_id: remote.living_room_tv
+  - square: false
+    columns: 3
+    type: grid
+    cards:
+      - type: button
+        icon: mdi:skip-previous
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: MEDIA_PREVIOUS
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: MEDIA_REWIND
+          target:
+            entity_id: remote.living_room_tv
+      - type: button
+        icon: mdi:play-pause
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: MEDIA_PLAY_PAUSE
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: MEDIA_STOP
+          target:
+            entity_id: remote.living_room_tv
+      - type: button
+        icon: mdi:skip-next
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: MEDIA_NEXT
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: MEDIA_FAST_FORWARD
+          target:
+            entity_id: remote.living_room_tv
+      - type: button
+        icon: mdi:volume-off
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: MUTE
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:volume-medium
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: VOLUME_DOWN
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:volume-high
+        tap_action:
+          action: call-service
+          service: remote.send_command
+          data:
+            command: VOLUME_UP
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+  - square: false
+    columns: 4
+    type: grid
+    cards:
+      - type: button
+        icon: mdi:youtube
+        tap_action:
+          action: call-service
+          service: remote.turn_on
+          data:
+            activity: https://www.youtube.com
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: button
+        icon: mdi:netflix
+        tap_action:
+          action: call-service
+          service: remote.turn_on
+          data:
+            activity: https://www.netflix.com/title
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: picture
+        image: >-
+          https://upload.wikimedia.org/wikipedia/commons/thumb/1/11/Amazon_Prime_Video_logo.svg/450px-Amazon_Prime_Video_logo.svg.png
+        tap_action:
+          action: call-service
+          service: remote.turn_on
+          data:
+            activity: https://app.primevideo.com
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+      - type: picture
+        image: >-
+          https://upload.wikimedia.org/wikipedia/commons/thumb/3/3e/Disney%2B_logo.svg/440px-Disney%2B_logo.svg.png
+        tap_action:
+          action: call-service
+          service: remote.turn_on
+          data:
+            activity: https://www.disneyplus.com
+          target:
+            entity_id: remote.living_room_tv
+        hold_action:
+          action: none
+  - type: entity
+    entity: remote.living_room_tv
+    attribute: current_activity
+  - type: media-control
+    entity: media_player.living_room_tv
+```
+
+{% enddetails %}
diff --git a/source/images/integrations/androidtv_remote/lovelace_example.png b/source/images/integrations/androidtv_remote/lovelace_example.png
new file mode 100644
index 0000000000000000000000000000000000000000..ac68b166ad1ac2f23fc3951309df81236b8e0f03
GIT binary patch
literal 26354
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
ByoLY(

literal 0
HcmV?d00001