如何用Swift语言对接智能语音物联网台卡

2026-05-20 发布浏览：75 次

本文介绍了如何用 Swift 对接智能语音台卡的方法：可以通过接口实现收款语音播报触发、自定义收款金额语音播报、收款成功/失败语音提示、远程语音播报控制、收款通知语音推送、定时收款语音提醒、场景联动收款播报、设备状态语音反馈、远程音量调节控制、收款记录语音播报、多设备收款语音同步播报、自定义收款语音模板设置。

智能语音台卡

更多...

适用场景

智能办公工位语音提醒场景、前台接待语音引导场景、会议室预约签到语音提示场景、办公室茶水间语音通知场景、写字楼大厅语音播报场景、企业前台访客引导场景、会议室预约状态语音提示场景、办公区设备故障语音告警场景、智慧教室语音点名提醒场景、培训机构教室签到提示场景、图书馆自习室座位预约语音通知场景、实验室设备状态语音播报场景、教研教室教学辅助语音提示场景、创客工坊设备操作语音引导场景、学校活动室活动通知场景、培训教室上课下课语音提醒场景、酒店前台入住引导语音提示场景、餐厅奶茶店叫号

支持命令

音量	volume
音色	voice
语速	speed
语调	tone
播报	play:gbk:16
铃声	ring
提示音	message
警示音	alert
重复	repeat
停止	stop

产品手册

版本	对应产品手册
白色	《智能语音台卡产品手册》

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 Foundation
import CommonCrypto

func calculateMD5(string: String) -> String {
    let length = Int(CC_MD5_DIGEST_LENGTH)
    var digest = [UInt8](repeating: 0, count: length)
    if let data = string.data(using: String.Encoding.utf8) {
        _ = data.withUnsafeBytes { (bytes: UnsafeRawBufferPointer) -> Void in
            CC_MD5(bytes.baseAddress, CC_LONG(data.count), &digest)
        }
    }
    var digestHex = ""
    for index in 0..<length {
        digestHex += String(format: "x", digest[index])
    }
    return digestHex
}

func sendRequest() {
    let AppID = "开发者ID" // 替换为实际的 AppID
    let AppSecret = "开发者密码" // 替换为实际的 AppSecret
    let ts = Int(Date().timeIntervalSince1970) // 获取当前时间戳（秒）
 
    // 计算签名  md5(md5(开发者密码)拼接上面的ts参数)
    let sign = calculateMD5(string: calculateMD5(string: AppSecret) + String(ts))

    // 构建 URL
    let urlString = "https://api.thingboot.com/\(AppID)/device/control/?sign=\(sign)&ts=\(ts)"
    guard let url = URL(string: urlString) else {
        print("Invalid URL")
        return
    }

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

    // 构建请求体
    let postData = "{\"device\":\"\(device)\",\"order\":\(order)}".data(using: .utf8)!

    // 创建请求
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = postData

    // 发送请求
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
        if let error = error {
            print("Error: \(error.localizedDescription)")
            return
        }

        if let httpResponse = response as? HTTPURLResponse {
            print("HTTP Response Status Code: \(httpResponse.statusCode)")
        }

        if let data = data, let responseString = String(data: data, encoding: .utf8) {
            print("Response: \(responseString)")
        }
    }

    task.resume()
}

// 调用函数
sendRequest()

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

如何用Swift语言对接智能语音物联网台卡

智能语音台卡

适用场景

支持命令

产品手册

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

文章：

如何用Swift语言对接智能语音物联网台卡

相关技术文章：

怎么用Swift语言对接30W壁挂语音通知音箱

怎么用Swift语言控制智能通用控制器|24路

如何用Swift语言对接3路2灯1控复合开关

怎样用Swift语言对接智能 20W 壁挂远程控制语音音箱

如何用Swift语言控制10A 86型定时开关插座

Please contact me

智能语音台卡

适用场景

支持命令

产品手册

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

文章：

如何用Swift语言对接智能语音物联网台卡

相关技术文章：

怎么用Swift语言对接30W壁挂语音通知音箱

怎么用Swift语言控制智能通用控制器|24路

如何用Swift语言对接3路2灯1控复合开关

怎样用Swift语言对接智能 20W 壁挂远程控制语音音箱

如何用Swift语言控制10A 86型定时开关插座

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