如何用Python语言控制TTS版包间电源控制器

2026-01-11 发布浏览：617 次

本文介绍了如何用 Python 对接智能包间控制器的方法：可以通过接口实现HTTP接口远程独立控制通断、多路输出设备电源控制、照明换气扇电源控制、麻将机设备电源控制、空调电源控制、门禁电磁锁接口控制、语音播报TTS远程通知、定时任务设置、自定义联动操作。

智能包间控制器

服务型门店包间专用；

广泛应用于共享棋牌室、茶室、休息室、舞蹈练习室、琴房、沐浴房等场景；

提供1路30A插座接口，可接2匹空调；

提供3路10A开关，或接照明或换气扇、吸烟灯等电器；

提供2路10A插座接口，可接饮水机、麻将机、按摩仪等电器；

提供1路门禁电磁锁接口，可接任何直流电磁锁和电插锁；

共7路，总额定功率6600W，可覆盖包间内所有电器；

所有线路（输出接口）均可通过HTTP接口远程独立控制通断；

TTS版本支持远程语音播报，可用在订单提醒或服务说明；

支持远程定时任务，支持自定义联动操作；

更多...

适用场景

共享棋牌室包间控制、共享茶室包间控制、共享自习室包间管理、共享台球室包间控制、舞蹈练习室设备管理、琴房设备控制、沐浴房场景控制、门店包间设备电源管理、无人值守包间设备控制、线下服务门店包间管理中

支持命令

线路1	power1
线路2	power2
线路3	power3
线路4	power4
线路5	power5
线路6	power6
线路7	power7
喇叭音量	volume
喇叭音色	voice
喇叭语速	speed
喇叭语调	tone
批量控制	batch
先通后断	point
先断后通	reset
语音播报	play:gbk:16
喇叭铃声	ring
喇叭提示音	message
喇叭警示音	alert
停止播放	stop

产品手册

版本	对应产品手册
语音播报:不带\|天线:内置	《智能包间控制器产品手册》
语音播报:不带\|天线:外置	《智能包间控制器产品手册》
语音播报:带\|天线:内置	《智能包间控制器[TTS版]产品手册》
语音播报:带\|天线:外置	《智能包间控制器[TTS版]产品手册》

HTTP接口控制以设备控制（向设备下发命令）为例

# First you need to prepare the following values
# 1. AppID (in your console development settings)
# 2. AppSecret (in your console development settings)
# 3. ts (timestamp of the current time, seconds)
# 4. YourSign = md5(md5(AppSecret)ts);(md5 is an encryption method, AppSecret is the AppSecret prepared above, ts is the timestamp prepared above, concatenate the string after the AppSecret after md5 encryption)
# In simple terms, the signature is md5(md5(your developer password)concatenate the above ts timestamp value); ts is the timestamp of the current timestamp; that is, to perform one MD5 on the developer password (AppSecret), then concatenate the timestamp, and then perform one MD5 on the entire concatenated string
# Core request address: api.thingboot.com/AppID/device/control/?sign=YourSign&&ts=ts;
# Request needs to pass two parameters device and order:
# device[string]: unique device ID, can pass multiple [separated by ,], can be viewed in the console, or pulled through the interface
# order[json string]: the command to be issued, for example:
# {"power":1}, usually to connect the circuit of the switch
# {"power3":0}, usually to close the third line of the switch or controller
# {"play:gbk:16":"hello, welcome to visit"}, let the voice speaker report the specified content
# The same type of product, the command is the same, different product types of commands, please view the product manual page of each product
# Note: you must replace the formal AppID and AppSecret with real-time timestamp calculation of the signature, the request must have device device ID and order command

import hashlib
import json
import http.client
import time
from urllib.parse import urlencode

def calculate_md5(s):
    return hashlib.md5(s.encode()).hexdigest()

def send_request():
    app_id = "开发者ID"  # 替换为实际的 AppID
    app_secret = "开发者密码"  # 替换为实际的 AppSecret
    ts = int(time.time())  # 获取当前时间戳（秒）

    # 计算签名  md5(md5(开发者密码)拼接上面的ts参数)
    sign = calculate_md5(calculate_md5(app_secret) + str(ts))

    # 构建 URL
    base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }

    # 构建请求体数据
    device = "1878"  # 替换为实际的设备ID；可传多个[用,间隔]
    order = {"power1": 1}  # 替换为实际的命令

    request_body = {
        "device": device,
        "order": order
    }

    json_body = json.dumps(request_body)

    # 创建请求
    conn = http.client.HTTPSConnection("api.thingboot.com")
    headers = {
        "Content-Type": "application/json"
    }

    # 发送请求
    conn.request("POST", f"/{app_id}/device/control/?{urlencode(params)}", json_body, headers)

    # 获取响应
    response = conn.getresponse()
    response_data = response.read().decode('utf-8')

    print("Response Status Code:", response.status)
    print("Response Body:", response_data)

    conn.close()

# 调用函数
send_request()

# First you need to prepare the following values
# 1. AppID (in your console development settings)
# 2. AppSecret (in your console development settings)
# 3. ts (timestamp of the current time, seconds)
# 4. YourSign = md5(md5(AppSecret)ts);(md5 is an encryption method, AppSecret is the AppSecret prepared above, ts is the timestamp prepared above, concatenate the string after the AppSecret after md5 encryption)
# In simple terms, the signature is md5(md5(your developer password)concatenate the above ts timestamp value); ts is the timestamp of the current timestamp; that is, to perform one MD5 on the developer password (AppSecret), then concatenate the timestamp, and then perform one MD5 on the entire concatenated string
# Core request address: api.thingboot.com/AppID/device/control/?sign=YourSign&&ts=ts;
# Request needs to pass two parameters device and order:
# device[string]: unique device ID, can pass multiple [separated by ,], can be viewed in the console, or pulled through the interface
# order[json string]: the command to be issued, for example:
# {"power":1}, usually to connect the circuit of the switch
# {"power3":0}, usually to close the third line of the switch or controller
# {"play:gbk:16":"hello, welcome to visit"}, let the voice speaker report the specified content
# The same type of product, the command is the same, different product types of commands, please view the product manual page of each product
# Note: you must replace the formal AppID and AppSecret with real-time timestamp calculation of the signature, the request must have device device ID and order command

import hashlib
import json
import requests
import time
from urllib.parse import urlencode

def calculate_md5(s):
    return hashlib.md5(s.encode()).hexdigest()

def send_request():
    app_id = "开发者ID"  # 替换为实际的 AppID
    app_secret = "开发者密码"  # 替换为实际的 AppSecret
    ts = int(time.time())  # 获取当前时间戳（秒）

    # 计算签名 md5(md5(开发者密码)拼接上面的ts参数)
    sign = calculate_md5(calculate_md5(app_secret) + str(ts))

    # 构建 URL
    base_url = f"https://api.thingboot.com/{app_id}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }

    # 构建请求体数据
    device = "1878"  # 替换为实际的设备ID；可传多个[用,间隔]
    order = {"power1": 1}  # 替换为实际的命令

    request_body = {
        "device": device,
        "order": order
    }

    # 发送请求
    response = requests.post(
        base_url,
        params=params,
        json=request_body,
        headers={"Content-Type": "application/json"}
    )

    # 输出响应
    print("Response Status Code:", response.status_code)
    print("Response Body:", response.text)

# 调用函数
send_request()

说明：{AppID}为您的应用ID（由平台生成），免费注册登录后，可在控制台查看；sign和ts的取值，请参考文档。