【设备扩展上行接口】设备调试指令接口

2018/08/31 12:55:53 长星物联云 1772

调用参数:第一栏为参数名称 第二栏为参数值

api_type apiname params_data
deviceCmd buildCmd array()详见下文

params_data说明

参数 类型 备注
third_command_id varchar 客户软件端发起指令ID
command_type varchar 指令分类
command_name varchar 指令名
command_callback_function varchar 设备处理指令后回调长星云端方法
command_packet array 指令包

支持调试功能:

(1)设备软件包升级

参数 参数值 属性 备注
third_command_id 开发者填入 必填 100000
command_type deviceDebug 必填  
command_name deviceUpgrade 必填  
command_callback_function deviceUpgrade_callback 必填  
command_packet

开发者填入

device_soft_version:软件版本号

download_url:升级包下载地址

必填

array(

"device_soft_version

"=>"v2018081601",

"download_url

"=>"http://www.iot5s.com/111.zip

"

)

(2)设备播放资源新增

参数 参数值 属性 备注
third_command_id 开发者填入 必填 100000
command_type deviceDebug 必填  
command_name deviceResourceAdd 必填  
command_callback_function deviceResourceAdd_callback 必填  
command_packet

开发者填入

resource_id:开发者资源库id

resource_type:资源类型(目前支持mp4,jpg,jpeg,gif,png,text,mp3类型)

download_url:下载地址

text_content:资源类型为text时候启用,表示资源文字内容,同时download_url不赋值

必填

array(

"resource_id"=>"20001",

"resource_type"=>

"mp4",

"download_url"=>

"http://www.iot5s.com/111.mp4",

"text_content"=>

""

)

(3)设备播放资源删除

参数 参数值 属性 备注
third_command_id 开发者填入 必填 100000
command_type deviceDebug 必填  
command_name deviceResourceDel 必填  
command_callback_function deviceResourceDel_callback 必填  
command_packet

开发者填入

resource_id:开发者资源库id

必填

array(

"resource_id

"=>"20001

)

(4)设备配置变更

参数 参数值 属性 备注
third_command_id 开发者填入 必填 100000
command_type deviceDebug 必填  
command_name deviceSetIniUpdate 必填  
command_callback_function deviceSetIniUpdate_callback 必填  
command_packet 开发者填入 必填

array(

)

(5)设备通知发布(文字方式通知内容)

参数 参数值 属性 备注
third_command_id 开发者填入 必填 100000
command_type deviceDebug 必填  
command_name deviceNotice 必填  
command_callback_function deviceNotice_callback 必填  
command_packet

开发者填入

notice_content:通知内容

is_voice阅读标识(1有声阅读 0不阅读)本设备不支持阅读

必填

array(

"notice_content

"=>"前方来车小心行驶

",

"is_voice

"=>"0

"

)

(6)车联网雷达反射(用于告知设备设备车联网侦探结果)

参数 参数值 属性 备注
third_command_id 开发者填入 必填 100000
command_type deviceDebug 必填  
command_name iovRadarReflex 必填  
command_callback_function iovRadarReflex_callback 必填  
command_packet

开发者填入

type:类型

data:传入侦探结果数据

必填

array(

"type

"=>"busLineReflex

",

"data

"=>array()

)

接口调用返回数据格式:JSON

调用模式:客户应用主动调用长星物联云

接口调用返回数据解析数组:

【调用错误】

array(2) {  
  ["status"]=>
  int(0)
  ["msg"]=>
  string(22) "encryptionMode is null"
}  

【调用成功】

array(3) {  
  ["status"]=>
  int(1)
  ["msg"]=>
  string(18) "设备指令:创建成功等待系统处理 "
}