Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Explain more about refresh intervals for Wear OS tiles #1029

Merged
merged 4 commits into from
Feb 2, 2024
Merged

Explain more about refresh intervals for Wear OS tiles #1029

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8ce885f
Explain more about refresh intervals for Wear OS tiles
jpelgrom Feb 2, 2024
36379d1
Make it a list
jpelgrom Feb 2, 2024
3d29e43
Simplify: in the background -> other than manual
jpelgrom Feb 2, 2024
ef85b5a
Add missing quotes for option
jpelgrom Feb 2, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion docs/wear-os/wear-os.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,19 @@ The settings screen can be found at the bottom of the home screen. This is where
* The Shortcuts tile shows up to 7 shortcuts, which can be chosen from the settings section in the Wear OS app. You will be able to select the same set of entities you can access from the home screen. Starting from Wear OS 3, any number of separately configurable tiles can be added, only limited by Wear OS's limit for the total number of tiles.
* The Template tile shows a rendered template. The template can only be set from the Android companion app. Note: it is not possible to scroll in a tile, the template should fit on the watch screen.
* The Camera tile shows a snapshot of the selected camera.
* The Assist tile allows you to send a voice transcription to the [`conversation`](https://www.home-assistant.io/integrations/conversation/) integration to process. The results are then shown on the screen. This feature requires Home Assistant Core 2023.1 and also the `conversation` integration enabled.
* The Assist tile allows you to quickly [open Assist on your watch](https://www.home-assistant.io/voice_control/android/#assist-on-wear-os).

:::note About tile refreshes
Wear OS limits how frequently apps can update tiles and how interactive they can be. For the camera and template tiles you can choose a refresh interval which indicates to the system how often the tile should be refreshed.

- Manual (only updates when you tap the refresh button)
- <span class='beta'>BETA</span> In view (only updates when you scroll a tile into view)
- Every x minutes/hours (updates the tile in the background, even when not viewed)

For intervals other than 'Manual', the system does not guarantee updates: if the tiles are not placed at the start or end of the tiles list, they will most likely update less frequently. You may see an old version of a tile for 1-2 seconds while it updates.

<span class='beta'>BETA</span> The options for updating every x minutes/hours still update the tile when viewed. For example: choosing an update interval of 1 hour will indicate to the system that the tile should be updated when viewed, and every hour in the background since it was last viewed.
:::

### Styling the template tile

Expand Down