与指定好友的宠物开始 PK。
调用
const result = await api.start_pet_pk(self_id, friend_id, friend_pet_id)
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
self_id |
number | 是 | 在线 Bot QQ 号 |
friend_id |
number | 是 | 对手 QQ 号 |
friend_pet_id |
string | 否 | 已缓存的对手宠物 ID；传入后跳过受客户端版本限制的好友资料解析 |
PK 协议需要“对手 QQ + 对手 petId”成对传输；保留 friend_id 并额外传 friend_pet_id 才是安全的缓存直连方式。
返回值
{
success: true,
pet_id: 'SELF_PET_ID',
friend_id: '123456789',
friend_pet_id: 'FRIEND_PET_ID',
friend_pet_name: '好友宠物',
story_id: '6900_xxx',
started: true,
}