长连接功能

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


概述

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


因为长连接耗费较多硬件和带宽资源,长期成本太高,云服务是买不起了。 所以CL花费了3万元新购了一台DELL T440服务器,配置了双志强银牌4210CPU、128G内存DDR4 ECC内存,3.84T固态硬盘和 4*4T SAS硬盘,外加入门级山特UPS防止意外断电。最终建成了“办公室机房”,希望可以通过这种方式以较低成本带给大家方便。

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


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

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


关于专业版和免费版

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


  • 免费版用户:
    • 支持使用GET请求发送copy和paste操作,不支持发送action操作(执行动作)。
    • 不支持Post请求。
  • 专业版用户:
    • 支持所有操作类型;
    • 支持POST请求,最大支持100KB大小;



设置

设置推送验证码

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


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】操作类型,支持如下的值:

  • copy  将内容复制到剪贴板
  • paste  将内容粘贴到当前窗口
  • action  执行动作,此时:
    • 网址中需附加action参数:.....&action=动作ID或动作名&... (使用动作名时,需保证没有重名的动作)。
    • data数据内容将作为动作的输入参数传递。【仅专业版支持】


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


可选参数

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

  • 如果不指定或指定为*,则发送给“活动”客户端(通常为最后连接的客户端)。
  • 指定主机名,则发送给此设备。(可在命令行窗口中运行hostname查看当前计算机的主机名)
  • 指定“!主机名”(英文半角叹号加设备名,不包含引号),发送给除此设备以外的其他设备。


【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"
}





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

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


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

image.png


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



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


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

image.png



同步通知

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



示例

语雀在语雀上查看