多媒体平台 MQTT API 1.0.0

用于描述多媒体平台MQTT API,包括topic和消息体格式

Servers

  • 172.168.35.3:1883sslproduction

    测试用服务器

Operations

  • SUB $SYS/license

    终端授权信息

    程序开始运行时订阅该主题接收授权信息

    Accepts the following message:

    license授权信息

    设备MQTT授权信息

    object
    uid: licensePayload

    Examples

  • SUB $SYS/TrustedTerminal

    已授权设备Mac地址

    程序开始运行时订阅该主题接收授权设备Mac地址

    Accepts the following message:

    trustedTerminal授权设备列表

    授权设备列表

    array<string>
      Examples values:
    • [DAFADC0A9311,DAFADC0A9312,DAFADC0A931A]

    Examples

  • SUB /0001/+/shinemds/{Mac}/sub

    终端收数据主题

    Mac
    required
    string
    uid: Mac

    设备Mac地址,全大写,无冒号

    Accepts one of the following messages:

    • #0shutdown关机
      object

      Examples

    • #1reboot重启设备
      object

      Examples

    • #2forceUpdate强制更新
      object

      Examples

    • #3backlight定时开关屏

      推送的同时需要写入到配置中,开机获取

      object

      Examples

    • #4disableBacklight设备关屏
      object

      Examples

    • #5enableBacklight设备开屏
      object

      Examples

    • #6diskInfo查询磁盘信息

      需要上报服务器

      object

      Examples

    • #7downloadInfo查询下载信息

      客户端上报下载进度给服务器

      object

      Examples

    • #8screenCap设备截图

      客户端上传截图文件后,上传结果上报给服务器

      object

      Examples

    • #9screenRecord设备录屏

      客户端上传视频文件后,上传结果上报给服务器

      object

      Examples

    • #10marqueeLocation跑马灯位置

      跑马灯位置默认位于屏幕底部;写入到配置中,开机获取

      object

      Examples

    • #11timerSwitch设备定时开关机

      包含按周循环开关机和跨天开关机;写入到配置中,开机获取

      跨天开关机可以两种:

      • 指定时间段内某几天按周循环:比如5.1到6.20的每周一和周四上午六点开机,晚上十点关机,其余时间按照正常开关机设置进行
      • 精确到某天时分开关机时间:比如5.1关机,5.20开机
      object

      Examples

    • #12brightness屏幕亮度

      包含精简模式和高级模式的亮度设置;写入到配置中,开机获取

      object

      Examples

    • #13volume设备音量

      包含精简模式和高级模式的音量设置;写入到配置中,开机获取

      object

      Examples

    • #14downloadSpeedLimit下载限速

      写入到配置中,开机获取

      object

      Examples

    • #15saveLog保存日志

      写入到配置中,开机获取

      object

      Examples

    • #16fetchLog取日志

      客户端上传日志文件后,上传结果上报给服务器

      object

      Examples

    • #17reload重载web程序

      当后台删除设备时发送该消息,终端刷新页面

      object

      Examples

  • PUB /0001/0001/shinemds/{Mac}/pub

    终端发数据主题

    Mac
    required
    string
    uid: Mac

    设备Mac地址,全大写,无冒号

    Accepts one of the following messages:

    • #0uploadDiskInfo上传磁盘信息

      各个分区可用磁盘空间信息

      object

      Examples

    • #1uploadDownloadInfo上传下载信息

      下载信息写入数据库后,通知给服务器实时更新UI。包含下载进度、下载结果

      object

      Examples

    • #2uploadDeviceInfo上传设备信息

      连接服务器成功后上报设备主板类型、内核版本、软件版本等信息给服务器

      object

      Examples

    • #3uploadScreenCap上传屏幕截图文件

      上传屏幕截图文件后,把结果通知给服务器

      object

      Examples

    • #4uploadScreenRecord上传屏幕录屏文件

      上传屏幕录屏文件后,把结果通知给服务器

      object

      Examples

    • #5uploadLog上传日志文件

      上传日志文件后,把结果通知给服务器

      object

      Examples

Messages

  • #1license授权信息

    设备MQTT授权信息

    object
    uid: licensePayload
  • #2shutdown关机
    object
  • #3reboot重启设备
    object
  • #4forceUpdate强制更新
    object
  • #5backlight定时开关屏

    推送的同时需要写入到配置中,开机获取

    object
  • #6disableBacklight设备关屏
    object
  • #7enableBacklight设备开屏
    object
  • #8diskInfo查询磁盘信息

    需要上报服务器

    object
  • #9downloadInfo查询下载信息

    客户端上报下载进度给服务器

    object
  • #10deviceInfo设备信息

    客户端上报设备主板类型、内核版本、软件版本等信息给服务器

    object
  • #11uploadDiskInfo上传磁盘信息

    各个分区可用磁盘空间信息

    object
  • #12uploadDownloadInfo上传下载信息

    下载信息写入数据库后,通知给服务器实时更新UI。包含下载进度、下载结果

    object
  • #13uploadDeviceInfo上传设备信息

    连接服务器成功后上报设备主板类型、内核版本、软件版本等信息给服务器

    object
  • #14uploadScreenCap上传屏幕截图文件

    上传屏幕截图文件后,把结果通知给服务器

    object
  • #15uploadScreenRecord上传屏幕录屏文件

    上传屏幕录屏文件后,把结果通知给服务器

    object
  • #16uploadLog上传日志文件

    上传日志文件后,把结果通知给服务器

    object
  • #17screenCap设备截图

    客户端上传截图文件后,上传结果上报给服务器

    object
  • #18screenRecord设备录屏

    客户端上传视频文件后,上传结果上报给服务器

    object
  • #19marqueeLocation跑马灯位置

    跑马灯位置默认位于屏幕底部;写入到配置中,开机获取

    object
  • #20timerSwitch设备定时开关机

    包含按周循环开关机和跨天开关机;写入到配置中,开机获取

    跨天开关机可以两种:

    • 指定时间段内某几天按周循环:比如5.1到6.20的每周一和周四上午六点开机,晚上十点关机,其余时间按照正常开关机设置进行
    • 精确到某天时分开关机时间:比如5.1关机,5.20开机
    object
  • #21brightness屏幕亮度

    包含精简模式和高级模式的亮度设置;写入到配置中,开机获取

    object
  • #22volume设备音量

    包含精简模式和高级模式的音量设置;写入到配置中,开机获取

    object
  • #23downloadSpeedLimit下载限速

    写入到配置中,开机获取

    object
  • #24saveLog保存日志

    写入到配置中,开机获取

    object
  • #25fetchLog取日志

    客户端上传日志文件后,上传结果上报给服务器

    object
  • #26reload重载web程序

    当后台删除设备时发送该消息,终端刷新页面

    object

Schemas

  • object
    uid: licensePayload
  • object
    uid: product
  • object
    uid: screenRecordInfo
  • object
    uid: marqueeLocationInfo
  • object
    uid: timingInfo
  • object
    uid: timingItemInfo
  • array<object>
    uid: backlightInfo
  • array<object>
    uid: brightnessInfo
  • array<object>
    uid: volumeInfo
  • object
    uid: downloadSpeedLimitInfo
  • object
    uid: fetchLogInfo
  • startTime
    string
    uid: startTime

    开始时分时间,如 "08:00"

  • endTime
    string
    uid: endTime

    结束时分时间,结束时间必须大于开始时间,如 "10:00"

  • week
    string
    uid: week

    星期几,0是周日

      Allowed values:
    • "0"
    • "1"
    • "2"
    • "3"
    • "4"
    • "5"
    • "6"
  • time
    number
    uid: time

    单位毫秒,消息时间戳

      Examples values:
    • 1621425835000
  • deviceID
    string
    uid: deviceID

    设备的唯一ID,Android设备为Mac地址

      Examples values:
    • "DAFADC0A9311"
  • sender
    string
    uid: sender

    消息来源

  • serverSender
    string
    uid: serverSender

    消息来自Server

      Allowed values:
    • "server"
  • androidSender
    string
    uid: androidSender

    消息来自Android设备

      Allowed values:
    • "android"