92 lines
2.6 KiB
C
92 lines
2.6 KiB
C
|
#ifndef __EMOJI_STORAGE_H__
|
|||
|
|
#define __EMOJI_STORAGE_H__
|
|||
|
|
|
|||
|
|
#include "esp_err.h"
|
|||
|
|
#include <stdbool.h>
|
|||
|
|
#include <stdint.h>
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
extern "C" {
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 从NVS加载表情包信息到内存
|
|||
|
|
* @return esp_err_t ESP_OK表示成功
|
|||
|
|
*/
|
|||
|
|
esp_err_t emoji_storage_load(void);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 保存当前使用的表情包ID到NVS
|
|||
|
|
* @param pack_id 表情包ID（字符，如'0', 'A', 'B', 'C', 'D'等）
|
|||
|
|
* @return esp_err_t ESP_OK表示成功
|
|||
|
|
*/
|
|||
|
|
esp_err_t emoji_storage_save_using_pack(char pack_id);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 添加已下载的表情包ID到列表并保存到NVS
|
|||
|
|
* @param pack_id 表情包ID（字符，如'0', 'A', 'B', 'C', 'D'等）
|
|||
|
|
* @return esp_err_t ESP_OK表示成功
|
|||
|
|
*/
|
|||
|
|
esp_err_t emoji_storage_add_downloaded_pack(char pack_id);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取当前使用的表情包ID
|
|||
|
|
* @return char 表情包ID，'0'表示默认表情包
|
|||
|
|
*/
|
|||
|
|
char emoji_storage_get_using_pack(void);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取已下载的表情包列表（JSON格式字符串）
|
|||
|
|
* @param packs 输出缓冲区，存储JSON格式字符串（如"[\"0\",\"A\",\"B\"]"）
|
|||
|
|
* @param max_len 缓冲区最大长度
|
|||
|
|
* @return int 实际写入的字符数（不包括'\0'），-1表示失败
|
|||
|
|
*/
|
|||
|
|
int emoji_storage_get_downloaded_packs_json(char *packs, int max_len);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取已下载的表情包列表（逗号分隔字符串）
|
|||
|
|
* @param packs 输出缓冲区，存储逗号分隔字符串（如"0,A,B"）
|
|||
|
|
* @param max_len 缓冲区最大长度
|
|||
|
|
* @return int 实际写入的字符数（不包括'\0'），-1表示失败
|
|||
|
|
*/
|
|||
|
|
int emoji_storage_get_downloaded_packs(char *packs, int max_len);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 检查指定表情包是否已下载
|
|||
|
|
* @param pack_id 表情包ID（字符）
|
|||
|
|
* @return true 已下载，false 未下载
|
|||
|
|
*/
|
|||
|
|
bool emoji_storage_is_downloaded(char pack_id);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 从列表中删除指定的表情包
|
|||
|
|
* @param pack_id 表情包ID（字符）
|
|||
|
|
* @return esp_err_t ESP_OK表示成功
|
|||
|
|
*/
|
|||
|
|
esp_err_t emoji_storage_remove_downloaded_pack(char pack_id);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 清空已下载的表情包列表（保留默认表情包'0'）
|
|||
|
|
* @return esp_err_t ESP_OK表示成功
|
|||
|
|
*/
|
|||
|
|
esp_err_t emoji_storage_clear_downloaded_packs(void);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 删除指定表情包的文件（目录 + zip）
|
|||
|
|
* @param pack_id 表情包ID（字符，'A'~'D'）
|
|||
|
|
* @return esp_err_t ESP_OK表示成功
|
|||
|
|
*/
|
|||
|
|
esp_err_t emoji_storage_remove_pack_files(char pack_id);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 清除所有已下载的表情包（删除文件 + 清空NVS + 重置为默认表情包）
|
|||
|
|
* @return esp_err_t ESP_OK表示成功
|
|||
|
|
*/
|
|||
|
|
esp_err_t emoji_storage_clear_all_packs(void);
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
}
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
#endif /* __EMOJI_STORAGE_H__ */
|