Assist on Android: how to make it the default assistant (#28248)

* Assist: Move wear OS content into its own section

- to prepare for separate section on Android phones/tablets

* Assist on Android: how to make it the default assistant

* Add prerequisite

* Add info to hold home button to start Assist

* Make Assist default assistant on Wear OS

* Make Assist default assistant on Wear OS

* Update wear OS section
This commit is contained in:
c0ffeeca7 2023-07-20 18:22:28 +02:00 committed by GitHub
parent a8173a5826
commit e64e6e8e79
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 70 additions and 10 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 52 KiB

View File

@ -2,27 +2,87 @@
title: "Assist on Android"
---
## Assist on Android phones
Assist is available on Android phones and tablets using the [Home Assistant Companion App](https://companion.home-assistant.io/docs/getting_started/) for Android.
### Prerequisites
- The devices you want to control with Assist are [exposed to Assist](/voice_control/voice_remote_expose_devices/)
### Setting up Home Assistant Assist as default assistant app on an Android phone
This section was written using an Android 13. Depending on your flavor of Android, the exact steps may vary.
To define Home Assistant Assist as default assistant app, follow these steps:
1. On Android, go to **Settings** > **Apps** > **Default apps**.
2. Under **Digital assistant app**, select **Default digital assistant app**.
- On some Android versions, this might be under **Digital & voice input** > **Default digital assistant app** > **Voice Assistant**.
3. Select **Home Assistant**.
- On some Android versions, you might be able to change the assistants language settings here by selecting the cogwheel.
4. Go back one step. The **Default digital assistant app** should now show *Home Assistant* as the default.
5. Leave the **Settings**.
6. Start Assist using the gesture to start an assistant. The gesture may differ depending on the version.
- Swipe from the bottom left corner.
- Long press the power button.
- Hold the home button (square button at the bottom).
## Assist on Wear OS
Assist is available on Wear OS using the [Home Assistant Companion App](https://companion.home-assistant.io/) for Android and "Assist" tile.
<lite-youtube videoid="Dr_ZCbt8w5k" videotitle="Assist on Wear OS"></lite-youtube>
## Installation
### Setting up Assist on Wear OS
After [installing the companion app](https://companion.home-assistant.io/docs/getting_started/) and connecting it to your Home Assistant, visit your watch companion app or the Wear OS app and click "Add tile" inside the Tiles area. Select the "Assist" tile to add it to your watch:
The way how Assist can be set up on your phone may differ depending on your version of Wear OS.
![Conversation tile](/images/assist/android_tile.png)
1. After [installing the companion app](https://companion.home-assistant.io/docs/getting_started/) and connecting it to your Home Assistant, Assist might appear automatically on the **Apps screen**.
2. If it does not, visit your watch companion app or the Wear OS app and select **Add tile** inside the **Tiles** area.
3. Select the **Assist** tile to add it to your watch:
![Conversation tile](/images/assist/android_tile.png)
### Adding Assist to the watch face
1. On your phone, open the **Watch** app and select **Watch faces**.
2. Make sure you select a watch face that supports complications (little shortcut icons).
3. Select **Edit**.
4. In the **Complications** section, select one of the slots and choose **Assist**.
- If you just recently added the Home Assistant app, Assist may not be listed yet.
- After rebooting your watch, under **Complications**, there should be section with Home Assistant icons.
5. Save your changes.
## Usage
### Using Assist on Wear OS
Swipe left on your watch until the "Assist" button is visible:
1. On your watch, swipe left until the **Assist** button is visible.
![Assist button](/images/assist/android_watch_1.png)
![Assist button](/images/assist/android_watch_1.png)
2. After selecting **Assist**, wait for **How can I assist?** to be displayed and the microphone to start pulsing.
![Assist button](/images/assist/android_watch_2.png)
After pressing "Assist", wait for "Speak Now" to be displayed:
3. Speak your command.
![Assist button](/images/assist/android_watch_3.png)
![Assist button](/images/assist/android_watch_2.png)
Speak your command, then press the "play" icon on the right to send the command to Home Assistant:
### Setting up Home Assistant Assist as default assistant app on a Wear OS watch
![Assist button](/images/assist/android_watch_3.png)
This procedure was written using Wear OS version 3.5. The exact steps may vary depending on the watch and software version.
To define Home Assistant Assist as default assistant app, follow these steps:
1. On the watch, navigate to the **Apps screen** and select the cogwheel.
2. Go to **Apps** > **Choose default apps** > **Digital assistant app**.
3. From the list, select **Home Assistant**.
4. When you go back one step, under **Default app**, it now says **HA: Assist**.
5. On some watches, you can now start Assist by pressing the crown key.
- If this does not work, you need to assign Assist to a button:
- On your watch, go to **Settings** > **Advances features** > **Customize keys**.
- Select **Home key** and select **Double press**.
- From the list of apps, select **HA: Assist**.
6. Now, use your key and give a command.