怎么在共享台球室灯光管理中集成智能设备以实现远程开关状态查询_解决方案

CATALOG

一、行业痛点与解决思路

1.1 共享台球室的运营痛点

共享台球室作为一种新兴的无人值守商业模式，面临以下核心管理难题：

能耗浪费严重：顾客离开现场时后忘记关灯，导致长期空耗电力成本
状态不可见：经营者无法远程了解各球台的灯光使用状态
计费关联困难：灯光使用情况难以与订单计时系统联动
人工巡检成本高：需要频繁到场检查设备状态

1.2 解决方案核心架构

采用智能控制器 + HTTP API + 业务系统对接的技术架构，实现：

远程开关控制：通过云端接口随时开关任意球台的照明
实时状态查询：获取每一路输出的当前通断状态
定时任务联动：与订单系统配合，自动执行开关策略
小程序/APP接入：为消费者提供扫码开灯功能

二、硬件选型方案

2.1 硬件推荐：智能控制器8路|交流电压版

这是共享台球室灯光管理的理想选择

参数项	规格说明
控制路数	8路独立控制（可覆盖8张球台）
额定电流	每路MAX 10A
负载功率	单路阻性负载≤2200W，总额定功率4400W
工作电压	AC 85-265V（市电直接输入）
通讯方式	WiFi 2.4GHz
DI输入	8路开关量信号输入，可外接物理开关
产品尺寸	125×90×40mm（紧凑设计，可放入电箱）

选型优势

一路一台，集中管理：单台设备可控制8张球台的照明灯
安装便捷：直接接入市电，无需额外电源适配器
双重控制路径：支持HTTP远程控制 + 物理开关本地控制
共享场景验证：广泛应用于共享自习室、共享设备改造等场景

2.2 备选方案：按需扩展

场景需求	推荐设备	说明
球台超8张	多台8路控制器并联	通过API统一管理
需控制空调/门禁	智能包间控制器	Max	含16A插座接口和门禁电磁锁接口
DIY单路方案	智能通断器AC4-20A	单路独立，灵活性高

三、系统集成方案

3.1 整体架构图

3.2 接线方案

每张球台的接线方式

照明接入：将球台照明灯的零线、火线引出，接入控制器的对应输出端口
- 第1张球台 → 控制器第1路输出（L1/N1）
- 第2张球台 → 控制器第2路输出（L2/N2）
- 以此类推
本地开关（可选）
- 将墙壁开关接入控制器的DI输入端口
- 保留现场物理控制能力，提升用户体验
电源接入
- 控制器L/N端子接入市电（AC 220V）
- 设备待机功耗仅0.4-1W

四、API接口集成指南

4.1 接口基础信息

芯步提供完整的HTTP API接口，支持任何编程语言接入。

请求地址

POST https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

签名算法

4.2 核心接口实现

4.2.1 远程打开指定球台灯光

命令格式说明

power1: "1" → 打开第1路
power2: "0" → 关闭第2路
支持1-8路独立控制

4.2.2 批量控制多张球台

4.2.3 查询设备状态

通过消息推送机制获取设备实时状态

4.3 完整集成代码示例（Node.js）

const crypto = require('crypto');
const axios = require('axios');

class BilliardLightController {
  constructor(appId, appSecret, deviceId) {
    this.appId = appId;
    this.appSecret = appSecret;
    this.deviceId = deviceId;
    this.apiBase = 'https://api.thingboot.com';
  }

// 生成签名
  generateSign() {
    const ts = Math.floor(Date.now() / 1000);
    const md5Secret = crypto.createHash('md5').update(this.appSecret).digest('hex');
    const sign = crypto.createHash('md5').update(md5Secret + ts).digest('hex');
    return { sign, ts };
  }

// 控制单路灯光
  async controlLight(tableNum, action) {
    // tableNum: 1-8, action: 'on'/'off'
    const powerKey = `power${tableNum}`;
    const command = action === 'on' ? '1' : '0';
    
    const { sign, ts } = this.generateSign();
    const url = `${this.apiBase}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    try {
      const response = await axios.post(url, {
        device: this.deviceId,
        order: { [powerKey]: command }
      });
      return response.data;
    } catch (error) {
      console.error(`控制第${tableNum}路灯光失败:`, error);
      throw error;
    }
  }

// 批量关闭所有灯光
  async allLightsOff() {
    const { sign, ts } = this.generateSign();
    const url = `${this.apiBase}/${this.appId}/device/control/?sign=${sign}&ts=${ts}`;
    
    try {
      const response = await axios.post(url, {
        device: this.deviceId,
        order: { batch: { power: 0 } }
      });
      return response.data;
    } catch (error) {
      console.error('批量关灯失败:', error);
      throw error;
    }
  }

// 根据订单开启对应球台灯光
  async startGame(tableNum, durationMinutes) {
    // 打开灯光
    await this.controlLight(tableNum, 'on');
    
    // 可设置定时自动关闭（利用平台定时任务或业务系统定时器）
    setTimeout(async () => {
      await this.controlLight(tableNum, 'off');
    }, durationMinutes * 60 * 1000);
    
    return { success: true, message: `球台${tableNum}已开灯，时长${durationMinutes}分钟` };
  }
}

// 使用示例
const controller = new BilliardLightController(
  'YOUR_APP_ID',
  'YOUR_APP_SECRET', 
  'DEVICE_ID'
);

// 开1号球台灯光
await controller.controlLight(1, 'on');

// 订单开台:自动开灯，60分钟后自动关灯
await controller.startGame(3, 60);

五、小程序/前端集成方案

5.1 微信小程序接入

芯步设备可以通过HTTP接口直接在小程序中调用，无需额外网关。

// pages/table/table.js
Page({
  data: {
    tableList: [
      { id: 1, status: '空闲', lightOn: false },
      { id: 2, status: '使用中', lightOn: true },
      // ...
    ]
  },

// 用户扫码开台
  async startGame(tableId) {
    wx.showLoading({ title: '开台中...' });
    
    try {
      // 1. 调用业务后端创建订单
      const orderRes = await this.createOrder(tableId);
      
      // 2. 通过业务后端调用芯步API开灯
      await this.controlLight(tableId, 'on');
      
      // 3. 更新前端状态
      this.setData({
        [`tableList[${tableId-1}].lightOn`]: true,
        [`tableList[${tableId-1}].status`]: '使用中'
      });
      
      wx.hideLoading();
      wx.showToast({ title: '开台成功，灯光已开启' });
    } catch (error) {
      wx.hideLoading();
      wx.showToast({ title: '开台失败', icon: 'none' });
    }
  },

// 用户结账关灯
  async endGame(tableId) {
    // 调用业务后端:结算订单 + 关灯
    await this.controlLight(tableId, 'off');
    // 更新状态...
  },

// 调用业务后端接口（后端再调芯步API）
  controlLight(tableId, action) {
    return new Promise((resolve, reject) => {
      wx.request({
        url: 'https://your-server.com/api/light/control',
        method: 'POST',
        data: { tableId, action },
        success: res => {
          if (res.data.code === 200) resolve(res.data);
          else reject(res.data);
        },
        fail: reject
      });
    });
  }
});

5.2 经营者管理后台功能

功能模块	说明
设备看板	可视化展示所有球台灯光实时状态
远程控制	单个/批量控制灯光开关
定时策略	设置营业时间自动开关机
异常告警	设备离线、长时间未关灯提醒
能耗统计	各球台用电量分析

六、订单系统联动

七、总结

维度	传统方式	本方案
管理效率	需人工到场巡检	云端可视化管理，随时随地控制
能耗控制	依赖顾客自觉关灯	订单结束自动关灯，杜绝浪费
状态感知	无法远程知晓	实时获取每路灯光状态
计费公平	时间不准或估算	灯亮计时，灯停计费，精准可控
扩展能力	难以接入新设备	HTTP API开放，轻松对接订单/会员系统
改造成本	需更换整套设备	保留原有线路，8路集中控制，布线简单

八、实施

分阶段部署：先选取1-2家门店试点，验证方案后再全面推广
预留应急方案：保留物理开关作为备用控制路径
网络保障：确保控制器所在位置WiFi信号稳定，采用企业级AP
API调用限流：合理设计轮询策略，避免频繁调用接口
异常处理机制：网络波动时设备会自动重连，业务系统需处理命令超时场景

通过芯步的智能控制器和开放的HTTP API接口，共享台球室经营者可以快速搭建一套低成本、高可靠、可扩展的智能灯光管理系统，实现真正的无人值守运营。