登录验证
获取协议列表
list_protocols:查询当前客户端支持的协议标识。
const StringList *list_protocols(void);
void free_strings(const StringList *list);- 权限:
list_protocols - 调用要求:无需账号在线
使用说明
- 返回的字符串(如
"qq_phone"、"tim_pad")可直接传给add_account/edit_account的protocol参数。 - 头文件中的
PROTOCOL_*常量不一定全部受当前客户端支持,请以本接口返回结果为准。 - 失败时返回
NULL;用完必须调用free_strings(list)交还。
头文件预定义协议常量
以下常量定义于 plugin.h,但不代表当前客户端一定支持全部协议,调用前请以 list_protocols() 的实际返回结果为准:
| 常量 | 值 | 说明 |
|---|---|---|
PROTOCOL_QQ_PHONE | "qq_phone" | QQ 手机 |
PROTOCOL_QQ_PAD | "qq_pad" | QQ 平板 |
PROTOCOL_TIM_PHONE | "tim_phone" | TIM 手机 |
PROTOCOL_TIM_PAD | "tim_pad" | TIM 平板 |
PROTOCOL_QQ_WATCH | "qq_watch" | QQ 手表 |
返回值 StringList
| 字段 | 类型 | 说明 |
|---|---|---|
count | uint32_t | 协议数量 |
items | const char *const * | UTF-8 协议标识数组 |