• 快速入门
  • HTTP文档
  • .NET开发指南
  • DEMO下载
  • 调用HTTP常见问题
    Show / Hide Table of Contents
    • 登录接口
      • 名词解释
      • 用户登录
      • 重新登录
    • 写值流程
      • 新增FBox分组
      • FBox新增
      • 新增监控点分组
      • 新增数据监控点
      • FBox列表获取
      • FBox监控点列表
      • 监控点值写入
      • 获取监控点值
    • 获取信息接口
      • 获取单个盒子
      • 获取监控点分组
      • 获取某些监控点
      • 根据监控点分组获取监控点
      • 获取物联网卡Iccid、Imei
      • 获取盒子地理位置
    • 远程下载
      • 获取FBox驱动列表
      • 下载盒子驱动
      • 获取连接设备的寄存器类型
      • 获取服务器驱动列表
    • 盒子修改接口
      • 修改FBox分组
      • FBox名称修改
      • 修改数据监控点
      • 修改省流量模式刷新间隔
    • 盒子删除接口
      • 删除FBox分组
      • FBox删除
      • 删除监控点分组
      • 删除数据监控点
    • 报警接口
      • 报警分组接口
        • 获取报警分组列表
        • 新增报警分组
        • 修改报警分组
        • 删除报警分组
      • 报警联系人接口
        • 获取报警联系人列表
        • 获取单个报警联系人
        • 新增报警联系人
        • 修改报警联系人
        • 删除报警联系人
      • 报警记录接口
        • 获取报警条目列表
        • 获取某些报警条目
        • 新增报警条目
        • 修改报警条目
        • 删除报警条目
        • 获取报警历史
        • 获取报警条目状态
        • 确认报警
    • 历史记录接口
      • 获取历史记录条目
      • 获取某些历史记录条目
      • 新增历史记录
      • 更新历史记录
      • 删除历史记录
      • 获取历史记录数据
    • 监控点推送控制接口
      • 开启某监控点组别
      • 停止某监控点组别
      • 开启监控点组别列表
      • 停止监控点组别列表
      • 开启FBox所有监控点
      • 停止FBox所有监控点
      • 开启某条监控点
      • 停止某条监控点
      • 开启某些监控点
      • 停止某些监控点
      • 只开启某些监控点
      • 只开启某监控点组
      • 只开启某些监控点组
    • 数据推送(SignalR)
      • 实时数据推送(signalR)
      • FBox状态变更推送
      • 实时数据推送
      • 报警触发推送
      • 报警还原推送
    • 统一写值
      • 获取所有统一写分组
      • 统一写分组值写入
    • 附录
      • 附录一
      • 附录二
      • 附录三
      • 429状态码

    数据推送相关(SignalR)

    • 功能描述

      所有监控点的实时数据由服务器主动推送,客户端可以控制开启某个或者某几个监控组,开启之后当被开启分组中数据发生变化(有死区设置的变化需要超过死区范围)的时候服务器主动推送给客户端。推送功能需要依赖signalR库。

    • .NET官网文档:

      https://www.asp.net/signalr

    .NET 类库请使用Visual Studio中Nuget工具下载Microsoft.AspNet.WebApi.Client.

    JAVA 示例及 C# 的示例,请去在线问答下载!!!

    注意事项:从官网下载的 or 小易在线问答上下载的 Signalr DEMO ,DEMO里面的 状态变更新事件里面调用开点接口是有限制的,一旦调用接口频繁,会有账号被封的情况,注意开点接口的频率,我们是建议做排队机制,根据盒子数量来 1s /10~20次左右。一定要控制好频率不要重复开点或者超过建议的开点频率。
    

    创建signalR连接

    • 请求地址

      URL:从FBox列表中获取的signalRUrl详情见名词解释

      querystring: at={token}&cid={X-FBox-ClientId}

      字段名 类型 参数描述
      token string accessToken,登录接口里获取的accessToken
      X-FBox-ClientId string 详情见附录一

    ​
    SignalR服务的Hub名:clientHub

    其他注意:

    ​ 1、token有效期是大约两个小时。401为token过期。新版参数需要重新调用登录接口获取access_token。

    ​ 使用登录接方式二要根据refresh_token调重新登录接口刷新access_token后重连SignalR。refresh_token有效期为30天。

    ​ 2、java demo和C# SDK已处理token刷新与Signalr重连问题。不使用demo需要在程序自行处理此流程。

    ​ 3、Signalr要保持长连接,用单例开发 。

    Back to top Generated by DocFX