keyboard/keyBoard/Class/Home/M/KBCharacter.h

//
//  KBCharacter.h
//  首页 - 排行榜角色模型（MJExtension 解析）
//

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

/// 排行榜角色/角色卡片模型
/// 对应后端返回字段示例：
/// {
///   "id" : 29,
///   "download" : "0x4AQSfQS0",
///   "characterName" : "Ms.",
///   "avatarUrl" : "https://...",
///   "tag" : 490,
///   "characterBackground" : "d2EWHe1ST5",
///   "rank" : 899
/// }
@interface KBCharacter : NSObject

/// 唯一标识，对应后端的 id
@property (nonatomic, copy, nullable) NSString *characterId;

/// 名称，对应后端的 characterName
@property (nonatomic, copy, nullable) NSString *characterName;

/// 头像地址
@property (nonatomic, copy, nullable) NSString *avatarUrl;

/// 角色背景（颜色值、图片地址或后端定义的 key）
@property (nonatomic, copy, nullable) NSString *characterBackground;

/// 下载量文案或数值（后端返回字符串）
@property (nonatomic, copy, nullable) NSString *download;

/// 标签（例如分类、类型）原样保存
@property (nonatomic, assign) NSInteger tag;

/// 排名序号（1、2、3...）
@property (nonatomic, assign) NSInteger rank;

/// 本地字段：是否已添加到键盘（仅客户端使用）
@property (nonatomic, assign) BOOL added;

@end

NS_ASSUME_NONNULL_END