设置默认APP¶
1. 功能概述¶
系统支持自定义2类关键APP的默认配置,包括开机启动APP、Home键切换APP。
2. 开机默认启动APP设置¶
开机默认启动APP为开机后自动启动的第一个APP。
2.1 获取当前开机默认启动APP¶
通过以下函数获取系统当前设置的开机默认启动APP名称。如果获取这个APP为空,开机进入默认是主菜单"Main":
/**
* @brief 获取开机后默认启动的第一个APP名称
* @return APP名称字符串,若未设置则返回默认APP"Main"
*/
const char *app_get_reg_power_on_app(void);
2.2 如何重新设置开机后默认启动APP¶
通过以下函数修改开机默认启动APP,设置后下次开机将自动启动指定APP:
/**
* @brief 设置开机后默认启动的第一个APP
* @param power_on_app 目标APP名称(需为系统已注册的APP,如"Clock"或"activity")
*/
void app_set_reg_power_on_app(const char *power_on_app);
3. Home 键切换APP设置¶
Home键切换APP实现按Home键时的APP切换功能(按一次home键到tlvAPP、再按一次切换到mainAPP,循环切换)。
3.1 Home键mainAPP¶
获取获取当前 Home 键mainAPP的函数:
app_get_reg_main_app
通过以下函数获取当前设置的 Home 键mainAPP名称:
/**
* @brief 获取Home键对应的mainAPP名称
* @return APP名称字符串(如"Main"),若未设置则返回默认值
*/
const char *app_get_reg_main_app(void);
设置Home 键mainAPP的函数:
app_set_reg_main_app
/**
* @brief 设置Home键对应的主APP
* @param main_app 目标APP名称(需为系统已注册的APP,如"Main")
* @note 若传入NULL或无效APP名,将恢复系统默认Home主APP
*/
void app_set_reg_main_app(const char *main_app);
3.2 Home 键tlvAPP¶
获取home键tlvAPP的函数:
app_get_reg_tlv_app
通过以下函数获取当前设置的 Home 键tlvAPP名称:
/**
* @brief 获取Home键对应的次APP名称
* @return APP名称字符串(如"setting"),若未设置则返回默认值
*/
const char *app_get_reg_tlv_app(void);
设置home键tlvAPP的函数:
app_set_reg_tlv_app
通过以下函数修改 Home 键tlvAPP,用于与主APP配合实现 Home 键的双APP切换:
/**
* @brief 设置Home键对应的次APP
* @param tlv_app 目标APP名称(需为系统已注册的APP,如"music")
* @note 若传入NULL或无效APP名,将恢复系统默认Home次APP
*/
void app_set_reg_tlv_app(const char *tlv_app);
4. UI界面设置默认APP¶
4.1 默认启动APP¶
主菜单->设置->默认APP->开机APP :点击选择默认启动APP,固件重启时就会使用选择的APP。
4.2 默认平铺APP¶
主菜单->设置->默认APP->平铺APP :点击选择默认平铺APP,按键会在主菜单和选择的平铺APP间切换。
注意
mainAPP默认是菜单APP,为了避免修改主APP后无法切换选择其他APP,UI不支持修改选择mainAPP。