本功能处于开发与测试状态,会随时重启、更新、调试或断开。


概述

长连接是指在Quicker软件与服务器之间建立一条持续存在的网络连接。有了这条连接之后,Quicker服务端可以主动将信息推送给电脑。


本服务将在较长时期内以“试运行”方式提供,期待稳定性能够经受住考验😁。


本服务连接全程使用SSL/HTTPS传输,所以理论上还是比较安全的。

目前所有数据无存储。未来可能提供选项是否将某些推送数据保存起来以备某些情况下使用。


关于专业版和免费版

CL一方面希望希望能给更多的人提供方便,另一方面也希望更多的人付费来支持Quicker的长期开发和运营。因此长连接功能是否给免费用户提供,是一个有点矛盾的问题。目前暂定的方案如下,CL保留随时根据需要进行调整的权力。




设置

设置推送验证码

验证码用于避免其他人将信息推送到你的电脑或获取你的连接信息,请务必保证安全。

在Quicker网站用户中心页面中,点击“个人设置”(点此链接直达)。在此页面中设置推送验证码。

image.png

验证码为空时,不接受推送信息。

点击“随机生成”可以自动生成一串密码。

点击“复制”可以将密码复制到剪贴板。


连接到推送服务

使用1.5.2+ 版本的Quicker客户端软件。点击“用户”图标,在菜单中选择“连接到推送服务”。

image.png


连接成功后,图标显示一个绿点:

image.png


这时候就可以通过网络接口向客户端推送数据了。


接口说明


推送内容到电脑

将内容推送到Windows。


使用GET方式调用


https://push.getquicker.net/push?toUser=自己的帐号email&code=推送验证码&operation=操作类型&data=经过URL编码的数据


除了data以外,其他各参数值如果包含特殊字符,也应使用URL编码处理一下。在编码处理比较方便的情况下,应该对每个参数的值都做URL编码处理。


参数说明

【toUser】自己的帐号Email地址。


【code】推送验证码,为本文开始部分所说明的网页中设置的验证码。


【operation】操作类型,支持如下的值:


【data】经过URL编码的文本内容。请注意不要太长,否则可能导致构建的网址太长从而使http请求失败。


可选参数

【toDevice】要发送给的设备名。


【action】当operation参数为“action”时,使用本参数指定要执行动作的ID或名称。


返回数据格式

返回Json格式的数据:


{
    "successCount": 1,
    "errorMessage": ""
}

【successCount】成功发送给的客户端数量。0表示失败。

【errorMessage】发送失败时错误消息的内容。



使用Post方式调用

接口网址:https://push.getquicker.net/push

接口参数:Post请求体以json格式传递参数。

参数内容同Get请求。示例:


{
    "toUser":"youremail@domain.com",
    "code":"XsfFYC6Q48ib",
    "data":"Hello Quicker!Quicker真好玩!哈哈😄",
    "operation":"paste"
}




获得已连接的设备

使用Get方式调用:

https://push.getquicker.net/helpers/getdevices?user=自己的帐号email&code=推送验证码


返回结果:


{
"count": 1, //设备数量
"devices": [
  {
  "name": "DESKTOP-123456", //电脑主机名
  "isActive": true, //是否活动主机(如果同时有多个电脑连接,其中会有一个是活动主机)
  "ip": "111.116.181.33" // 主机的公网IP
  }
],
"isSuccess": true,
"message": null
}




多客户端使用同一个帐号连接

当多个客户端使用同一个帐号连接时,只有一个客户端可以处于“活动”状态。推送的内容将默认发送到“活动”客户端。


活动状态的客户端用户图标右下角的点为绿色

image.png


非活动客户端用户图标右下角的点为灰色



后连接的客户端会自动变为“活动”客户端。


如果希望将非活动客户端转变为活动客户端,可以点击“设为活动客户端”菜单。

image.png



同步通知

使用同一帐号的设备都连接到推送服务器之后,当一个电脑上修改配置后,将会在30-60秒之后通知其他电脑进行同步。



示例