1. Location problems

1. 定位问题

Location-related problems are documented separately. Start with the dedicated guide at Location and Keep-Alive.

定位相关问题已单独整理。请先查看 定位和保活 页面。

2. Long-pressing the assistant button does not start voice recognition

2. 首页助手按钮长按后无法语音识别

• Check whether microphone permission is granted.
• 先检查麦克风权限是否已经开启。
• If the system speech-to-text service is unavailable, search system settings for keywords like speech service, speech engine, or voice and enable the related component.
• 如果系统语音转文本服务不可用，可以在系统设置里搜索“语音服务”“语音引擎”“语音”等关键字，并启用对应组件。
• Some systems require the Google app or Google speech engine from Google Play.
• 部分系统需要安装或启用 Google App 或 Google 语音引擎。
• If you see audio-related recognition errors, also verify microphone permission for the Google app and install offline speech packages when needed.
• 如果出现音频相关识别错误，也请检查 Google App 的麦克风权限，并在需要时安装离线语音包。

3. Random toast errors followed by a jump to the login page

3. 偶现 toast 错误并跳回登录页

• It may be a temporary network problem. Force close the app and reopen it.
• 可能是临时网络问题，先杀掉 app 再重新打开。
• It may also mean the long-lived token was lost or deleted in Home Assistant. Re-login to refresh authorization.
• 也可能是长期令牌丢失，或已经在 Home Assistant 中被删除。重新登录以刷新授权。

4. Devices disappear after app restart

4. 首页添加设备后重启 app 不见了

The original note points to possible database corruption. A practical recovery attempt is to add one tab first, then add the devices again.

原始说明怀疑是本地数据库损坏。一个可尝试的恢复方式是先新增一个 tab，再重新添加设备。

5. Push tutorial and other operations

5. 推送教程和其他操作

• Bilibili push operation video
• Switch from Home Assistant homepage mode back to the original page

For additional workflows, the original note suggests browsing the related video collection linked from the page.

更多操作可以继续查看原始说明中提到的视频合集。

6. A specific device cannot be controlled

6. 某个设备无法控制

When reporting a device control problem, include the device's full state attributes. That context is usually necessary to reproduce or add support for a new entity type.

如果需要反馈设备控制问题，请附带该设备的完整状态属性。要复现问题或新增实体兼容，通常都需要这些上下文。

7. Supported Android versions

7. 支持的 Android 版本

• The current minimum supported version is Android 6.0.
• 当前最低支持 Android 6.0。
• For Android 5.0, use version 2.2.0 or earlier.
• Android 5.0 请使用 2.2.0 或更早版本。
• If the system WebView is too old, account and password login may fail. In that case, use a long-lived token login instead.
• 如果系统 WebView 版本过低，账号密码登录可能失败。这种情况下请改用长期令牌登录。