MDS Demo APP

Demo PSC


#Command及说明

<p>[TOC]</p> <h1>版本记录</h1> <table> <thead> <tr> <th style="text-align: left;">更新日期</th> <th style="text-align: left;">版本号</th> <th style="text-align: left;">更新内容</th> <th style="text-align: left;">作者</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">2021/3/1</td> <td style="text-align: left;">V2.0.0</td> <td style="text-align: left;">初稿</td> <td style="text-align: left;">Lux</td> </tr> <tr> <td style="text-align: left;">2021/4/9</td> <td style="text-align: left;">V2.0.1</td> <td style="text-align: left;">修改2.38 IOTYPE_USER_IPCAM _DEVICE_SUPPORT_CLOUD _RESP = 0x800D</td> <td style="text-align: left;">Lux</td> </tr> <tr> <td style="text-align: left;">2021/6/29</td> <td style="text-align: left;">V2.0.2</td> <td style="text-align: left;">增加2.42 获取设备人形侦测开关;2.43 设置设备人形侦测开关;2.44 获取设备夜视开关;2.45 设置设备夜视开关;2.46 获取设备夏令时开关;2.47 设置设备夏令时开关;修改2.7 获取设备事件列表</td> <td style="text-align: left;">Lux</td> </tr> <tr> <td style="text-align: left;">2021/11/16</td> <td style="text-align: left;">V2.0.3</td> <td style="text-align: left;">增加2.27 呼叫Client端开始传送Video Frame;2.28 呼叫Client端停止传送Video Frame;2.35 结束通话;2.36 呼叫方发出通话请求;2.37 被呼叫方响应呼叫请求;调整部分编号</td> <td style="text-align: left;">Lux</td> </tr> </tbody> </table> <hr /> <h1>一、IO Command定义</h1> <blockquote> <p>注:设备需要依据TUTK提供的IO Command文档进行功能对接。为规范公版Kalay APP IO Command的设定和使用,禁止随意更改公版IO Command已制定的参数和结构体,如因随意更改造成设备无法成功对接公版APP,TUTK无需承担任何责任。同时,为满足客制化项目的需求,将预留部分参数区段以供客制化Command的设定。</p> </blockquote> <h2>1.1 公版和客制化使用的参数区段</h2> <p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/732be5894fb27a68ea17d0db01b1c08c" alt="" /></p> <h2>1.2 结构体定义规范及限制</h2> <ul> <li>结构体的数据所占字节数应为4的倍数</li> <li>结构体的数据所占字节数应不超过1024字节</li> </ul> <hr /> <h1>二、结构体及说明</h1> <h2>2.1 呼叫设备开始传送Video Frame</h2> <p><strong>IOTYPE_USER_IPCAM_START = 0x01FF;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device开始发送视频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.2 呼叫设备停止传送Video Frame</h2> <p><strong>IOTYPE_USER_IPCAM_STOP = 0x02FF;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device停止发送视频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.3 呼叫设备开始传送Audio Frame</h2> <p><strong>IOTYPE_USER_IPCAM_AUDIOSTART = 0x0300;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device开始发送音频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.4 呼叫设备停止传送Audio Frame</h2> <p><strong>IOTYPE_USER_IPCAM_AUDIOSTOP = 0x0301;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device停止发送音频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.5 设定设备SD卡录像模式</h2> <p><strong>IOTYPE_USER_IPCAM_SETRECORD_REQ = 0x0310;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要设置设备SD卡录像模式。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned int recordType; // 参考ENUM_RECORD_TYPE unsigned char reserved[4]; }SMsgAVIoctrlSetRecordReq, SMsgAVIoctrlGetRecordResq; typedef enum { AVIOTC_RECORDTYPE_OFF = 0x00; AVIOTC_RECORDTYPE_FULLTIME = 0x01; AVIOTC_RECORDTYPE_ALARM = 0x02; AVIOTC_RECORDTYPE_MANUAL = 0x03; }ENUM_RECORD_TYPE;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SETRECORD_RESP = 0x0311;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知App设置结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { int result; // 0 成功, otherwise: 失败。 unsigned char reserved[4]; }SMsgAVIoctrlSetRecordResp;</code></pre> <h2>2.6 获取设备目前SD卡录像模式</h2> <p><strong>IOTYPE_USER_IPCAM_GETRECORD_REQ = 0x0312;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备SD卡录像模式。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; }SMsgAVIoctrlGetRecordReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GETRECORD_RESP = 0x0313;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将录像类型配置放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned int recordType; // 参考ENUM_RECORD_TYPE unsigned char reserved[4]; }SMsgAVIoctrlSetRecordReq, SMsgAVIoctrlGetRecordResq; typedef enum { AVIOTC_RECORDTYPE_OFF = 0x00; AVIOTC_RECORDTYPE_FULLTIME = 0x01; AVIOTC_RECORDTYPE_ALARM = 0x02; AVIOTC_RECORDTYPE_MANUAL = 0x03; }ENUM_RECORD_TYPE;</code></pre> <h2>2.7 获取设备事件列表</h2> <p><strong>IOTYPE_USER_IPCAM_LISTEVENT_REQ = 0x0318;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备事件列表。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index STimeDay stStartTime; // 搜寻事件的起始时间 ... STimeDay stEndTime; // ... 搜寻事件的结束时间 unsigned char event; // 事件类型,参考ENUM_EVENTTYPE unsigned char status; // 0x00: 录像文件存在,事件未读取 // 0x01: 录像文件存在,事件已读取 // 0x02: 无录像文件记录 unsigned char reserved[2]; }SMsgAVIoctrlListEventReq; typedef struct { unsigned short year; // 年份数 unsigned char month; // 自一月以来的月数,范围为1到12。 unsigned char day; // 每月的日期,范围为1到31。 unsigned char wday; // 自星期日以来的天数,范围为0到6。(星期日= 0,星期一= 1,...) unsigned char hour; // 午夜之后的小时数,范围为0到23。 unsigned char minute; // 小时后的分钟数,范围为0到59。 unsigned char second; // 分钟后的秒数,范围为0到59。 }STimeDay;</code></pre> <p><strong>IOTYPE_USER_IPCAM_LISTEVENT_RESP = 0x0319;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将录像列表放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned int total; // 搜索的总事件数 unsigned char index; // 数据包索引, 0,1,2... // avSendIOCtrl 一次最多可发送1024 个字节; //总事件可以分为x个包; x是0,1,2 ... unsigned char endflag; // end flag = 1表示此数据包是最后一个数据包,否则有更多的数据包要接收。 unsigned char count; //此封包中有多少个事件。 unsigned char reserved[1]; SAvEvent stEvent[0]; //此封包中所有事件的第一个地址 }SMsgAVIoctrlListEventResp; typedef struct { STimeDay stTime; unsigned char event; // 参考ENUM_EVENTTYPE unsigned char status; // 0x00: 录像文件存在,事件未读取 // 0x01: 录像文件存在,事件已读取 // 0x02: 无录像文件记录 unsigned short duration; // 事件持续时间(以秒为单位) }SAvEvent; typedef enum { AVIOCTRL_EVENT_ALL = 0x00; // 所有事件类型 AVIOCTRL_EVENT_MOTIONDECT = 0x01; // 移动侦测启动 AVIOCTRL_EVENT_VIDEOLOST = 0x02; // 视频报警丢失 AVIOCTRL_EVENT_IOALARM = 0x03; // IO报警启动 AVIOCTRL_EVENT_MOTIONPASS = 0x04; // 移动侦测结束 AVIOCTRL_EVENT_VIDEORESUME = 0x05; // 视频检索 AVIOCTRL_EVENT_IOALARMPASS = 0x06; // IO报警结束 AVIOCTRL_EVENT_MOVIE = 0x07; AVIOCTRL_EVENT_TIME_LAPSE = 0x08; AVIOCTRL_EVENT_EMERGENCY = 0x09; AVIOCTRL_EVENT_EXPT_REBOOT = 0x10; // 系统异常重启 AVIOCTRL_EVENT_SDFAULT = 0x11; // SD Card记录异常 AVIOCTRL_EVENT_FULLTIME_RECORDING = 0x12; // 全时录像 AVIOCTRL_EVENT_PIR = 0x13; // PIR侦测 AVIOCTRL_EVENT_RINGBELL = 0x14; // 门铃呼叫 AVIOCTRL_EVENT_SOUND = 0x15; AVIOCTRL_EVENT_HUMANOID_DETECTION = 0x16; // 人形侦测 }ENUM_EVENTTYPE;</code></pre> <h2>2.8 事件回播控制播放</h2> <p><strong>IOTYPE_USER_IPCAM_RECORD_PLAYCONTROL_REQ = 0x031A;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要进行录像事件回放。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned int command; // 播放记录指, 参考ENUM_PLAYCONTROL. unsigned int Param; // 指令参数,由用户自定义 STimeDay stTimeDay; // 事件列表起始时间 unsigned char endflag; // 0 app, 事件播放完毕; 1 web, 当此事件播放完毕时继续播下一个事件 unsigned char downloadFlag; // 0 回放模式, 1 下载模式 unsigned char reserved[2]; } SMsgAVIoctrlPlayRecordReq; typedef enum { AVIOCTRL_RECORD_PLAY_PAUSE = 0x00; AVIOCTRL_RECORD_PLAY_STOP = 0x01; AVIOCTRL_RECORD_PLAY_STEPFORWARD = 0x02; AVIOCTRL_RECORD_PLAY_STEPBACKWARD = 0x03; AVIOCTRL_RECORD_PLAY_FORWARD = 0x04; AVIOCTRL_RECORD_PLAY_BACKWARD = 0x05; AVIOCTRL_RECORD_PLAY_SEEKTIME = 0x06; AVIOCTRL_RECORD_PLAY_END = 0x07; AVIOCTRL_RECORD_PLAY_START = 0x10; AVIOCTRL_RECORD_PLAY_NEXT = 0xf0; AVIOCTRL_RECORD_PLAY_IFRAME = 0xf1 }ENUM_PLAYCONTROL;</code></pre> <p><strong>IOTYPE_USER_IPCAM_RECORD_PLAYCONTROL_RESP = 0x031B;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将录像回放结果放到IOCtrl资料并回传给App.(APP收固定字节长度)</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int command; // 播放记录指令,参考ENUM_PLAYCONTROL unsigned int result; //取决于指令定义 // 当使用AVIOCTRL_RECORD_PLAY_START: // result&gt;=0 设备未使用实际通道进行播放 // result &lt;0 异常错误 // result= -1 回放异常 // result= -2 超出最大可连接的Client数 unsigned int size; // 事件回放文件大小 unsigned char respond; unsigned char reserved[3]; } SMsgAVIoctrlPlayRecordResp;</code></pre> <h2>2.9 设置设备解析度</h2> <p><strong>IOTYPE_USER_IPCAM_SETSTREAMCTRL_REQ = 0x0320;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要设置设备的解析度。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char quality; // 参考ENUM_QUALITY_LEVEL unsigned char reserved[3]; } SMsgAVIoctrlSetStreamCtrlReq; typedef enum { AVIOCTRL_QUALITY_UNKNOWN = 0x00, AVIOCTRL_QUALITY_MAX = 0x01; AVIOCTRL_QUALITY_HIGH = 0x02; AVIOCTRL_QUALITY_MIDDLE = 0x03; AVIOCTRL_QUALITY_LOW = 0x04; AVIOCTRL_QUALITY_MIN = 0x05; }ENUM_QUALITY_LEVEL;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SETSTREAMCTRL_RESP = 0x0321;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP解析度设置结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int result; // 0: 成功; otherwise: 失败 unsigned char reserved[4]; } SMsgAVIoctrlGetStreamCtrlResq;</code></pre> <h2>2.10 获取设备目前解析度</h2> <p><strong>IOTYPE_USER_IPCAM_GETSTREAMCTRL_REQ = 0x0322;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备目前的解析度。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; }SMsgAVIoctrlGetStreamCtrlReq; </code></pre> <p><strong>IOTYPE_USER_IPCAM_GETSTREAMCTRL_RESP = 0x0323;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备解析度配置放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char quality; //参考ENUM_QUALITY_LEVEL unsigned char reserved[3]; } SMsgAVIoctrlSetStreamCtrlReq, SMsgAVIoctrlGetStreamCtrlResp;</code></pre> <h2>2.11 设置设备位移侦测之灵敏度</h2> <p><strong>IOTYPE_USER_IPCAM_SETMOTIONDETECT_REQ = 0x0324;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要设置设备位移侦测的灵敏度。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned int sensitivity; // 0 (禁用) ~ 100(最大): // Index in App. Sensitivity value // 0 0(关闭) // 1 25(低) // 2 50(中) // 3 75(高) // 4 100(最高) }SMsgAVIoctrlSetMotionDetectReq, SMsgAVIoctrlGetMotionDetectResp;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SETMOTIONDETECT_RESP = 0x0325;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP位移侦测之灵敏度设置结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { int result; // 0: 成功; otherwise: 失败 unsigned char reserved[4]; }SMsgAVIoctrlSetMotionDetectResp;</code></pre> <h2>2.12 获取设备目前位移侦测之灵敏度</h2> <p><strong>IOTYPE_USER_IPCAM_GETMOTIONDETECT_REQ = 0x0326;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备位移侦测的灵敏度。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlGetMotionDetectReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GETMOTIONDETECT_RESP = 0x0327;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备移动侦测灵敏度配置放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned int sensitivity; // 0(禁用) ~ 100(最大): // index sensitivity value // 0 0(关闭) // 1 25(低) // 2 50(中) // 3 75(高) // 4 100(最高) }SMsgAVIoctrlSetMotionDetectReq, SMsgAVIoctrlGetMotionDetectResp;</code></pre> <h2>2.13 获取目前设备通道数</h2> <p><strong>IOTYPE_USER_IPCAM_GETSUPPORTSTREAM_REQ = 0x0328;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取目前设备频道数。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[4]; }SMsgAVIoctrlGetSupportStreamReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GETSUPPORTSTREAM_RESP = 0x0329;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备频道数配置放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned short index; // 设备使用的stream index unsigned short channel; // AVAPIs使用的channel index char reserved[4]; }SStreamDef; typedef struct { unsigned int number; // 可支持的 stream数量 SStreamDef streams[0]; }SMsgAVIoctrlGetSupportStreamResp;</code></pre> <h2>2.14 获取设备音讯格式</h2> <blockquote> <p>App传送声音用。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_GETAUDIOOUTFORMAT_REQ = 0x032A;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备音频格式。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // camera index char reserved[4]; }SMsgAVIoctrlGetAudioOutFormatReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GETAUDIOOUTFORMAT_RESP = 0x032B;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备音频格式放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // camera index int format; // 参考ENUM_CODECID in AVFRAMEINFO.h char sample_rate; char bitdata; char channels; // 可支持的通道数量 char avservchannel; // 0 子通道;1 主通道;otherwise 子通道(默认0) }SMsgAVIoctrlGetAudioOutFormatResp; Sample_Rate: AUDIO_SAMPLE_8K = 0; AUDIO_SAMPLE_11K = 1; AUDIO_SAMPLE_12K = 2; AUDIO_SAMPLE_16K = 3; AUDIO_SAMPLE_22K = 4; AUDIO_SAMPLE_24K = 5; AUDIO_SAMPLE_32K = 6; AUDIO_SAMPLE_44K = 7; AUDIO_SAMPLE_48K = 8; CodecId: MEDIA_CODEC_UNKNOWN = 0x00; MEDIA_CODEC_VIDEO_MPEG4 = 0x4C; MEDIA_CODEC_VIDEO_H263 = 0x4D; MEDIA_CODEC_VIDEO_H264 = 0x4E; MEDIA_CODEC_VIDEO_MJPEG = 0x4F; MEDIA_CODEC_VIDEO_HEVC = 0x50; MEDIA_CODEC_AUDIO_AAC_RAW = 0x86; MEDIA_CODEC_AUDIO_AAC_ADTS = 0x87; MEDIA_CODEC_AUDIO_AAC_LATM = 0x88; MEDIA_CODEC_AUDIO_G711U = 0x89; //g711 u-law MEDIA_CODEC_AUDIO_G711A = 0x8A; //g711 a-law MEDIA_CODEC_AUDIO_ADPCM = 0x8B; MEDIA_CODEC_AUDIO_PCM = 0x8C; MEDIA_CODEC_AUDIO_SPEEX = 0x8D; MEDIA_CODEC_AUDIO_MP3 = 0x8E; MEDIA_CODEC_AUDIO_G726 = 0x8F; Bitdata (0x0 ~ 0xF): AUDIO_DATABITS_8 = 0; AUDIO_DATABITS_16 = 1;</code></pre> <h2>2.15 获取设备信息</h2> <blockquote> <p>建议改为使用0x8015/0x8016</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_DEVINFO_REQ = 0x0330;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备资讯。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[4]; }SMsgAVIoctrlDeviceInfoReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_DEVINFO_RESP = 0x0331;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备资讯放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char model[16]; unsigned char vendor[16]; unsigned int version; unsigned int channel; //保留 unsigned int total; // MBytes, sdcard的全部空间 unsigned int free; // MBytes , sdcard的可用空间 unsigned int company; //参考OTA 上的公司名 unsigned char reserved[4]; }SMsgAVIoctrlDeviceInfoResp;</code></pre> <h2>2.16 变更设备密码</h2> <p><strong>IOTYPE_USER_IPCAM_SETPASSWORD_REQ = 0x0332;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要变更设备密码。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { char oldpasswd[32]; // 旧密码 char newpasswd[32]; // 新密码 }SMsgAVIoctrlSetPasswdReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SETPASSWORD_RESP = 0x0333;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP变更设备密码的结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { int result; //0x00 密码设置成功, 否则失败 unsigned char reserved[4]; }SMsgAVIoctrlSetPasswdResp;</code></pre> <h2>2.17 事件回放进度控制</h2> <p><strong>IOTYPE_USER_IPCAM_GET_PLAYBACK_REQ = 0x033A;</strong></p> <ul> <li>由App发往Device。</li> <li>App告知Device获取事件时长信息。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index STimeDay stTimeDay; // 事件的时间长度 unsigned char reserved[4]; }SMsgAVIoctrlGetPlaybackReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GET_PLAYBACK_RESP = 0x033B;</strong></p> <blockquote> <p>注:视频流的时间戳必须在回传的时间段内, 时间戳为UTC格式。</p> </blockquote> <ul> <li>由Device发往App;</li> <li>Device时长信息回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int videoTime; // 事件视频时间(以秒为单位) unsigned long size; // 事件大小(以字节为单位) unsigned char reserved[4]; }SMsgAVIoctrlGetPlaybackResp;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SET_RECORD_PROGRESS_REQ = 0x033C;</strong></p> <blockquote> <p>注: App不会停掉视频流(不会发送0x2ff)。</p> </blockquote> <ul> <li>由App 发往Device。</li> <li>App告知Device从指定时间播放。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index STimeDay stTimeDay; // 事件的时间长度 unsigned int progressTime; // 事件进度时间(以秒为单位) unsigned char reserved[4]; }SMsgAVIoctrlSetRecordProgessReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SET_RECORD_PROGRESS_RESP = 0x033D;</strong></p> <ul> <li>由Device发往App。</li> <li>Device将设备进度结果回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char result; //0 表示成功 unsigned char reserved[3]; }SMsgAVIoctrlSeRecordProgressResp;</code></pre> <h2>2.18 获取设备周围Wifi列表</h2> <p><strong>IOTYPE_USER_IPCAM_LISTWIFIAP_REQ = 0x0340;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备周围的wifi列表。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[4]; }SMsgAVIoctrlListWifiApReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_LISTWIFIAP_RESP = 0x0341;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备周围的wifi列表放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int number; // 最大: 1024/36=28 SWifiAp stWifiAp[0]; // 存储所有WiFi信息的起始地 // 使用(SWifiAp)字节的大小来获取WiFi数据。 }SMsgAVIoctrlListWifiApResp; typedef struct { char ssid[32]; // WiFi SSID char mode; // 参考 ENUM_AP_MODE char enctype; // 加密为WiFi,请参考ENUM_AP_ENCTYPE。 char signal; // 信号强度,范围为0%至100%。 char status; // 0 : 无效的ssid或已断开连接 // 1 : 连接默认网关 // 2 : 密码不匹配 // 3 : 弱信号且已连接 // 4 : 所选密码匹配且已断开连接或已连接,但不是默认网关 }SWifiAp; typedef enum { AVIOTC_WIFIAPMODE_NULL = 0x00; AVIOTC_WIFIAPMODE_MANAGED = 0x01; AVIOTC_WIFIAPMODE_ADHOC = 0x02; }ENUM_AP_MODE; typedef enum { AVIOTC_WIFIAPENC_INVALID = 0x00; AVIOTC_WIFIAPENC_NONE = 0x01; AVIOTC_WIFIAPENC_WEP = 0x02; // WEP,无密码 AVIOTC_WIFIAPENC_WPA_TKIP = 0x03; AVIOTC_WIFIAPENC_WPA_AES = 0x04; AVIOTC_WIFIAPENC_WPA2_TKIP = 0x05; AVIOTC_WIFIAPENC_WPA2_AES = 0x06; AVIOTC_WIFIAPENC_WPA_PSK_TKIP = 0x07; AVIOTC_WIFIAPENC_WPA_PSK_AES = 0x08; AVIOTC_WIFIAPENC_WPA2_PSK_TKIP = 0x09; AVIOTC_WIFIAPENC_WPA2_PSK_AES = 0x0A; }ENUM_AP_ENCTYPE;</code></pre> <h2>2.19 设定设备的Wifi网络</h2> <p><strong>IOTYPE_USER_IPCAM_SETWIFI_REQ = 0x0342;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要设置设备的wifi。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char ssid[32]; // 连接的WiFi SSID unsigned char password[32]; // WiFi SSID 密码 unsigned char mode; // 参考ENUM_AP_MODE unsigned char enctype; // 参考ENUM_AP_ENCTYPE unsigned char reserved[10]; }SMsgAVIoctrlSetWifiReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SETWIFI_RESP = 0x0343;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP设置设备wifi的结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { int result; //如果已连接WiFi,则返回0,否则返回1。 unsigned char reserved[4]; }SMsgAVIoctrlSetWifiResp;</code></pre> <h2>2.20 获取设备目前所设置的WiFi</h2> <p><strong>IOTYPE_USER_IPCAM_GETWIFI_REQ = 0x0344;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要获取设备目前所设置的wifi。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[4]; }SMsgAVIoctrlGetWifiReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GETWIFI_RESP = 0x0345;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备当前wifi配置放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char ssid[32]; // WiFi ssid unsigned char password[32]; // WiFi密码(如果不为空) unsigned char mode; // 参考 ENUM_AP_MODE unsigned char enctype; // 参考ENUM_AP_ENCTYPE unsigned char signal; // 信号强度 0--100% unsigned char status; // 参考SWifiAp的 "status" }SMsgAVIoctrlGetWifiResp;</code></pre> <h2>2.21 设定设备目前所设置的WiFi</h2> <blockquote> <p>该command支持64bit密码,同IOTYPE_USER_IPCAM_SETWIFI_REQ = 0x0342一起发送。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_SETWIFI_REQ2 = 0x0346;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要设定设备目前所设置的wifi。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char ssid[32]; // 连接的WiFi SSID unsigned char password[64]; // WiFi SSID密码 unsigned char mode; // 参考ENUM_AP_MODE unsigned char enctype; // 参考ENUM_AP_ENCTYPE unsigned char reserved[10]; }SMsgAVIoctrlSetWifiReq2;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GETWIFI_RESP2 = 0x0347;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device将设备当前wifi配置放到IOCtrl资料并回传给App。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char ssid[32]; // WiFi ssid unsigned char password[64]; // WiFi密码(如果不为空) unsigned char mode; // 参考 ENUM_AP_MODE unsigned char enctype; // 参考ENUM_AP_ENCTYPE unsigned char signal; // 信号强度 0--100% unsigned char status; // 参考SWifiAp的 "status" }SMsgAVIoctrlGetWifiResp2;</code></pre> <h2>2.22 呼叫设备开始接收Audio Frame</h2> <p><strong>IOTYPE_USER_IPCAM_SPEAKERSTART = 0x0350;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device开始接收音频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.23 呼叫设备停止接收Audio Frame</h2> <p><strong>IOTYPE_USER_IPCAM_SPEAKERSTOP = 0x0351;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device停止接收音频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.24 设置画面镜像/翻转状态</h2> <p><strong>IOTYPE_USER_IPCAM_SET_VIDEOMODE_REQ = 0x0370;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device进行镜像/翻转设置。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char mode; // 参考 ENUM_VIDEO_MODE unsigned char reserved[3]; }SMsgAVIoctrlSetVideoModeReq; typedef enum { AVIOCTRL_VIDEOMODE_NORMAL = 0x00; AVIOCTRL_VIDEOMODE_FLIP = 0x01; // 垂直翻转 AVIOCTRL_VIDEOMODE_MIRROR = 0x02; // 水平翻转 AVIOCTRL_VIDEOMODE_FLIP_MIRROR = 0x03; // 垂直和水平翻转 }ENUM_VIDEO_MODE;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SET_VIDEOMODE_RESP = 0x0371;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP设置结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char result; // 0: 成功; otherwise:失败 unsigned char reserved[3]; }SMsgAVIoctrlSetVideoModeResp;</code></pre> <h2>2.25 获取画面镜像/翻转设置状态</h2> <p><strong>IOTYPE_USER_IPCAM_GET_VIDEOMODE_REQ = 0x0372;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device获取镜像/翻转设置状态。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; }SMsgAVIoctrlGetVideoModeReq; </code></pre> <p><strong>IOTYPE_USER_IPCAM_GET_VIDEOMODE_RESP = 0x0373;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP目前画面镜像/翻转的设置状态。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // Camera Index unsigned char mode; // 参考 ENUM_VIDEO_MODE unsigned char reserved[3]; }SMsgAVIoctrlGetVideoModeResp; typedef enum { AVIOCTRL_VIDEOMODE_NORMAL = 0x00, AVIOCTRL_VIDEOMODE_FLIP = 0x01, // 垂直翻转 AVIOCTRL_VIDEOMODE_MIRROR = 0x02, // 水平翻转 AVIOCTRL_VIDEOMODE_FLIP_MIRROR = 0x03, // 垂直和水平翻转 }ENUM_VIDEO_MODE;</code></pre> <h2>2.26 格式化SD卡</h2> <p><strong>IOTYPE_USER_IPCAM_FORMATEXTSTORAGE_REQ = 0x0380;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device执行格式化SD卡操作。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int storage; // Storage index(例如sdcard插槽= 0,内部闪存= 1,...) unsigned char reserved[4]; }SMsgAVIoctrlFormatExtStorageReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_FORMATEXTSTORAGE_RESP = 0x0381;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP已格式化SD卡结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int storage; // Storage index char result; // 0: 成功; // -1:不支持格式化指令 // otherwise: 失败 unsigned char reserved[3]; }SMsgAVIoctrlFormatExtStorageResp;</code></pre> <h2>2.27 呼叫Client端开始传送Video Frame</h2> <blockquote> <p>主要应用于双向视频通话场景。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_START_CLIENT = 0x03FF;</strong></p> <ul> <li>由APP发往Client;</li> <li>APP告知Client开始发送视频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.28 呼叫Client端停止传送Video Frame</h2> <blockquote> <p>主要应用于双向视频通话场景。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_STOP_CLIENT = 0x04FF;</strong></p> <ul> <li>由APP发往Client;</li> <li>APP告知Client停止发送视频数据。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int channel; // Camera Index unsigned char reserved[4]; } SMsgAVIoctrlAVStream;</code></pre> <h2>2.29 获取NVR设备Channel接口数量</h2> <p><strong>IOTYPE_USER_IPCAM_GET_NVR_CHANNEL_NUMBER_REQ = 0x5A4;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device获取设备Channel的接口数量。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[4]; }SMsgAVIoctrlGetNVRChannelNumberReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GET_NVR_CHANNEL_NUMBER_RESP = 0x5A5;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP目前设备Channel的接口数量。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int number; // 设备的通道数量 unsigned char reserved[4]; }SMsgAVIoctrlGetNVRChannelNumberResp;</code></pre> <h2>2.30 获取通道名称</h2> <p><strong>IOTYPE_USER_IPCAM_GET_CHANNEL_NAME_REQ = 0x5B0;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device获取设备的通道名称。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[4]; }SMsgAVIoctrlGetChannelNameReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GET_CHANNEL_NAME_RESP = 0x5B1;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP设备的通道名称。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char count; // 通道数量 unsigned char reserved[3]; SChannelInfo sChannelInfo[0]; // 第一个channelInfo和channelInfo的总数 }SMsgAVIoctrlGetChannelNameResp; typedef struct { unsigned int channel; //camera index unsigned char name[24]; //通道名称 } SChannelInfo;</code></pre> <h2>2.31 设置通道名称</h2> <p><strong>IOTYPE_USER_IPCAM_SET_CHANNEL_NAME_REQ = 0x5B2;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要设置设备的通道名称。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char count; // SChannelInfos的数量 unsigned char reserved[3]; SChannelInfo sChannelInfo[0]; // 第一个channelInfo和channelInfo的总数 }SMsgAVIoctrlSetChannelNameReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SET_CHANNEL_NAME_RESP = 0x5B3;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP设置设备通道名称的结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char result; // 0 成功, 其他失败 unsigned char reserved[3]; }SMsgAVIoctrlSetResetResp;</code></pre> <h2>2.32 门铃呼叫</h2> <blockquote> <p>主要应用于可视门铃通话场景。</p> </blockquote> <p><strong>IOTYPE_XM_CALL_REQ = 0x700;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP有用户呼叫。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char index; //门索引号,0:门1; 1:门2 STimeDay stTime; //事件时间 unsigned char reserved[3]; } SMsgAVIoctrlCallReq</code></pre> <p><strong>IOTYPE_XM_CALL_RESP = 0x701;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device是否进行接听。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char index; //门索引号,0:门1;1: 门2 int nAnswered; //0:挂断;1:接听 unsigned char reserved[3]; }SMsgAVIoctrlCallResp;</code></pre> <p><strong>IOTYPE_XM_CALL_IND = 0x702;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP是否有其他用户接听。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char index; //门索引号,0:门1;1:门2 unsigned char type; //类型,0:有用户呼叫;1:有其他用户应答 STimeDay stTime; //事件时间 unsigned char reserved[3]; }SMsgAVIoctrlCallInd;</code></pre> <h2>2.33 发送设备名称给设备</h2> <p><strong>IOTYPE_USER_IPCAM_PUSH_DEVICENAME_REQ= 0x0736;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device要当前设备名称。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel ; //camera index char devicename[150]; //当前设备名称 }SMsgAVIoctrlPushDeviceNameReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_PUSH_DEVICENAME_RESP= 0x0737;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP要当前设备名称更新结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { int res ; //0:成功,其他失败 char reserved[4]; }SMsgAVIoctrlPushDeviceNameResp;</code></pre> <h2>2.34 同步手机时间给设备</h2> <p><strong>IOTYPE_USER_IPCAM_SET_TIME_SYNC_REQ = 0x0816;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device进行同步手机时间。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned short year; unsigned char month; unsigned char day; unsigned char hour; unsigned char minute; unsigned char second; unsigned char nIsSupportSync; // 1 支持; 0 不支持 int nGMTOffset; // GMT之间的偏移量(以秒为单位) } SMsgAVIoctrlTimeSyncReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_SET_TIME_SYNC_RESP = 0x0817;</strong></p> <ul> <li>由Device发往APP;</li> <li>Device告知APP同步时间的结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int result; //如果成功则返回0,否则失败 unsigned char reserved[4]; } SMsgAVIoctrlTimeSyncResp;</code></pre> <h2>2.35 结束通话</h2> <blockquote> <p>主要应用于双向视频通话场景。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_CALL_END = 0x0900;</strong></p> <ul> <li>由APP发往另一端;</li> <li>APP告知对方结束此通话。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned char myID[6]; // 我的 ID unsigned char reserved[2]; }SMsgAVIoctrlCallEnd;</code></pre> <h2>2.36 呼叫方发出通话请求</h2> <blockquote> <p>主要应用于双向视频通话场景。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_CALL_REQ = 0x0901;</strong></p> <ul> <li>由呼叫方发往被呼叫方;</li> <li>呼叫方向被呼叫方发起通话请求。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned char myID[6]; // 我的 ID unsigned char myUID[20]; // 我的 UID unsigned char callType; // 0,单向视频; 1, 双向视频 unsigned char beInvited; // 0 表示邀请;1 表示被邀请 unsigned char infoCount; // 其他参与者的数量 unsigned char reserved[3]; unsigned AccountInfo info // 其他参与者的信息 }SMsgAVIoctrlCallReq; typedef struct{ unsigned char UID[20]; // UID unsigned char myID[6]; // ID unsigned char reserved[2]; }AccountInfo</code></pre> <h2>2.37 被呼叫方响应呼叫请求</h2> <blockquote> <p>主要应用于双向视频通话场景。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_CALL_RESP = 0x0902;</strong></p> <ul> <li>由被呼叫方发往呼叫方;</li> <li>被呼叫方响应呼叫方发起的通话请求。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned char answer; // 0, 拒绝; 1 接听 unsigned char myID[6]; //myID unsigned char reserved[1]; }SMsgAVIoctrlCallResp;</code></pre> <h2>2.38 云台控制</h2> <p><strong>IOTYPE_USER_IPCAM_PTZ_COMMAND = 0x1001;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device进行云台控制。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char control; // 云台控制指令,参考 ENUM_PTZCMD. unsigned char speed; // 云台转动的速度 unsigned char point; // app未使用 unsigned char limit; // app未使用 unsigned char aux; // app未使用 unsigned char channel; // camera index unsigned char reserve[2]; } SMsgAVIoctrlPtzCmd; /* AVIOCTRL PTZ Command 值 */ typedef enum { AVIOCTRL_PTZ_STOP = 0; AVIOCTRL_PTZ_UP = 1; AVIOCTRL_PTZ_DOWN = 2; AVIOCTRL_PTZ_LEFT = 3; AVIOCTRL_PTZ_LEFT_UP = 4; AVIOCTRL_PTZ_LEFT_DOWN = 5; AVIOCTRL_PTZ_RIGHT = 6; AVIOCTRL_PTZ_RIGHT_UP = 7; AVIOCTRL_PTZ_RIGHT_DOWN = 8; AVIOCTRL_PTZ_AUTO = 9; AVIOCTRL_PTZ_SET_POINT = 10; AVIOCTRL_PTZ_CLEAR_POINT = 11; AVIOCTRL_PTZ_GOTO_POINT = 12; AVIOCTRL_PTZ_SET_MODE_START = 13; AVIOCTRL_PTZ_SET_MODE_STOP = 14; AVIOCTRL_PTZ_MODE_RUN = 15; AVIOCTRL_PTZ_MENU_OPEN = 16; AVIOCTRL_PTZ_MENU_EXIT = 17; AVIOCTRL_PTZ_MENU_ENTER = 18; AVIOCTRL_PTZ_FLIP = 19; AVIOCTRL_PTZ_START = 20; AVIOCTRL_LENS_APERTURE_OPEN = 21; AVIOCTRL_LENS_APERTURE_CLOSE = 22; AVIOCTRL_LENS_ZOOM_IN = 23; AVIOCTRL_LENS_ZOOM_OUT = 24; AVIOCTRL_LENS_FOCAL_NEAR = 25; AVIOCTRL_LENS_FOCAL_FAR = 26; AVIOCTRL_AUTO_PAN_SPEED = 27; AVIOCTRL_AUTO_PAN_LIMIT = 28; AVIOCTRL_AUTO_PAN_START = 29; AVIOCTRL_PATTERN_START = 30; AVIOCTRL_PATTERN_STOP = 31; AVIOCTRL_PATTERN_RUN = 32; AVIOCTRL_SET_AUX = 33; AVIOCTRL_CLEAR_AUX = 34; AVIOCTRL_MOTOR_RESET_POSITION = 35; }ENUM_PTZCMD;</code></pre> <h2>2.39 APP获取第一张I帧图片</h2> <p><strong>IOTYPE_USER_IPCAM_RECEIVE_FIRST_IFRAME = 0x1002;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device接收到第一张I帧图片。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int channel; // camera index char reserved[4]; }SMsgAVIoctrlReceiveFirstIFrame;</code></pre> <h2>2.40 设备进行OTA升级</h2> <p><strong>IOTYPE_USER_IPCAM_OTA_REQ = 0x8001;</strong></p> <ul> <li>由APP发往Device;</li> <li>APP告知Device开始进行OTA升级。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char file_checksum[32]; // MD5校验码 unsigned char url[256]; // 下载固件url链接 unsigned int file_size; // 固件包大小 unsigned char reserved[4]; }SMsgAVIoctrlOTAReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_OTA_RESP = 0x8002;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App升级OTA结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int progress; // 下载固件进度 unsigned int endflag; //1:下载完成;0:下载中 unsigned char reserved[8]; }SMsgAVIoctrlOTAResp;</code></pre> <h2>2.41 获取设备信息</h2> <blockquote> <p>注:新设备需对接OTA功能时建议使用,与旧cmd IOTYPE_USER_IPCAM_DEVINFO_REQ = 0x0330同作用。</p> </blockquote> <p><strong>IOTYPE_USER_IPCAM_DEVICE_INFO_REQ = 0x8015;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device要获取设备资讯。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[8]; } SMsgAVIoctrlDeviceInfoReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_DEVICE_INFO_RESP = 0x8016;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App设备资讯。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char model[32]; // 产品型号 unsigned char product[32]; // 产品名 unsigned char vender[32]; // 制造商(需与KOTA服务器上的厂商一致) unsigned int version; // 当前版本号 unsigned int free; // SD卡剩余空间 unsigned int total; // SD卡总空间 unsigned char region; //获取设备所在位置,0:中国大陆区;1:非中国大陆区 unsigned char reserved[3]; } SMsgAVIoctrlDeviceInfoResp;</code></pre> <blockquote> <p>注:以上参数用于拼接向KOTA服务器获取升级文件的下载地址请求,故需与在KOTA服务器上创建的vender,product,model等信息保持一致,且注意区分设备所在区域。</p> </blockquote> <h2>2.42 获取设备是否支持OTA升级</h2> <p><strong>IOTYPE_USER_IPCAM _DEVICE_SUPPORT_OTA_REQ = 0x800A;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device要获取设备是否支持OTA。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[8]; }SMsgAVIoctrlDeviceSupportOTAReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM _DEVICE_SUPPORT_OTA _RESP = 0x800B;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App设备是否支持OTA。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char isSupport; // 0 不支持;1 支持 unsigned char reserved[4]; } SMsgAVIoctrlDeviceSupportOTAResp;</code></pre> <h2>2.43 获取设备是否支持云存储</h2> <p><strong>IOTYPE_USER_IPCAM _DEVICE_SUPPORT_CLOUD_REQ = 0x800C;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device查询是否支持云存储。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned char reserved[8]; }SMsgAVIoctrlDeviceSupportCloudReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM _DEVICE_SUPPORT_CLOUD _RESP = 0x800D;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App设备是否支持云存储结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c"> typedef struct { unsigned int result; // 0 不支持;1 支持 unsigned char reserved[4]; } SMsgAVIoctrlDeviceSupportCloudResp;</code></pre> <h2>2.44 设置设备云存储录像状态</h2> <p><strong>IOTYPE_USER_IPCAM_DEVICE_SET_CLOUD_REQ = 0x8010;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device开启或关闭云存储录像功能。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int channel; // camera index unsigned int isOn; // 1 开启, 0 关闭 }SMsgAVIoctrlSetCloudReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_DEVICE_SET_CLOUD_RESP = 0x8011;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App开启或关闭云存储录像结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int channel; // camera index unsigned int result; // 0 成功, 1 失败 }SMsgAVIoctrlSetCloudResp;</code></pre> <h2>2.45 获取设备云存储录像状态</h2> <p><strong>IOTYPE_USER_IPCAM_DEVICE_GET_CLOUD_REQ = 0x8012;</strong></p> <ul> <li>由App发往Device</li> <li>App获取Device云存储录像状态。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int channel; // camera index unsigned char reserved[4]; }SMsgAVIoctrlGetCloudReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_DEVICE_GET_CLOUD_RESP = 0x8013;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App云存储录像状态。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int channel; // camera index unsigned int isOn; // 1 开启, 0 关闭 }SMsgAVIoctrlGetCloudResp;</code></pre> <h2>2.46 获取有SD卡事件的日期</h2> <p><strong>IOTYPE_USER_IPCAM_GET_EVENT_DATE_REQ = 0x9000;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device获取有SD卡事件的日期。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int channel; //Camera Index unsigned int eventType; //查询的事件类型,0:全部,1:移动侦测;2:全时录像,默认是0 STimeDay stStartTime; //开始时间 STimeDay stEndTime; //结束时间 unsigned char reserved[8]; } SMsgAVIoctrlGetEventDateReq;</code></pre> <p><strong>IOTYPE_USER_IPCAM_GET_EVENT_DATE_RESP = 0x9001;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App有SD卡事件的日期结果。</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int count; //事件的日期数量 unsigned char reserved[4]; EventDate eventDate[1]; //事件的日期 } SMsgAVIoctrlGetEventDateResp; typedef struct { char date[8]; //事件的日期,例如:20200210,后面依次还有count-1个date[8] } EventDate;</code></pre> <h2>2.47 获取设备人形侦测开关</h2> <p><strong>IOTYPE_USER_IPCAM_GET_HUMANDETECTION_REQ = 0x9002;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device查询人形侦测开关</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned char reserved[4]; } SMsgAVIoctrlGetHumanDetectionReq;</code></pre> <p>  <strong>IOTYPE_USER_IPCAM_GET_HUMANDETECTION_RESP = 0x9003;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App人形侦测开关查询结果</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int result; // 1:开启; 其他:关闭 unsigned char reserved[4]; } SMsgAVIoctrlGetHumanDetectionResp;</code></pre> <p> </p> <h2>2.48 设置设备人形侦测开关</h2> <p><strong>IOTYPE_USER_IPCAM_SET_HUMANDETECTION_REQ = 0x9004;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device设置人形侦测开关</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int isOn; // 1:开启;0 :关闭 unsigned char reserved[4]; } SMsgAVIoctrlSetHumanDetectionReq;</code></pre> <p>  <strong>IOTYPE_USER_IPCAM_SET_HUMANDETECTION_RESP = 0x9005;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App人形侦测开关设置结果</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int result; // 0:成功;其他:失败 unsigned char reserved[4]; } SMsgAVIoctrlSetHumanDetectionResp;</code></pre> <p> </p> <h2>2.49 获取设备夜视开关</h2> <p><strong>IOTYPE_USER_IPCAM_GET_NIGHTVISION_REQ = 0x9006;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device查询夜视开关</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned char reserved[4]; } SMsgAVIoctrlGetNightVisionReq;</code></pre> <p>  <strong>IOTYPE_USER_IPCAM_GET_NIGHTVISION_RESP = 0x9007;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App夜视开关查询结果</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int result; // 1:开启;其他:关闭 unsigned char reserved[4]; } SMsgAVIoctrlGetNightVisionResp;</code></pre> <p> </p> <h2>2.50 设置设备夜视开关</h2> <p><strong>IOTYPE_USER_IPCAM_SET_NIGHTVISION_REQ = 0x9008;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device设置夜视开关</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int isOn; // 1:开启;0:关闭 unsigned char reserved[4]; } SMsgAVIoctrlSetNightVisionReq;</code></pre> <p>  <strong>IOTYPE_USER_IPCAM_SET_NIGHTVISION_RESP = 0x9009;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App夜视开关设置结果</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int result; // 0:成功;其他:失败 unsigned char reserved[4]; } SMsgAVIoctrlSetNightVisionResp;</code></pre> <p> </p> <h2>2.51 获取设备夏令时开关</h2> <p><strong>IOTYPE_USER_IPCAM_GET_SUMMERTIME_REQ = 0x9010;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device查询夏令时开关</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned char reserved[4]; } SMsgAVIoctrlGetSummerTimeReq;</code></pre> <p>  <strong>IOTYPE_USER_IPCAM_GET_SUMMERTIME_RESP = 0x9011;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App夏令时开关查询结果</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int result; // 1:开启;其他:关闭 unsigned char reserved[4]; } SMsgAVIoctrlGetSummerTimeResp;</code></pre> <p> </p> <h2>2.52 设置设备夏令时开关</h2> <p><strong>IOTYPE_USER_IPCAM_SET_SUMMERTIME_REQ = 0x9012;</strong></p> <ul> <li>由App发往Device</li> <li>App告知Device设置夏令时开关</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int isOn; // 1:开启; 0:关闭 unsigned char reserved[4]; } SMsgAVIoctrlSetSummerTimeReq;</code></pre> <p>  <strong>IOTYPE_USER_IPCAM_SET_SUMMERTIME_RESP = 0x9013;</strong></p> <ul> <li>由Device发往App</li> <li>Device告知App夏令时开关设置结果</li> <li>IOCtrl数据:</li> </ul> <pre><code class="language-c">typedef struct { unsigned int result; // 0:成功;其他:失败 unsigned char reserved[4]; } SMsgAVIoctrlSetSummerTimeResp;</code></pre> <h1>三、示例说明</h1> <h2>3.1 APP实作通过Command获取灯光状态实例</h2> <ul> <li>定义Command及结构体</li> <li>获取开关状态Command定义:IOTYPE_GET_LED_REQ = 0x30000001</li> <li>获取开关状态结构体定义: @struct SMsgAVIoctrlGetLedReq;</li> </ul> <pre><code class="language-c"> typedef struct { int channel; //当前通道号 unsigned char reserved[4]; }SMsgAVIoctrlGetLedReq;</code></pre> <ul> <li>设备端回复APP开关状态Command定义:IOTYPE_GET_LED_RESP = 0x30000002</li> <li>设备端回复APP开关状态结构体定义:@struct SMsgAVIoctrlGetLedResp;</li> </ul> <pre><code class="language-c"> typedef struct { int res; //0:成功, 其他失败 unsigned char isOnOff; // 0:开启; 1:关闭 unsigned char reserved[3]; }SMsgAVIoctrlGetLedResp;</code></pre> <h2>3.2 IOS端发送及接收Command的方法</h2> <ul> <li>发送Command的方法</li> </ul> <pre><code class="language-c"> SMsgAVIoctrlGetLedReq *s = malloc(sizeof(SMsgAVIoctrlGetLedReq)); memset(s, 0, sizeof(SMsgAVIoctrlGetLedReq)); [self.camera KY_SendIOCtrlToChannel:channel Type:IOTYPE_GET_LED_REQ Data:(char *)s DataSize:sizeof(SMsgAVIoctrlGetLedReq)]; free(s);</code></pre> <ul> <li>接收Command的回调方法</li> </ul> <pre><code class="language-c">- (void)KY_DidReceiveIOCtrlWithUid:(NSString *)uid Type:(NSInteger)type Data:(const char*)data DataSize:(NSInteger)size { if (type == IOTYPE_GET_LED_RESP) { SMsgAVIoctrlGetLedResp *s = (SMsgAVIoctrlGetLedResp *)data; isLightOn = s-&gt;isOnOff; } }</code></pre> <h2>3.3 Android 如何将bytes转成一个java对象</h2> <pre><code class="language-c">private class People { int age = 0;//4 bytes means data[0] ~ data[3] long birthday = 1612330883993L;//8 bytes means data[4] ~ data[11] String name = "";//custom bytes ex: 32 bytes } /** * byte to people * * @param data src bytes length &gt; 44 * @return people */ private People byteToPeople(byte[] data) { if (data.length &lt; 44) { return null; } People p = new People(); p.age = byteArrayToInt(data, 0); p.birthday = byteArrayToLong(data, 4); byte[] name = new byte[32]; System.arraycopy(data, 12, name, 0, 32); p.name = new String(name); return p; } private short byteArrayToShort(byte[] bytes, int beginPos) { return (short) ((0xff &amp; bytes[beginPos]) | ((0xff &amp; bytes[beginPos + 1]) &lt;&lt; 8)); } private int byteArrayToInt(byte[] bytes, int beginPos) { return (0xff &amp; bytes[beginPos]) | (0xff &amp; bytes[beginPos + 1]) &lt;&lt; 8 | (0xff &amp; bytes[beginPos + 2]) &lt;&lt; 16 | (0xff &amp; bytes[beginPos + 3]) &lt;&lt; 24; } private long byteArrayToLong(byte[] bytes, int beginPos) { long l = 0; for (int i = 0; i &lt; 4; i++) { l = l | ((0xffL &amp; bytes[beginPos + i]) &lt;&lt; (8 * i)); } return l; }</code></pre>

页面列表

ITEM_HTML