账号管理
添加账号
add_account:向客户端账号列表添加一个新账号。
bool add_account(uint64_t self_id, const char *platform, const char *password,
const char *protocol, const char *device);- 权限:
add_account - 调用要求:无需账号在线
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id | uint64_t | 是 | QQ 号,不能为 0 |
platform | const char * | 是 | 所属平台 PLATFORM_*,必须与 protocol 所属平台一致 |
password | const char * | 否 | 登录密码;传 NULL 或 "" 表示不保存密码 |
protocol | const char * | 是 | 协议标识,使用 list_protocols 返回的值 |
device | const char * | 是 | 设备文件名,使用对应平台 list_devices 返回的 name(不带 .toml) |
返回值
- 返回
true仅表示账号已加入列表,不表示已登录;登录请另调用login_cache或login_password。 - 授权到期、未开通或参数无效时返回
false,原因写入运行日志。