设置默认应用

功能概述

系统支持自定义2类关键应用的默认配置,包括开机启动应用、Home键切换应用,

开机默认启动应用设置

开机默认启动应用为开机后自动启动的第一个应用。

获取当前开机默认启动应用

通过以下函数获取系统当前设置的开机默认启动应用名称。如果获取这个应用为空,开机进入默认是主菜单"Main":

/**
 * @brief 获取开机后默认启动的第一个应用名称
 * @return 应用名称字符串,若未设置则返回默认应用"Main"
 */
const char *app_get_reg_power_on_app(void);

如何重新设置开机后默认启动应用

通过以下函数修改开机默认启动应用,设置后下次开机将自动启动指定应用:

/**
 * @brief 设置开机后默认启动的第一个应用
 * @param power_on_app 目标应用名称(需为系统已注册的应用,如"Clock"或"activity")
 */
void app_set_reg_power_on_app(const char *power_on_app);

Home 键切换应用设置

Home键切换应用实现按Home键时的应用切换功能(按一次home键到tlv应用、再按一次切换到main应用,循环切换)。

Home键main应用

  • 获取获取当前 Home 键main应用的函数:app_get_reg_main_app

通过以下函数获取当前设置的 Home 键main应用名称:

/**
 * @brief 获取Home键对应的main应用名称
 * @return 应用名称字符串(如"Main"),若未设置则返回默认值
 */
const char *app_get_reg_main_app(void);
  • 设置Home 键main应用的函数:app_set_reg_main_app

/**
 * @brief 设置Home键对应的主应用
 * @param main_app 目标应用名称(需为系统已注册的应用,如"Main")
 * @note 若传入NULL或无效应用名,将恢复系统默认Home主应用
 */
void app_set_reg_main_app(const char *main_app);

Home 键tlv应用

  • 获取home键tlv应用的函数:app_get_reg_tlv_app

通过以下函数获取当前设置的 Home 键tlv应用名称:

/**
 * @brief 获取Home键对应的次应用名称
 * @return 应用名称字符串(如"setting"),若未设置则返回默认值
 */
const char *app_get_reg_tlv_app(void);
  • 设置home键tlv应用的函数:app_set_reg_tlv_app

通过以下函数修改 Home 键tlv应用,用于与主应用配合实现 Home 键的双应用切换:

/**
 * @brief 设置Home键对应的次应用
 * @param tlv_app 目标应用名称(需为系统已注册的应用,如"music")
 * @note 若传入NULL或无效应用名,将恢复系统默认Home次应用
 */
void app_set_reg_tlv_app(const char *tlv_app);

UI界面设置默认应用

  • 默认启动应用
    主菜单->设置->默认应用->开机应用 点击选择默认启动应用,固件重启时就会使用选择的应用。

  • 默认平铺应用
    主菜单->设置->默认应用->平铺应用 点击选择默认平铺应用,按键会在主菜单和选择的平铺应用间切换。

注意
主应用默认是菜单应用,为了避免修改主应用后无法切换选择其他应用,UI不支持修改选择主应用。