后续新的弹窗,都通过下列协议下发。 message/NewsClientMessage
// 客户端目前的消息弹窗比较混乱,废掉旧的各种协议,统一风格,后续新的客户端弹窗,都通过下列协议下发。
message NewsClientMessage {
int64 type = 1; // 消息类型(对于客户端来说,不需要关注消息的具体分类,此type用来分组多条消息)
NewsClientMessageText title = 2; // 标题
NewsClientMessageText content = 3; // 内容(仅支持有限的富文本标签)
NewsClientMessageAction action = 4; // 动作
}
message NewsClientMessageAction {
NewsClientMessageText btn_text = 1; // 按钮文案
string target_url = 2; // 跳转链接(支持外站或端内页面的伪协议链接,如消息中心,端内购买等)
}
// 3语种文案
message NewsClientMessageText {
string cn = 1;
string en = 2;
string tw = 3;
}
举例说明:
{
”type": 9,
"title": {
"cn": "你有一个新的活动通知",
"en": "You have a new event notification"
},
"content": {
"cn": "你好,这是一条新的<b>消息</b>"
"en": "Hello, this is a new <b>message<-b>",
}
"action": {
"btn_text": {
"cn": "查看更多",
"en": "See more",
},
"target_url": "https://baidu.com"
}
}
sunlogin://goto_homeaction: 二级协议名(2025/11/24新增)sunlogin://goto_device_listaction: 二级协议名(2025/11/24新增)remoteid: 定位到具体的设备(2025/11/24新增)sunlogin://goto_settingsaction: 二级协议名(2025/11/24新增)sunlogin://goto_tools_webaction: 二级协议名(2025/11/24新增)sunlogin://goto_speed_buy?name=msg_centername: 详询前端action: 二级协议名(2025/11/24新增)sunlogin://goto_message_center?type=1type:指定需要定位到的消息类型action: 二级协议名(2025/11/24新增)所有伪协议支持二级协议名,新版本客户端优先识别二级协议名,然后中转过去,旧版本就维持原样
message/HardwareAlarmNoticemessage/ProcessAlarmNotice// 硬件告警通知
message HardwareAlarmNotice {
// 告警标题
string alarm_title = 1;
// 主机名称
string remote_name = 2;
// 告警内容
string alarm_content = 3;
// 告警时间
string alarm_time = 4;
// 控制台url
string console_url = 5;
}此消息不是本来意义上的远控通知,具体查询一下客户端代码, 实际上用来做远控免费版的提示
security/ControlExceptionmessage ControlException {
// 被控设备名称
string pc_name = 1;
// 异常类型:1:warning 2:sensitive 3:other
string type = 2;
// 执行动作:disconnect:中断 show:展示
string action = 3;
// 远控sid
string sid = 4;
// clientdid
string client_id = 5;
// 主控设备名称
string cc_pc_name = 6;
// 对应告警消息ID
int64 record_id = 7;
// 主控用户ID
int64 cc_userid = 8;
// 远控类型
string cc_type = 9;
// 主控版本
string cc_version = 10;
// 弹出时间,单位为秒,收到消息后,用这个时间来倒计时,例如下发的是180,就是180秒后弹
int64 tip_time = 11;
// 弹窗内容,以前没有这个字段的,默认是弹远程控制提醒,现在改成用这个文案 中文
string tip_msg_cn = 12;
// 弹窗内容,以前没有这个字段的,默认是弹远程控制提醒,现在改成用这个文案 英文
string tip_msg_en = 13;
// 弹窗内容,以前没有这个字段的,默认是弹远程控制提醒,现在改成用这个文案 繁体
string tip_msg_tw = 14;
}message/NewClient// 新设备通知
message NewClient {
// 登录应用
string client = 1;
// 时间
string date_time = 2;
// IP
string ip = 3;
// 地点
string place = 4;
// 附带的跳转连接,要支持响应本地伪协议,不一定是http(s)
string url = 5;
}此消息废弃, 实际使用的为 record/NewRecordRemind
security/Sensitivemessage ControlException {
// 被控设备名称
string pc_name = 1;
}此消息废弃, 实际使 用的为 record/NewRecordRemind
security/DisconnectSuccessmessage ControlException {
// 被控设备名称
string pc_name = 1;
string client_id = 2;
}remote-state/RemoteStatemessage RemoteState {
// remoteid,只有fastcode可能是0
int64 remote_id = 1;
// fastcode,没登fastcode可能为空
string fastcode = 2;
// 状态 0 离线 1 在线
int32 state = 3;
// 远控地址
string addr = 4;
// 版本
string version = 5;
// 操作系统
string os_name = 6;
// 客户端IP
string ip = 7;
// 服务器IP
string server_ip = 8;
int64 owner_id = 9;
int64 ent_id = 10;
}目前客户端的部分弹窗基于这个来做
record/NewRecordReminduser_id: 25496881
title: "新设备登录提醒"
content {
date_time: "2024-10-31 15:44:52"
ip: "222.210.215.54"
place: "四川成都"
client: "Windows个人版"
}
send_time: 1730360692
type: new_client
敏感进程告警
user_id: 79524491
title: "敏感进程通知"
content {
date_time: "2024-10-31 19:05:33"
rc_pc_name: "DESKTOP-I5LNHUD"
blacklist_process_name: "wkexe.exe"
}
send_time: 1730372733
type: sensitive_process
远程控制通知
user_id: 25496881
title: "远程控制通知"
content {
date_time: "2024-10-31 16:53:27"
ip: "10.0.28.63:50022"
client: "android控制端"
cc_userid: 25496881
cc_account: "17612102392"
cc_clientid: "92d9db19-fb94-470d-8148-8ec40b544e3c"
cc_pc_name: "Xiaomi 23127PN0CC"
rc_pc_name: "DESKTOP-G9OR681"
sid: "1730364807059458"
rc_fastcode: "464286768"
rc_remote_id: 1245172516
cc_version: "15.3.1.66811"
rc_version: "15.8.0.16287"
remote: "464286768"
rc_os: "BROWSER"
}
send_time: 1730364812
type: control_exception
远控中敏感进程告警
user_id: 79524491
title: "远控中运行了可疑或敏感程序提醒"
content {
date_time: "2024-10-31 19:07:53"
ip: "222.210.214.200"
place: "四川省成都"
client: "android控制端"
cc_userid: 25496881
cc_account: "17612102392"
cc_clientid: "92d9db19-fb94-470d-8148-8ec40b544e3c"
cc_pc_name: "Xiaomi 23127PN0CC"
rc_pc_name: "DESKTOP-I5LNHUD"
sid: "1730372873181237"
rc_fastcode: "k464907483"
rc_remote_id: 1467134201
blacklist_process_name: "wkexe.exe"
cc_version: "15.3.1.66811"
rc_version: "15.8.0.16287"
}
send_time: 1730372930
type: blacklist_process
中断异常连接通知
user_id: 79524491
title: "成功断开远程连接通知"
content {
date_time: "2024-10-31 19:07:53"
ip: "222.210.214.200"
place: "四川省成都"
client: "android控制端"
cc_userid: 25496881
cc_account: "17612102392"
cc_clientid: "92d9db19-fb94-470d-8148-8ec40b544e3c"
cc_pc_name: "Xiaomi 23127PN0CC"
rc_pc_name: "DESKTOP-I5LNHUD"
sid: "1730372873181237"
rc_fastcode: "k464907483"
relate_record_id: 659587803
rc_remote_id: 1467134201
cc_version: "15.3.1.66811"
rc_version: "15.8.0.16287"
remote: "k464907483"
rc_os: "BROWSER"
}
send_time: 1730373021
type: disconnect_remote_success