From 8ce885f379c40c4cb5f59af52963cdd64df8720d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Joris=20Pelgr=C3=B6m?= Date: Fri, 2 Feb 2024 22:06:45 +0100 Subject: [PATCH 1/4] Explain more about refresh intervals for Wear OS tiles --- docs/wear-os/wear-os.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/wear-os/wear-os.md b/docs/wear-os/wear-os.md index e1c964fd5d..96d89f6704 100644 --- a/docs/wear-os/wear-os.md +++ b/docs/wear-os/wear-os.md @@ -52,7 +52,13 @@ 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. However, this is not guaranteed: if the tiles are not placed at the start or end of the tiles list, they will most likely update less frequently. + +BETA The option 'in view' updates the camera and template tiles when you scroll them into view. For intervals other than 'manual', 'in view' also applies. 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 From 36379d139405e6f23a021cebb2e80a3f1b2caf16 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Joris=20Pelgr=C3=B6m?= Date: Fri, 2 Feb 2024 22:15:07 +0100 Subject: [PATCH 2/4] Make it a list --- docs/wear-os/wear-os.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/wear-os/wear-os.md b/docs/wear-os/wear-os.md index 96d89f6704..112fd4f1e1 100644 --- a/docs/wear-os/wear-os.md +++ b/docs/wear-os/wear-os.md @@ -55,9 +55,15 @@ The settings screen can be found at the bottom of the home screen. This is where * 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. However, this is not guaranteed: if the tiles are not placed at the start or end of the tiles list, they will most likely update less frequently. +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. -BETA The option 'in view' updates the camera and template tiles when you scroll them into view. For intervals other than 'manual', 'in view' also applies. 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. + - Manual (only updates when you tap the refresh button) + - BETA 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 that update in the background, 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. + +BETA 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 From 3d29e43403a7bb17b3667145256def4d36b92263 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Joris=20Pelgr=C3=B6m?= Date: Fri, 2 Feb 2024 22:15:52 +0100 Subject: [PATCH 3/4] Simplify: in the background -> other than manual --- docs/wear-os/wear-os.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/wear-os/wear-os.md b/docs/wear-os/wear-os.md index 112fd4f1e1..5b5c8b6c71 100644 --- a/docs/wear-os/wear-os.md +++ b/docs/wear-os/wear-os.md @@ -61,7 +61,7 @@ Wear OS limits how frequently apps can update tiles and how interactive they can - BETA 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 that update in the background, 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. +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. BETA 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. ::: From ef85b5a972ba4e02ddd36d46b33c17b4a7bbba0f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Joris=20Pelgr=C3=B6m?= Date: Fri, 2 Feb 2024 22:16:24 +0100 Subject: [PATCH 4/4] Add missing quotes for option --- docs/wear-os/wear-os.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/wear-os/wear-os.md b/docs/wear-os/wear-os.md index 5b5c8b6c71..80cf4471bc 100644 --- a/docs/wear-os/wear-os.md +++ b/docs/wear-os/wear-os.md @@ -61,7 +61,7 @@ Wear OS limits how frequently apps can update tiles and how interactive they can - BETA 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. +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. BETA 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. :::