设备网络SDK使用手册

声明

由于产品版本升级或其他原因，本手册内容会不定期进行更新。

本手册仅作为使用指导，本手册中的所有陈述、信息和建议不构成任何明示或暗示的担保。如有任何疑问或争议，请以我司最终解释为准。

本公司对使用本手册或使用本公司产品导致的任何特殊、附带、偶然或间接的损害不承担责任，包括但不限于商业利润损失、数据或文档丢失产生的损失，因遭受网络攻击、黑客攻击、病毒感染等造成的产品工作异常、信息泄露。

修改记录

1. 内容简介

1.1 前言

非常感谢您使用我们公司的产品，我们将竭诚为您提供最好的服务。

本手册可能包含技术上不准确的地方或文字错误。

本手册的内容将做定期的更新，恕不另行通知；更新的内容将会在本手册的新版本中加入。

我们随时会改进或更新本手册中描述的产品或程序。

1.2 概述

JCSDK（网络SDK）是一套基于私有网络通信协议开发的，为IPC、NVR等产品服务的配套模块，包含了监控业务管理和控制、设备管理、资源管理以及系统维护接口。用户可以使用这些接口实现各种远程访问和控制设备等功能软件的二次开发。

主要提供设备管理、实况、回放、告警、云台、参数配置等视频业务功能。

本手册将会详细的介绍网络设备SDK中接口功能、使用说明及各接口间的调用关系；支持C/C++、C#、Objective-C等语言对接。

当您拿到此开发手册时，您应该已经拿到了完整的SDK开发包，包含头文件，静态库、动态库、demo，开发文档。

1.3 使用场景

本SDK仅支持两种使用场景：

1. 局域网：支持局域网搜索设备，根据搜到的设备IP地址连接设备。
2. 互联网：通过主动注册方式连接设备，即SDK启动注册服务，设备端配置服务ip和端口进行注册，SDK给出回调通知用户注册的设备ID，通过ID进行设备连接。

1.4 阅读对象

本文档的阅读对象为具有一定开发能力，了解C/C++ 、C#等语言的开发、维护或者管理人员，对SDK对接有一定的经验与了解。

1.5 名词解释

1.6 系统要求

1.7 使用产品

• 编解码设备

  NVR： 所有支持慧视云2.0协议的型号，均可以支持3.8参数配置之外的所有接口。

  参数配置接口支持情况：

• 网络摄像机

  IPC： 所有支持慧视云2.0协议的型号，均支持所有接口，具体功能可以根据能力集接口获取是否支持。

2. 编程引导

2.1 编程引导

JCSDK用于接入IPC、NVR提供的各种业务功能接口，用户遵循SDK编程基本框架，同时参考编程指导各章节提供的接口使用说明，可以开发出基于SDK的各种媒体业务(实况、回放及下载、云台控制、参数配置等)。

• SDK功能接口文件

jcerror.h：错误码定义

jcdefine.h：宏定义、结构体定义和枚举定义

jcsdk.h：提供了基本功能接口函数定义。

jconfig.h：提供了设备远程配置接口函数定义

JVSDKP.h：windows解码库接口，仅限windows系统使用

• 编程说明

1、字符串格式

非英文字符需UTF-8编码。

2、时间描述

Unix 纪元（January 1 1970 00:00:00 GMT）起的当前时间的秒数。

3、错误获取

在调用本开发包提供的函数时，如果函数内部产生异常(比如建立实况不成功)，异常情况会返回FALSE。获取错误码调用JCSDK_GetLastError()，详细错误码请参见错误码列表。

2.2 SDK调用主要流程

2.2.1 流程图

2.2.2 示例代码

#include <jcsdk.h>
#include <jconfig.h>

static void _SearchDeviceCallback(bool bFinished, const JCDeviceInfo_t *pInfo, void *param)
{
    if(bFinished)
        printf("Search finished\n");
    if(pInfo)
    {
        printf("%d:%s,%s,%s: %d\n",pInfo->eSearchProtocol, pInfo->szDeviceID,pInfo->szDeviceName,pInfo->szIPV4IP,pInfo->bActivated);
    }
}
static void _RegisterServiceCallback(int nConnID, const char *szDeviceID, void *pUserData)
{
    printf("%d:%s\n",nConnID, szDeviceID);
}
int main(int argc, const char *argv[]){
    JBOOL ret = JFALSE;
    //初始化SDK
    ret = JCSDK_InitSDK("./");
    if(!ret)
    {
        //获取错误码示例，错误码详见 jerror.h
        printf("JCSDK_InitSDK error: %d\n", JCSDK_GetLastError());
        return 0;
    }

    //广播搜索接口测试
    printf("JCSDK_SearchDevice\n");
    JCSDK_SearchDevice(JCDEVICE_TYPE_All, 1000, _SearchDeviceCallback, NULL);
    sleep(4);

    //设备激活接口测试，注意需要判断设备是否未激活，搜索结果中可以判断
    JCPasswdQuestionList_t questions = {3,{ {"a?","1"},{"b?","2"},{"c?","3"} }};
    printf("JCSDK_ActiveDevice\n");
    ret = JCSDK_ActiveDevice("12221S3C4C77", "admin", "admin123", &questions, 1000);
    if(!ret){
        printf("error: %d\n",JCSDK_GetLastError());
    }
    sleep(2);

    //广播配置网络接口测试，此协议是新协议仅新版本设备软件支持
    JCDeviceNetworkCfg_t stNetCfg = {};
    strcpy(stNetCfg.szIPV4IP, "172.16.33.20");
    strcpy(stNetCfg.szIPV4Netmask, "255.255.255.0");
    strcpy(stNetCfg.szIPV4Gateway, "172.16.33.1");
    JCSDK_SetNetCfg("12221S3C4C77", "admin", "admin123", &stNetCfg, 2000);

    //广播配置获取错误码，此协议是新协议仅新版本设备软件支持
    int nErrorCode;
    JCPasswdQuestionList_t questionstmp = {0};
    JCSDK_LostPasswd("12221S3C4C77", "admin", &nErrorCode, &questionstmp, 2000);
    printf("nErrorCode %d, questions.count:%d,%s,%s,%s\n",nErrorCode,questionstmp.count,
        questionstmp.question[0].szQuestion,questionstmp.question[1].szQuestion,questionstmp.question[2].szQuestion);

    //广播通过密保找回密码测试
    JCSDK_CheckQuestions("12221S3C4C77", "admin", &questions, "admin12345", 1000);

    //跨网端搜索接口测试
    JCIPSection_t ipsec[2];
    snprintf(ipsec[0].startip, sizeof(ipsec[0].startip), "%s", "172.16.33.1");
    snprintf(ipsec[0].endip, sizeof(ipsec[0].endip), "%s", "172.16.33.254");
    snprintf(ipsec[1].startip, sizeof(ipsec[1].startip), "%s", "172.16.18.1");
    snprintf(ipsec[1].endip, sizeof(ipsec[1].endip), "%s", "172.16.18.254");
    printf("JCSDK_SearchDeviceByIPSection\n");
    JCSDK_SearchDeviceByIPSection(JCDEVICE_TYPE_IPC, 1000, ipsec, 2, _SearchDeviceCallback, NULL);

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //断开连接
    JCSDK_Disconnect(nLinkID);

    //开启主动注册服务代码示例
    JCSDK_StartRegisterService("172.16.33.112", 35641, _RegisterServiceCallback, NULL);
    //连接主动注册的设备，nConnID 0,设备ID 12221S3C4C76 均来自 _RegisterServiceCallback
    nLinkID = JCSDK_ConnectByRegister(0, "12221S3C4C76", "admin", "admin12345");
    //断开连接
    JCSDK_Disconnect(nLinkID);

    while(1) sleep(1);
    return 0;
}

2.3 事件模块流程

2.3.1 流程图

2.3.2 示例代码

static void _EventCallback(JCLink_t nLinkID, JCEventType_e eType, LPVOID pData, LPVOID pUserData)
{
    switch(eType)
    {
    case JCEVENT_TYPE_ABNORMAL_DISCONNECT:
        break;
    case JCEVENT_TYPE_PEER_DISCONNECT:
        break;
    case JCEVENT_TYPE_CHANGE_PASSWD_DISCONNECT:
        break;
    case JCEVENT_TYPE_ALARM:
    {
        JCAlarmMsg_t *pInfo = (JCAlarmMsg_t *)pData;
        printf("Alarm Type: %s\n", pInfo->szType);
        break;
    }
    case JCEVENT_TYPE_CHANNEL_STATUS_CHANGE:
    {
        JCChannelStatus_t *pInfo = (JCChannelStatus_t *)pData;
        printf("Channels Count: %d\n", pInfo->nChannelCnt);
        break;
    }
    default:
        break;
    }
}
int main(int argc, const char *argv[])
{
    //初始化SDK
    JCSDK_InitSDK("./");

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    JCSDK_RegisterCallback(nLinkID, _EventCallback, NULL);
    sleep(600);

    //断开连接
    JCSDK_Disconnect(nLinkID);
    //去初始化SDC释放资源
    JCSDK_ReleaseSDK();

    while(1) sleep(1);
    return 0;
}

2.4 实况模块流程

2.4.1 流程图

2.4.2 代码示例

static void _DataCallback(JC_HANDLE pPlayHandle, JCStreamEventType_e eType, PUCHAR pData, LPVOID pUserData)
{
    switch (eType)
    {
    case JCSTREAM_EVENT_TYPE_START:
    case JCSTREAM_EVENT_TYPE_RESET:
    {
        JCStreamInfo_t *info = (JCStreamInfo_t *)pData;
        if (info)
        {
            printf("%s\n", eType == JCSTREAM_EVENT_TYPE_START ? "Stream start !" : "Stream reset !");
            printf("eVideoCodec         : %d\n", info->eVideoCodec);
        }
        break;
    }
    case JCSTREAM_EVENT_TYPE_DATA:
    {
        JCStreamFrame_t *frame = (JCStreamFrame_t *)pData;
        if(frame)
        {
            printf("recv data %d %d\n", frame->eType, frame->nFrameSize);
            //如果是windows则调用 JVSP_WriteToStreamOneFrame 接口数据送去解码
            //解码库调用详见流程图
        }
        break;
    }
    case JCSTREAM_EVENT_TYPE_STOP:
    {
        printf("Stream stop !\n");
        break;
    }
    default:
        break;
    }
}
int main(int argc, const char *argv[])
{
    //初始化SDK
    JCSDK_InitSDK("./");

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //开始拉流，1通道1码流的实况流
    int nChannel = 1, nStream = 1;
    JC_HANDLE pRealPlay = JCSDK_RealPlay(nLinkID, nChannel, nStream, _DataCallback, NULL);
    sleep(60);  //测试拉流1分钟
    //停止拉流
    JCSDK_StopRealPlay(&pRealPlay);
    //断开连接
    JCSDK_Disconnect(nLinkID);
    //去初始化SDC释放资源
    JCSDK_ReleaseSDK();

    while(1) sleep(1);
    return 0;
}

2.5 本地录像流程

2.5.1 流程图

2.5.2 示例代码

static void _DataCallback(JC_HANDLE pPlayHandle, JCStreamEventType_e eType, PUCHAR pData, LPVOID pUserData)
{
    switch (eType)
    {
    case JCSTREAM_EVENT_TYPE_START:
    case JCSTREAM_EVENT_TYPE_RESET:
    {
        JCStreamInfo_t *info = (JCStreamInfo_t *)pData;
        if (info)
        {
            printf("%s\n", eType == JCSTREAM_EVENT_TYPE_START ? "Stream start !" : "Stream reset !");
            printf("eVideoCodec         : %d\n", info->eVideoCodec);
        }
        break;
    }
    case JCSTREAM_EVENT_TYPE_DATA:
    {
        JCStreamFrame_t *frame = (JCStreamFrame_t *)pData;
        if(frame)
        {
            printf("recv data %d %d\n", frame->eType, frame->nFrameSize);
            //如果是windows则调用 JVSP_WriteToStreamOneFrame 接口数据送去解码
            //解码库调用详见流程图
        }
        break;
    }
    case JCSTREAM_EVENT_TYPE_STOP:
    {
        printf("Stream stop !\n");
        break;
    }
    default:
        break;
    }
}
int main(int argc, const char *argv[])
{
    //初始化SDK
    JCSDK_InitSDK("./");

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //开始拉流，1通道1码流的实况流
    int nChannel = 1, nStream = 1;
    JC_HANDLE pRealPlay = JCSDK_RealPlay(nLinkID, nChannel, nStream, _DataCallback, NULL);
    char szFilename[128] = {};
    //示例代码只保存了一个文件，如果要做持续录像，需要应层自己实现定时打包的动作。
    //定时打包的逻辑可以在 _DataCallback 中 JCSTREAM_EVENT_TYPE_DATA 事件下，在I帧来临时进行计时判断
    //如超过打包时间，如30分钟，则调用 JCSDK_StopRecord JCSDK_StartRecord 进行一次打包操作
    snprintf(szFilename, sizeof(szFilename), "./record/N%02x%02x.mp4",nChannel,nStream);
    JCSDK_StartRecord(pRealPlay, szFilename);
    sleep(5 * 60); //录像保存5分钟
    JCSDK_StopRecord(pRealPlay);
    //停止拉流
    JCSDK_StopRealPlay(&pRealPlay);
    //断开连接
    JCSDK_Disconnect(nLinkID);
    //去初始化SDC释放资源
    JCSDK_ReleaseSDK();

    while(1) sleep(1);
    return 0;
}

2.6 回放模块流程

2.6.1 流程图

2.6.2 示例代码

static void _RecDataCallback(JC_HANDLE pPlayHandle, JCStreamEventType_e eType, PUCHAR pData, LPVOID pUserData)
{
    switch (eType)
    {
    case JCSTREAM_EVENT_TYPE_START:
    case JCSTREAM_EVENT_TYPE_RESET:
    {
        JCStreamInfo_t *info = (JCStreamInfo_t *)pData;
        if (info)
        {
            printf("%s\n", eType == JCSTREAM_EVENT_TYPE_START ? "Stream start !" : "Stream reset !");
            printf("eVideoCodec         : %d\n", info->eVideoCodec);
        }
        break;
    }
    case JCSTREAM_EVENT_TYPE_DATA:
    {
        JCStreamFrame_t *frame = (JCStreamFrame_t *)pData;
        if(frame)
        {
            printf("recv data %d %d\n", frame->eType, frame->nFrameSize);
            //如果是windows则调用 JVSP_WriteToStreamOneFrame 接口数据送去解码
            //解码库调用详见流程图
        }
        break;
    }
    case JCSTREAM_EVENT_TYPE_STOP:
    {
        printf("Stream stop !\n");
        break;
    }
    default:
        break;
    }
}
static JBOOL g_bDownLoadEnd;
static void _DownloadEventCallback(JC_HANDLE pDownHandle, JCDownloadEventType_e eType, LPVOID pData, LPVOID pUserData)
{
    switch(eType)
    {
    case JCDOWNLOAD_EVENT_TYPE_DATA:
    {
        int nProgress = *((int*)pData);
        printf("download progress: %d\n",nProgress);
        break;
    }
    case JCDOWNLOAD_EVENT_TYPE_FINISH:
    {
        g_bDownLoadEnd = JTRUE;
        break;
    }
    case JCDOWNLOAD_EVENT_TYPE_ERROR:
        break;
    case JCDOWNLOAD_EVENT_TYPE_TIMEOUT:
        break;
    default:
        break;
    }
}
int main(int argc, const char *argv[])
{
    //初始化SDK
    JCSDK_InitSDK("./");

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //开始拉流，1通道1码流的实况流
    int nChannel = 1;
    JCDateYM_t stMonth = {2022,4};
    JCRecDate_t stDate = {};
    //查询录像日历
    JCSDK_GetRemoteRecDateList(nLinkID, nChannel, &stMonth, &stDate);
    JCDateTimeMs_t sTime = {2022,4,24,16,0,0},eTime = {2022,4,24,17,0,0};
    JCRecFileInfo_t *fileList = NULL;
    int fileListCount = 0;
    //查询录像列表
    JCSDK_GetRemoteRecFileList(nLinkID, nChannel, &sTime, &eTime, &fileList, &fileListCount);
    for(int i = 0; i<fileListCount;i++)
    {
        printf("%d:%s",fileList[i].nRecFileID, fileList[i].szFilename);
    }
    //按文件录像回放：
    JC_HANDLE replay = JCSDK_RemotePlaybackByFile(nLinkID, fileList[0].nRecFileID, _RecDataCallback, NULL);
    //必须调用此接口才可以播放
    JCSDK_RemotePlaybackControl(replay, JCREMOTE_PLAY_CMD_PLAY, 0, NULL);
    //配置两倍速
    JCSDK_RemotePlaybackControl(replay, JCREMOTE_PLAY_CMD_SET_SPEED, 2, NULL);
    //跳转到第120秒的位置
    JCSDK_RemotePlaybackControl(replay, JCREMOTE_PLAY_CMD_SEEK_POS, 120*1000, NULL);
    //停止回放
    JCSDK_RemotePlaybackStop(&replay);
    //按时间段录像回放：
    replay = JCSDK_RemotePlaybackByTime(nLinkID, nChannel, &sTime, &eTime, _RecDataCallback, NULL);
    //必须调用此接口才可以播放
    JCSDK_RemotePlaybackControl(replay, JCREMOTE_PLAY_CMD_PLAY, 0, NULL);
    //配置1/2倍速
    JCSDK_RemotePlaybackControl(replay, JCREMOTE_PLAY_CMD_SET_SPEED, -2, NULL);
    //跳转到第120秒的位置
    JCDateTimeMs_t pos = {2022,4,24,16,10,0};
    JCSDK_RemotePlaybackControl(replay, JCREMOTE_PLAY_CMD_SEEK_POS, 0, &pos);
    //停止回放
    JCSDK_RemotePlaybackStop(&replay);

    //下载远程录像文件
    g_bDownLoadEnd = JFALSE;
    char szFilename[512] = {};
    snprintf(szFilename, sizeof(szFilename), "./record/%s",fileList[0].szFilename);
    JCSDK_RemoteRecDownloadByFile(nLinkID, fileList[0].nRecFileID, szFilename, _DownloadEventCallback, NULL);
    //等待下载完成
    while(!g_bDownLoadEnd) sleep(1);
    //按时间段进行下载录像
    g_bDownLoadEnd = JFALSE;
    JCDateTimeMs_t sPos = {2022,4,24,16,10,0}, ePos = {2022,4,24,16,15,0};
    snprintf(szFilename, sizeof(szFilename), "./record/N%02x%02x%02x.mp4",sPos.nMinute,sPos.nHour,sPos.nSecond);
    JC_HANDLE downhand = JCSDK_RemoteRecDownloadByTime(nLinkID, nChannel, &sPos, &ePos, szFilename, _DownloadEventCallback, NULL);
    sleep(60);  //这里示例下载1分钟主动停止，正常业务逻辑是不需要的
    JCSDK_RemoteRecDownloadStop(&downhand);
    //等待结束
    while(!g_bDownLoadEnd) sleep(1);
    if(fileList)
    {
        free(fileList);
        fileList = NULL;
    }

    //断开连接
    JCSDK_Disconnect(nLinkID);
    //去初始化SDC释放资源
    JCSDK_ReleaseSDK();

    while(1) sleep(1);
    return 0;
}

2.7 对讲模块流程

2.7.1 流程图

2.7.2 示例代码

static void _TalkCallback(JC_HANDLE pTalkHandle, JCTalkEventType_e eType, PUCHAR pData, int nSize, LPVOID pUserData)
{
    switch (eType)
    {
    case JCTALK_EVENT_TYPE_START:
    {
        //双向音频的编解码参数，都是用此参数
        JCAudioCodec_t *info = (JCAudioCodec_t *)pData;
        printf("eAudioCodec       %d\n", info->eAudioCodec);
        break;
    }
    case JCTALK_EVENT_TYPE_DATA:
    {
        printf(">>>>> _JCTalkCallback recv data ! size:%d\n", nSize);
        break;
    }
    case JCTALK_EVENT_TYPE_STOP:
    {
        printf(">>>>> _JCTalkCallback Stop \n");
        break;
    }
    default:
        break;
    }
}
static int _getMicData(unsigned char *micData)
{
    //TO DO 读取本地mic音频编码数据，应用自行实现
    usleep(40*1000);
    return 0;
}
int main(int argc, const char *argv[])
{
    //初始化SDK
    JCSDK_InitSDK("./");

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //开始对讲
    int nChannel = 1;   //和nvr的1通道对讲，如果和nvr对讲则传 0
    JC_HANDLE pTalkHand = JCSDK_StartTalk(nLinkID, nChannel, _TalkCallback, NULL);
    unsigned char micData[1024];
    int dataLen = 0;
    int talkCount = 100;
    while(talkCount-- > 0)
    {
        dataLen = _getMicData(micData);
        JCSDK_SendTalkData(pTalkHand, micData, dataLen);
    }
    //停止拉流
    JCSDK_StopTalk(&pTalkHand);
    //断开连接
    JCSDK_Disconnect(nLinkID);
    //去初始化SDK释放资源
    JCSDK_ReleaseSDK();

    while(1) sleep(1);
    return 0;
}

2.8 参数配置流程

2.8.1 流程图

2.8.2 示例代码

int main(int argc, const char *argv[])
{
    //初始化SDK
    JCSDK_InitSDK("./");

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //设备配置，此处仅调用了一个接口，jconfig.h中其他类似
    JCDevHWinfo_t stInfo = {};
    JBOOL bRet = JCSDK_GetDeviceAbility(nLinkID, &stInfo);
    if(!bRet)
    {
        //获取错误码示例，错误码详见 jerror.h
        printf("JCSDK_InitSDK error: %d\n", JCSDK_GetLastError());
        return 0;
    }
    //断开连接
    JCSDK_Disconnect(nLinkID);
    //去初始化SDC释放资源
    JCSDK_ReleaseSDK();

    while(1) sleep(1);
    return 0;
}

2.9 设备维护流程

2.9.1 流程图

2.9.2 设备维护升级示例代码

static void _ReadVersionFile(char *verFile, char * verData)
{
    //实现读取本地版本文件的功能，应用自行实现
}
int main(int argc, const char *argv[])
{
    //初始化SDK
    JCSDK_InitSDK("./");

    //设备连接断开连接代码示例
    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    JCLink_t nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //本地文件升级示例
    JCUpgradeInfo_t stUpInfo;
    //获取升级信息
    JCSDK_GetUpgradeInfo(nLinkID, JCUPGRADE_TYPE_MAIN, &stUpInfo);
    JCDevCheckInfo_t stInfo;
    stInfo.eMethod = JCUPGRADE_METHOD_FILE;
    stInfo.eType = JCUPGRADE_TYPE_MAIN;
    //读取本地版本文件：文件所在路径需要用户选择，程序进行拼接
    _ReadVersionFile(stUpInfo.szVerFileName, stInfo.verdata);
    JCDevVerInfo_t stVerInfo;
    //检查设备版本信息，是否需要升级
    JCSDK_CheckVersion(nLinkID, &stInfo, &stVerInfo);
    if(stVerInfo.bNeedUpdate)
    {
        printf("need update, now version:%s\n",stVerInfo.szVersion);
        JCUpgradeParam_t stParam;
        stParam.eMethod = JCUPGRADE_METHOD_FILE;
        stParam.eType = JCUPGRADE_TYPE_MAIN;
        //通知设备开始升级
        JCSDK_StartUpgrade(nLinkID, &stParam);
        char szFilename[128] = {};
        //路径+升级文件名称，拼接起来
        snprintf(szFilename, sizeof(szFilename), "./upgrade/%s", stUpInfo.szBinFileName);
        //发送升级升级
        JCSDK_SendUpgradeFile(nLinkID, szFilename);
        while(1)
        {
            JCUpgradeProgress_t stProgress;
            //获取升级进度
            JCSDK_GetUpgradeProgress(nLinkID, &stProgress);
            printf("grogress: %d,%d\n",stProgress.ePhase, stProgress.nProgress);
            //升级完成
            if(stProgress.ePhase == JCUPGRADE_PHASE_FINISHED)
                break;
        }
    }
    //断开连接
    JCSDK_Disconnect(nLinkID);

    //使用IP地址连接设备：IP来自搜索设备信息中的szIPV4IP参数，18320端口来自nTransPort参数
    nLinkID = JCSDK_Connect_V2("172.16.33.222", 18320, "admin", "admin12345", 3000);
    //在线升级示例代码
    //获取升级信息
    JCSDK_GetUpgradeInfo(nLinkID, JCUPGRADE_TYPE_MAIN, &stUpInfo);
    stInfo.eMethod = JCUPGRADE_METHOD_HTTP;
    stInfo.eType = JCUPGRADE_TYPE_MAIN;
    //在线地址类型：注意这里是固定的三个类型，而不是真实的地址：wt（联通）、dx（电信1）、hw（电信2）
    snprintf(stInfo.szUrl,sizeof(stInfo.szUrl),"%s","wx");
    //检查设备版本信息，是否需要升级
    JCSDK_CheckVersion(nLinkID, &stInfo, &stVerInfo);
    if(stVerInfo.bNeedUpdate)
    {
        printf("need update, now version:%s\n",stVerInfo.szVersion);
        JCUpgradeParam_t stParam;
        stParam.eMethod = JCUPGRADE_METHOD_HTTP;
        stParam.eType = JCUPGRADE_TYPE_MAIN;
        //在线地址类型：注意这里是固定的三个类型，而不是真实的地址：wt（联通）、dx（电信1）、hw（电信2）
        snprintf(stParam.szUrl,sizeof(stParam.szUrl),"%s","wx");
        //通知设备开始升级
        JCSDK_StartUpgrade(nLinkID, &stParam);
        while(1)
        {
            JCUpgradeProgress_t stProgress;
            //获取升级进度
            JCSDK_GetUpgradeProgress(nLinkID, &stProgress);
            printf("grogress: %d,%d\n",stProgress.ePhase, stProgress.nProgress);
            //升级完成
            if(stProgress.ePhase == JCUPGRADE_PHASE_FINISHED)
                break;
        }
    }
    //断开连接
    JCSDK_Disconnect(nLinkID);
    //去初始化SDC释放资源
    JCSDK_ReleaseSDK();

    while(1) sleep(1);
    return 0;
}

3. 接口定义

3.1 SDK初始化

3.1.1 获取错误码

接口声明：

DWORD JCSDK_GetLastError(void);

接口描述：获取错误码

接口参数：无

返回值：错误码，详见 错误码列表。

Remarks：无

See Also：无

3.1.2 获取SDK版本号

接口声明：

JCSDK_API const char *JCSDK_CALLTYPE JCSDK_GetSDKVer(void);

接口描述：获取SDK版本号

接口参数：无

返回值：SDK版本号常量

Remarks：无

See Also：无

3.1.3 初始化SDK日志

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_InitLog(JCSdkLogType_e nType, JCSdkLogLevel_e eLevel, const char *szLogPath, JCCustomLogCallBack_t funcCustomLogCallback);

接口描述：初始化SDK日志

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

Remarks：无

See Also：无

3.1.4 初始化SDK

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_InitSDK(const char *szTempPath);

接口描述：初始化SDK

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：无

Remarks：无

See Also：无

3.1.5 释放SDK

接口声明：

JCSDK_API void JCSDK_CALLTYPE JCSDK_ReleaseSDK(void);

接口描述：释放SDK

接口参数：无

返回值：无

错误码：无

Remarks：无

See Also：无

3.2 设备搜索

3.2.1 广播搜索设备

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SearchDevice(JCDeviceType_e nDeviceType, DWORD dwTimeout, JCSearchDeviceCallback_t funSearchDeviceCallback, LPVOID pUserData);

接口描述：初始化SDK

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.2.2 广播激活设备

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_ActiveDevice(const char *szDevID, const char *szName, const char *szPwd, JCPasswdQuestionList_t *questions, int nTimemsec);

接口描述：广播激活设备

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.2.3 广播配置网络

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetNetCfg(const char *szDevID, const char *szName, const char *szPwd, const JCDeviceNetworkCfg_t *pstNetCfg, int nTimemsec);

接口描述：局域网广播配置设备IP

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.2.4 广播找回密码

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_LostPasswd(const char *szDevID, const char *szName, int *errorcode)

接口描述：局域网广播密码找回

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：无

Remarks：无

See Also：无

3.2.5 跨网段搜索设备

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SearchDeviceByIPSection(JCDeviceType_e nDeviceType, DWORD dwTimeout, const JCIPSection_t*ipSections, int ipSectionCnt, JCSearchDeviceCallback_t funSearchDeviceCallback, LPVOID pUserData);

接口描述：跨网段搜索

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：无

Remarks：无

See Also：无

3.2.6 搜索设备回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCSearchDeviceCallback_t)(bool bFinished, const JCDeviceInfo_t *pInfo, void *param);

接口描述：搜索设备回调

接口参数：

返回值：无

错误码：无

Remarks：无

See Also：无

3.3 用户登录

3.3.1 启动主动注册服务

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartRegisterService (const char *szIP, int nPort, JCRegisterServiceCallback_t funRegisterServiceCallback, LPVOID pUserData);

接口描述：启动主动注册服务

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：无

Remarks：无

See Also：无

3.3.2 连接（登录）主动注册设备

接口声明：

JCSDK_API JCLink_t JCSDK_CALLTYPE JCSDK_ConnectByRegister(int nConnID, const char* szDeviceID, const char* szUser, const char* szPwd);

接口描述：

接口参数：

返回值：成功返回连接ID， <0失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：无

Remarks：无

See Also：无

3.3.3 主动注册通知回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCRegisterServiceCallback_t)(int nConnID, const char *szDeviceID, LPVOID pUserData);

接口描述：主动注册通知回调

接口参数：

返回值：无

错误码：无

Remarks：无

See Also：无

3.3.4 通过IP地址连接（登录）设备

接口声明：

JCSDK_API JCLink_t JCSDK_CALLTYPE JCSDK_Connect_V2(const char *ipaddr, int nPort, const char *szUser, const char *szPwd, int ntimeOut);

接口描述：通过IP地址连接（登录）设备

接口参数：

返回值：成功返回连接ID， <0失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.3.5 断开连接（登出）设备

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_Disconnect(JCLink_t nLinkID);

接口描述：断开连接（登出）设备

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.3.6 注册事件通知回调

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_RegisterCallback(JCLink_t nLinkID, JCEventCallback_t funEventCallback, LPVOID pUserData);

接口描述：

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.3.7 事件通知回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCEventCallback_t)(JCLink_t nLinkID, JCEventType_e eType, LPVOID pData, LPVOID pUserData);

接口描述：事件通知回调

接口参数：

返回值：无

错误码：无

Remarks：无

See Also：无

3.4 实况预览

3.4.1 拉取实况（直播）流

接口声明：

JCSDK_API JC_HANDLE JCSDK_CALLTYPE JCSDK_RealPlay(JCLink_t nLinkID, int nChannel, int nStream, JCDataCallback_t funDataCallback, LPVOID pUserData);

接口描述：拉取实况（直播）流

接口参数：

返回值：成功返回直播句柄，NULL失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.4.2 停止实况（直播）流

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopRealPlay(JC_HANDLE* pPlayHandle);

接口描述：停止实况（直播）流

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.4.3 实况数据事件回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCDataCallback_t)(JC_HANDLE pPlayHandle, JCStreamEventType_e eType, PUCHAR pData, LPVOID pUserData);

接口描述：实况数据事件回调

接口参数：

返回值：无

错误码：无

Remarks：无

See Also：无

3.5 本地功能

3.5.1 开始本地录像

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartRecord(JC_HANDLE pPlayHandle, char *szPath);

接口描述：开始本地录像

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.5.2 停止本地录像

接口声明：停止本地录像

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopRecord(JC_HANDLE pPlayHandle);

接口描述：

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：

如果要做持续录像，需要应层自己实现定时打包的动作。定时打包的逻辑可以在 _DataCallback 中 JCSTREAM_EVENT_TYPE_DATA 事件下，在I帧来临时进行计时判断。如超过打包时间，如30分钟，则调用 JCSDK_StopRecord JCSDK_StartRecord 进行一次打包操作。

See Also：无

3.6 设备端录像操作

3.6.1 查询设备录像月历

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetRemoteRecDateList(JCLink_t nLinkID, int nChannel, JCDateYM_t *pstMonth, JCRecDate_t *pstDate);

接口描述：查询设备录像月历

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.2 查询设备录像列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetRemoteRecFileList(JCLink_t nLinkID, int nChannel, JCDateTimeMs_t *pstBegin, JCDateTimeMs_t *pstEnd, JCRecFileInfo_t **pstFilelist, int *pnFileListCount);

接口描述：查询设备录像列表

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.3 按检索文件名回放设备录像

接口声明：

JCSDK_API JC_HANDLE JCSDK_CALLTYPE JCSDK_RemotePlaybackByFile(JCLink_t nLinkID, int nFileID, JCDataCallback_t funDataCallback, LPVOID pUserData);

接口描述：按检索文件名回放设备录像

接口参数：

返回值：成功返录像handle, 失败返回NULL，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.4 按时间段回放设备录像

接口声明：

JCSDK_API JC_HANDLE JCSDK_CALLTYPE JCSDK_RemotePlaybackByTime(JCLink_t nLinkID, int nChannel, JCDateTimeMs_t *nBegTime, JCDateTimeMs_t *nEndTime, JCDataCallback_t funDataCallback, LPVOID pUserData);

接口描述：按时间段回放设备录像

接口参数：

返回值：成功返录像handle, 失败返回NULL，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.5 设备录像回放控制

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_RemotePlaybackControl(JC_HANDLE pPlayHandle, JCRemotePlayCommand_e nCmd, int nParam, JCDateTimeMs_t *pTime);

接口描述：设备录像回放控制

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.6 停止设备录像回放

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_RemotePlaybackStop(JC_HANDLE *pPlayHandle);

接口描述：停止设备录像回放

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.7 录像回放数据事件回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCDataCallback_t)(JC_HANDLE pPlayHandle, JCStreamEventType_e eType, PUCHAR pData, LPVOID pUserData);

接口描述：录像回放数据事件回调

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：无

Remarks：无

See Also：无

3.6.8 按检索文件名下载录像

接口声明：

JCSDK_API JC_HANDLE JCSDK_CALLTYPE JCSDK_RemoteRecDownloadByFile(JCLink_t nLinkID, int nFileID, char *szPath, JCDownloadEventCallback_t funDownloadEventCallback, LPVOID pUserData);

接口描述：按检索文件名下载录像

接口参数：

返回值：成功返回下载句柄, NULL失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.9 按时间段下载录像

接口声明：

JCSDK_API JC_HANDLE JCSDK_CALLTYPE JCSDK_RemoteRecDownloadByTime(JCLink_t nLinkID, int nChannel, JCDateTimeMs_t *nBegTime, JCDateTimeMs_t *nEndTime, char *szPath, JCDownloadEventCallback_t funDownloadEventCallback, LPVOID pUserData);

接口描述：

接口参数：

返回值：成功返回下载句柄, NULL失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.10 停止下载录像

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_RemoteRecDownloadStop(JC_HANDLE *pDownHandle);

接口描述：停止下载录像

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.6.11 录像下载事件回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCDownloadEventCallback_t)(JC_HANDLE pDownHandle, JCDownloadEventType_e eType, LPVOID pData, LPVOID pUserData);

接口描述：

接口参数：

返回值：无

错误码：无

Remarks：无

See Also：无

3.7 设备对讲

3.7.1 开启对讲

接口声明：

JCSDK_API JC_HANDLE JCSDK_CALLTYPE JCSDK_StartTalk(JCLink_t nLinkID, int nChannel, JCTalkCallback_t funTalkCallback, LPVOID pUserData);

接口描述：开启对讲

接口参数：

返回值：成功返回对讲handle, 失败返回NULL，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.7.2 停止对讲

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopTalk(JC_HANDLE *pTalkHandle);

接口描述：停止对讲

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.7.3 对讲数据事件回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCTalkCallback_t)(JC_HANDLE pTalkHandle, JCTalkEventType_e eType, PUCHAR pData, int nSize, LPVOID pUserData);

接口描述：对讲数据事件回调

接口参数：

返回值：无

错误码：无

Remarks：无

See Also：无

3.7.4 发送对讲数据

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SendTalkData(JC_HANDLE pTalkHandle, PUCHAR pData, int nSize);

接口描述：发送对讲数据

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.8 订阅智能元数据

3.8.1 订阅智能元数据

接口声明：

JCSDK_API JC_HANDLE JCSDK_CALLTYPE JCSDK_SubscribeMetadata(JCLink_t nLinkID, int nChannel, JCSubscribeParam_t *param, int nParamCount, JCTLVDataCallback_t funTLVDataCallback, LPVOID pUserData);

接口描述：订阅智能元数据

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.8.2 取消订阅

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_UnSubscribeMetadata(JC_HANDLE *nSubHandle);

接口描述：取消订阅

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.8.3 智能元数据回调

接口声明：

typedef void (JVSDK_CALLBACKTYPE *JCTLVDataCallback_t)(JCLink_t nLinkID, PUCHAR pData, int nSize, LPVOID pUserData);

接口描述：智能元数据回调

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：无

Remarks：无

See Also：无

3.9 设备升级

3.9.1 获取升级信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetUpgradeInfo(JCLink_t nLinkID, JCUpgradeType_e eType, JCUpgradeInfo_t *pstInfo);

接口描述：

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.9.2 查询版本信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_CheckVersion(JCLink_t nLinkID, JCDevCheckInfo_t *pstInfo, JCDevVerInfo_t *pstVerInfo);

接口描述：检测版本是否需要升级

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.9.3 开始升级

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartUpgrade(JCLink_t nLinkID, JCUpgradeParam_t *pstInfo);

接口描述：开始升级

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.9.4 获取升级进度

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetUpgradeProgress(JCLink_t nLinkID, JCUpgradeProgress_t *pstProgress);

接口描述：获取升级进度

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：无

See Also：无

3.9.5 发送升级文件

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SendUpgradeFile(JCLink_t nLinkID, const char *pFilePath);

接口描述：发送升级文件

接口参数：

返回值：JTRUE 成功，JFALSE 失败，通过 JCSDK_GetLastError 获取详细错误码

错误码：

Remarks：接口内部异步发送文件，请使用 JCSDK_GetUpgradeProgress 查询发送进度以及错误码

See Also：无

3.10 参数配置

3.10.1 设备管理

3.10.1.1 获取设备能力集

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetDeviceAbility(JCLink_t nLinkID, JCDevHWinfo_t *pstInfo);

接口描述： 获取设备能力集

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.1.2 获取通道能力集

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetChannelAbility(JCLink_t nLinkID, int nChannel, JCChannelAbility_t *pstAbility);

接口描述： 获取通道能力集

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.1.3 获取通道信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetChannelInfo(JCLink_t nLinkID, JCChannelInfo_t **pstChannelsInfo, int *pnCount);

接口描述： 获取通道信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.1.4 获取设备系统信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetDeviceSysinfo(JCLink_t nLinkID, JCDevSysinfo_t *pstInfo);

接口描述： 获取设备系统信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.1.5 配置设备系统信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetDeviceSysinfo(JCLink_t nLinkID, JCDevSysinfo_t *pstInfo);

接口描述： 配置设备系统信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.1.6 获取设备时间

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetDeviceTime(JCLink_t nLinkID, JCDevTime_t *pstTime);

接口描述： 获取设备时间

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.1.7 配置设备时间

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetDeviceTime(JCLink_t nLinkID, JCDevTime_t *pstTime);

接口描述： 配置设备时间

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.1.8 获取设备NTP参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetDeviceNtp(JCLink_t nLinkID, JCDevNtp_t *pstNtp);

接口描述： 获取设备NTP参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.1.9 配置设备NTP参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetDeviceNtp(JCLink_t nLinkID, JCDevNtp_t *pstNtp);

接口描述： 配置设备NTP参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.1.10 重启设备

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_RebootDevice(JCLink_t nLinkID, int nChannel);

接口描述： 重启设备

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.1.11 恢复系统

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_RecoveryDefault(JCLink_t nLinkID, int nChannel);

接口描述： 恢复系统

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.1.12 查询操作日志

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetLogList(JCLink_t nLinkID, JCLogParam_t *pstParam, JCLogList_t *pstLogList);

接口描述： 查询操作日志

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.2 账号管理

3.10.2.1 查询用户列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetUsers(JCLink_t nLinkID, JCUser_t **pstUserList, int *pnCount);

接口描述： 查询用户列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.2.2 添加账号

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_AddUser(JCLink_t nLinkID, JCUserInfo_t *pstUserInfo);

接口描述： 添加账号

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.2.3 删除账号

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_DelUser(JCLink_t nLinkID, const char *pName, const char *pOPPwd);

接口描述： 删除账号

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.2.4 修改账号

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_ModifyUser(JCLink_t nLinkID, JCUserInfo_t *pUser, const char *pOldPwd);

接口描述： 修改账号

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.2.5 修改密保

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_ModifyQuestions(JCLink_t nLinkID, const char *pName, const char *pOPPwd, JCQuestion_t arQues[3]);

接口描述： 修改密保

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3 码流管理

3.10.3.1 获取视频参数能力集

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetVedioAbility(JCLink_t nLinkID, int nChannel, JCVideoAbility_t abilitys[JCMAX_STREAM_CNT], int *pnCount);

接口描述： 获取视频参数能力集

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.2 获取视频参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetVedioParams(JCLink_t nLinkID, int nChannel, JCVideoParam_t **pstParams, int *pnCount);

接口描述： 获取视频参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.3 配置视频参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetVedioParams(JCLink_t nLinkID, int nChannel, JCVideoParam_t *pstParams, int nCount);

接口描述： 配置视频参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.4 申请I帧

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_RequestKeyFrame(JCLink_t nLinkID, int nChannel, int nStream);

接口描述： 申请I帧

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.3.5 获取音频参数能力集

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAudioAbility(JCLink_t nLinkID, int nChannel, JCAudioAbility_t *pstAbility);

接口描述： 获取音频参数能力集

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.6 获取音频输入参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAudioInParams(JCLink_t nLinkID, int nChannel, JCAudioParam_t *pstParams);

接口描述： 获取音频输入参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.7 配置音频输入参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAudioInParams(JCLink_t nLinkID, int nChannel, JCAudioParam_t *pstParams);

接口描述： 配置音频输入参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.8 获取音频输出参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAudioOutParams(JCLink_t nLinkID, int nChannel, JCAudioParam_t *pstParams);

接口描述： 获取音频输出参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.9 配置音频输出参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAudioOutParams(JCLink_t nLinkID, int nChannel, JCAudioParam_t *pstParams);

接口描述： 配置音频输出参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.10 获取对讲模式

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetChatMode(JCLink_t nLinkID, int nChannel, JCChatMode_e *peMode);

接口描述： 获取对讲模式

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.3.11 配置对讲模式

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetChatMode(JCLink_t nLinkID, int nChannel, JCChatMode_e eMode);

接口描述： 配置对讲模式

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4 图像管理

3.10.4.1 获取图像能力集

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetImageAbility(JCLink_t nLinkID, int nChannel, JCImageAbility_t *pstAbility);

接口描述： 获取图像能力集

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.2 获取图像参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetImageParam(JCLink_t nLinkID, int nChannel, JCImageParam_t *pstParam);

接口描述： 获取图像参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.3 配置图像参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetImageParam(JCLink_t nLinkID, int nChannel, JCImageParam_t *pstParam);

接口描述： 配置图像参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.4 获取宽动态参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetWdr(JCLink_t nLinkID, int nChannel, JCWdr_t *pstParam);

接口描述： 获取宽动态参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.5 配置宽动态参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetWdr(JCLink_t nLinkID, int nChannel, JCWdr_t *pstParam);

接口描述： 配置宽动态参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.6 获取日夜切换模式参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetDayNightMode(JCLink_t nLinkID, int nChannel, JCDayNightMode_t *pstMode);

接口描述： 获取日夜切换模式参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.7 配置日夜切换模式

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetDayNightMode(JCLink_t nLinkID, int nChannel, JCDayNightMode_t *pstMode);

接口描述： 配置日夜切换模式

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.8 获取高级图像参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAdvancedImageParam(JCLink_t nLinkID, int nChannel, JCImageAdvaced_t *pstAdv);

接口描述： 获取高级图像参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.9 配置高级图像参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAdvancedImageParam(JCLink_t nLinkID, int nChannel, JCImageAdvaced_t *pstAdv);

接口描述： 配置高级图像参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.10 获取osd参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetOsdAbility(JCLink_t nLinkID, int nChannel, JCOsdAbility_t *pstOsdAbility);

接口描述： 获取osd参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.11 获取osd参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetOsd(JCLink_t nLinkID, int nChannel, JCOsd_t *pstOsd);

接口描述： 获取osd参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.12 配置osd参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetOsd(JCLink_t nLinkID, int nChannel, JCOsd_t *pstOsd);

接口描述： 配置osd参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.13 获取通道osd参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetChnOsd(JCLink_t nLinkID, JCChnOsd_t **pstOsds, int *pnCount);

接口描述： 获取通道osd参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.14 配置通道osd参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetChnOsd(JCLink_t nLinkID, JCChnOsd_t *pstOsds, int nCount);

接口描述： 配置通道osd参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.15 获取自定义osd参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetMultiOsd(JCLink_t nLinkID, int nChannel, JCMultiOsd_t *pstMulti);

接口描述： 获取自定义osd参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.16 获取自定义osd参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetMultiOsd(JCLink_t nLinkID, int nChannel, JCMultiOsd_t *pstMulti);

接口描述： 获取自定义osd参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.4.17 获取隐私遮挡参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetPrivacy(JCLink_t nLinkID, int nChannel, JCPrivacy_t *pstPrivacy);

接口描述： 获取隐私遮挡参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.18 配置隐私遮挡参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetPrivacy(JCLink_t nLinkID, int nChannel, JCPrivacy_t *pstPrivacy);

接口描述： 配置隐私遮挡参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.4.19 远程手动抓拍图片

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetStreamSnapJpeg(JCLink_t nLinkID, int nChannel, int nWidth, int nHeight, char **pImageData, int *nDataLen);

接口描述： 远程手动抓拍图片

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5 报警管理

3.10.5.1 获取布防计划

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetDefencePlan(JCLink_t nLinkID, int nPlanID, JCDefencePlan_t *pstPlan, JBOOL bDefault);

接口描述： 获取布防计划

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5.2 配置布防计划

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetDefencePlan(JCLink_t nLinkID, int nPlanID, JCDefencePlan_t *pstPlan);

接口描述： 配置布防计划

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.3 获取报警联动参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAlarmLink(JCLink_t nLinkID, int nAlinkID, JCAlarmLink_t *pstLink, JBOOL bDefault);

接口描述： 获取报警联动参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5.4 配置报警联动参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAlarmLink(JCLink_t nLinkID, int nAlinkID, JCAlarmLink_t *pstLink);

接口描述： 配置报警联动参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.5 获取报警输入参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAlarmin(JCLink_t nLinkID, JCAlarmin_t **pstAlinList, int *pnCount);

接口描述： 获取报警输入参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.6 配置报警输入参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAlarmin(JCLink_t nLinkID, JCAlarmin_t *pstAlinList, int nCount);

接口描述： 配置报警输入参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5.7 获取报警输出参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAlarmOut(JCLink_t nLinkID, JCAlarmOut_t **pstAloutList, int *pnCount);

接口描述： 获取报警输出参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5.8 配置报警输出参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAlarmOut(JCLink_t nLinkID, JCAlarmOut_t *pstAloutList, int nCount);

接口描述： 配置报警输出参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.9 获取Modbus设备参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetModbusDev(JCLink_t nLinkID, JCModbusDev_t *pstModbus);

接口描述： 获取Modbus设备参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5.10 配置Modbus设备参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetModbusDev(JCLink_t nLinkID, JCModbusDev_t *pstModbus);

接口描述： 配置Modbus设备参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.11 获取报警声音列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAlarmSoundList(JCLink_t nLinkID, int nChannel, JCAlarmSound_t **pstSoundlist, int *pnCount);

接口描述： 获取报警声音列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.12 配置自定义报警音

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAlarmSoundInfo(JCLink_t nLinkID, int nChannel, JCAlarmSoundInfo_t *pstSoundinfo);

接口描述： 配置自定义报警音

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.13 播放报警音文件

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_PlayAlarmSound(JCLink_t nLinkID, int nChannel, const char *pName);

接口描述： 播放报警音文件

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.14 手动触发设备报警联动

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_ManualTriggerAlarmLink(JCLink_t nLinkID, int nChannel, JCManualAlarmLink_t *pstLink);

接口描述： 手动触发设备报警联动

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5.15 手动消警

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_ManualCancelAlarm(JCLink_t nLinkID, int nChannel, const char *pAlarmtype);

接口描述： 手动消警

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.5.16 获取报警记录

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAlarmInfoList(JCLink_t nLinkID, int nChannel, JCAlarmInfoQuery_t *pstQuery, JCAlarmInfoList_t *pstList);

接口描述： 获取报警记录

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：

仅NVR支持

See Also：无

3.10.5.17 获取移动侦测参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetMotionDetection(JCLink_t nLinkID, int nChannel, JCMotionDetection_t *pstMd);

接口描述： 获取移动侦测参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.5.18 配置移动侦测参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetMotionDetection(JCLink_t nLinkID, int nChannel, JCMotionDetection_t *pstMd);

接口描述： 配置移动侦测参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.6 网络管理

3.10.6.1 IP冲突检测

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_CheckIPConflict(JCLink_t nLinkID, const char *pIpaddr, int nTimeout);

接口描述： IP冲突检测

接口参数：

返回值： GTRUE 冲突，GFALSE 不冲突

专用错误码：无

Remarks：

配置固定IP之前，可调用此接口判断是否存在IP冲突的情况

See Also：无

3.10.6.2 获取网络信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetNetInfo(JCLink_t nLinkID, JCNetInfo_t *pstNet);

接口描述： 获取网络信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：

本接口一次查询所有网卡的ip信息

See Also：无

3.10.6.3 配置有线网卡地址

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetEthInfo(JCLink_t nLinkID, JCEth_t *pstEth);

接口描述： 配置有线网卡地址

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.6.4 配置高级网络参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetAdvacedEthInfo(JCLink_t nLinkID, JCAdvancedEth_t *pstEAdvEth);

接口描述： 配置高级网络参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.5 搜索AP列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetAPList(JCLink_t nLinkID, JCAPInfo_t **pstAplist, int *pnCount);

接口描述： 搜索AP列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.6 获取无线网卡配置

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetWifiCfg(JCLink_t nLinkID, JCWifi_t *pstWifi);

接口描述： 获取无线网卡配置

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.7 配置无线参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetWifiCfg(JCLink_t nLinkID, JCWifi_t *pstWifi);

接口描述： 配置无线参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：

连接wifi

See Also：无

3.10.6.8 获取无线网卡模式

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetWifiMode(JCLink_t nLinkID, JCWifiMode_e *peMode);

接口描述： 获取无线网卡模式

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.9 配置无线网卡模式

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetWifiMode(JCLink_t nLinkID, JCWifiMode_e eMode);

接口描述： 配置无线网卡模式

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.10 获取外部端口号参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetNetPortInfo(JCLink_t nLinkID, JCNetPortInfo_t *pstPort);

接口描述： 获取外部端口号参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.11 配置外部端口号参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetNetPortInfo(JCLink_t nLinkID, JCNetPortInfo_t *pstPort);

接口描述： 配置外部端口号参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.12 获取动态域名参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetDDNS(JCLink_t nLinkID, JCDDNS_t *pstDdns);

接口描述： 获取动态域名参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.13 配置动态域名参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetDDNS(JCLink_t nLinkID, JCDDNS_t *pstDdns);

接口描述： 配置动态域名参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.14 获取ftp服务器

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetFtpCfg(JCLink_t nLinkID, JCFtpCfg_t *pstFtp);

接口描述： 获取ftp服务器

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：

用于设备上传图片等

See Also：无

3.10.6.15 配置ftp服务器

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetFtpCfg(JCLink_t nLinkID, JCFtpCfg_t *pstFtp);

接口描述： 配置ftp服务器

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.16 获取http服务器参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetHttpCfg(JCLink_t nLinkID, bool isDefault, JCHttpCfg_t *pstHttp);

接口描述： 获取http服务器参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：

用于设备上报报警消息、或智能检测数据等

See Also：无

3.10.6.17 配置http服务器参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetHttpCfg(JCLink_t nLinkID, JCHttpCfg_t *pstHttp);

接口描述： 配置http服务器参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.18 获取GPS信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetGPSStatus(JCLink_t nLinkID, JCGPSStatus_t *pstGps);

接口描述： 获取GPS信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.19 获取移动网络状态

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetXGStatus(JCLink_t nLinkID, JCXGStatus_t *pstXg);

接口描述： 获取移动网络状态

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.20 获取云服务参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetCloudServerCfg(JCLink_t nLinkID, JCCloudType_e eType, JCCloudCfg_t *pstCfg, JBOOL bDefault);

接口描述： 获取云服务参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.6.21 配置云服务参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetCloudServerCfg(JCLink_t nLinkID, JCCloudType_e eType, JCCloudCfg_t *pstCfg);

接口描述： 配置云服务参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.6.22 配置云服务证书

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetCloudServerCert(JCLink_t nLinkID, JCCloudType_e eType, JCCert_t *pstCert);

接口描述： 配置云服务证书

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.6.23 获取邮箱参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetEMailCfg(JCLink_t nLinkID, JCEMailCfg_t *pstMail);

接口描述： 获取邮箱参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.24 配置邮箱参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetEMailCfg(JCLink_t nLinkID, JCEMailCfg_t *pstMail);

接口描述： 配置邮箱参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.25 测试邮箱参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_TestEMail(JCLink_t nLinkID, JCEMailCfg_t *pstMail);

接口描述： 测试邮箱参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.26 获取GB28181参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetGB28181Cfg(JCLink_t nLinkID, JCGB28181Cfg_t *pstGb);

接口描述： 获取GB28181参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.27 配置GB28181参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetGB28181Cfg(JCLink_t nLinkID, JCGB28181Cfg_t *pstGb);

接口描述： 配置GB28181参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.6.28 获取GA1400参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetGA1400Cfg(JCLink_t nLinkID, JCGA1400Cfg_t *pstGa);

接口描述： 获取GA1400参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.6.29 配置GA1400参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetGA1400Cfg(JCLink_t nLinkID, JCGA1400Cfg_t *pstGa);

接口描述： 配置GA1400参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7 存储管理

3.10.7.1 获取存储信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetStorageInfo(JCLink_t nLinkID, JCStorage_t *pstStorage);

接口描述： 获取存储信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7.2 格式化磁盘

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_FormatDisk(JCLink_t nLinkID, int diskNum, int partNum);

接口描述： 格式化磁盘

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7.3 获取格式化进度

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetFormatProgress(JCLink_t nLinkID, int diskNum, int partNum, int *progress);

接口描述： 获取格式化进度

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7.4 获取定时抓拍参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetTimingSnapCfg(JCLink_t nLinkID, int nChannel, JCTimingSnap_t *pstTask);

接口描述： 获取定时抓拍参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7.5 配置定时抓拍参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetTimingSnapCfg(JCLink_t nLinkID, int nChannel, JCTimingSnap_t *pstTask);

接口描述： 配置定时抓拍参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7.6 查询抓拍文件列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetSnapFileList(JCLink_t nLinkID, int nChannel, JCSanpQuery_t *pstQuery, JCSnapFileList_t *pstList);

接口描述： 查询抓拍文件列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7.7 查询抓拍月历

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetSnapDateList(JCLink_t nLinkID, int nChannel, JCDateYM_t *month, JCRecDate_t *date);

接口描述： 查询抓拍月历

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.7.8 获取抓拍文件

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetSnapFile(JCLink_t nLinkID, int nChannel, const char *pPath, unsigned char **pData, int *pnSize);

接口描述： 获取抓拍文件

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8 云台管理

3.10.8.1 获取云台能力集

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetPTZAbility(JCLink_t nLinkID, int nChannel, JCPTZAbility_t *pstAbility);

接口描述： 获取云台能力集

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.2 开始转动云台

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartMovePTZ(JCLink_t nLinkID, int nChannel, JCPTZMoveParam_t *pstMove);

接口描述： 开始转动云台

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.3 停止转动云台

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopMovePTZ(JCLink_t nLinkID, int nChannel);

接口描述： 停止转动云台

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.4 开始调节镜头参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartMoveFI(JCLink_t nLinkID, int nChannel, JCFIMoveParam_t *pstMove);

接口描述： 开始调节镜头参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.5 停止镜头转动

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopMoveFI(JCLink_t nLinkID, int nChannel);

接口描述： 停止镜头转动

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.6 获取预置点列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetPresetList(JCLink_t nLinkID, int nChannel, JCPreset_t **pstPresetList, int *pnCount);

接口描述： 获取预置点列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.7 配置预置位

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetPreset(JCLink_t nLinkID, int nChannel, JCPreset_t *pstPreset);

接口描述： 配置预置位

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.8 调用预置位

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_LocatePreset(JCLink_t nLinkID, int nChannel, int nPresetID, int nSpeed);

接口描述： 调用预置位

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.9 删除预制位

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_DeletePreset(JCLink_t nLinkID, int nChannel, int nPresetID);

接口描述： 删除预制位

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.10 获取巡航线列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetPatrolList(JCLink_t nLinkID, int nChannel, JCPatrolInfo_t **pstPatrolList, int *pnCount);

接口描述： 获取巡航线列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.11 创建巡航线

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_CreatePatrol(JCLink_t nLinkID, int nChannel, int *pnPatrolID);

接口描述： 创建巡航线

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.12 删除巡航线

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_DeletePatrol(JCLink_t nLinkID, int nChannel, int nPatrolID);

接口描述： 删除巡航线

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.13 为巡航线添加巡航点

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_PatrolAddNode(JCLink_t nLinkID, int nChannel, int nPatrolID, JCPatroNode_t *pstNode);

接口描述： 为巡航线添加巡航点

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.14 删除巡航线的巡航点

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_PatrolDelNode(JCLink_t nLinkID, int nChannel, int nPatrolID, int nNodeIndex);

接口描述： 删除巡航线的巡航点

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.15 设置巡航停留时间

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_PatrolSetStay(JCLink_t nLinkID, int nChannel, int patrolID, int staySeconds);

接口描述： 设置巡航停留时间

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：

仅支持统一配置所有预置位的停留时间，单个预置位节点的停留时间只能添加预置位节点时候配置 JCSDK_PatrolAddNode

See Also：无

3.10.8.16 设置巡航速度

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_PatrolSetSpeed(JCLink_t nLinkID, int nChannel, int nPatrolID, int nSpeed);

接口描述： 设置巡航速度

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.17 调用巡航线

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_LocatePatrol(JCLink_t nLinkID, int nChannel, int nPatrolID, int nSpeed);

接口描述： 调用巡航线

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.18 停止巡航

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopPatrol(JCLink_t nLinkID, int nChannel, int nPatrolID);

接口描述： 停止巡航

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.19 获取轨迹列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetTrailList(JCLink_t nLinkID, int nChannel, JCTrailInfo_t **pstTrailList, int *pnCount);

接口描述： 获取轨迹列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：

Remarks：无

See Also：无

3.10.8.20 开始录制轨迹

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartRecordTrail(JCLink_t nLinkID, int nChannel, int nTrailid);

接口描述： 开始录制轨迹

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.21 停止录制轨迹

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopRecordTrail(JCLink_t nLinkID, int nChannel, int nTrailid);

接口描述： 停止录制轨迹

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.22 执行轨迹

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_ActionTrail(JCLink_t nLinkID, int nChannel, int nTrailid, JBOOL bEnable);

接口描述： 执行轨迹

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.23 获取守望信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetGuardCfg(JCLink_t nLinkID, int nChannel, JCGuard_t *pstGuard);

接口描述： 获取守望信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.24 配置守望参数

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetGuardCfg(JCLink_t nLinkID, int nChannel, JCGuard_t *pstGuard);

接口描述： 配置守望参数

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.25 执行守望

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_ActionGuard(JCLink_t nLinkID, int nChannel, JBOOL bEnable);

接口描述： 执行守望

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.26 暂停恢复守望

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_PauseGuard(JCLink_t nLinkID, int nChannel, JBOOL bEnable);

接口描述： 暂停恢复守望

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.27 配置当前位置为扫描边界

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetScanEdges(JCLink_t nLinkID, int nChannel, JCEdges_e eEdges);

接口描述： 配置当前位置为扫描边界

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.28 获取云台转动速度

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetPTZMoveSpeed(JCLink_t nLinkID, int nChannel, int *nMoveSpeed);

接口描述： 获取云台转动速度

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.29 开始扫描

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartEdgesScan(JCLink_t nLinkID, int nChannel, JCEdgesDir_e eDir, int nSpeed);

接口描述： 开始扫描

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.30 开始花样扫描

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartWaveScan(JCLink_t nLinkID, int nChannel, int nSpeed);

接口描述： 开始花样扫描

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.31 开始随机扫描

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StartRandomScan(JCLink_t nLinkID, int nChannel, int nSpeed);

接口描述： 开始随机扫描

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.32 停止所有扫描

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_StopScan(JCLink_t nLinkID, int nChannel);

接口描述： 停止所有扫描

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.33 获取云台定时任务列表

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetPTZTimingTaskList(JCLink_t nLinkID, int nChannel, JCPTZTimingTaskList_t *pstTaskList);

接口描述： 获取云台定时任务列表

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：

列表是预置的，当前仅支持预置的这些任务

See Also：无

3.10.8.34 获取云台定时任务信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_GetPTZTimingTask(JCLink_t nLinkID, int nChannel, JCPTZTimingTask_t **pstTasks, int *nTaskCount);

接口描述： 获取云台定时任务信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：无

Remarks：无

See Also：无

3.10.8.35 配置定时任务信息

接口声明：

JCSDK_API JBOOL JCSDK_CALLTYPE JCSDK_SetPTZTimingTask(JCLink_t nLinkID, int nChannel, JCPTZTimingTask_t *pstTask, int nTaskCount);

接口描述： 配置定时任务信息

接口参数：

返回值： GTRUE 成功，GFALSE 失败，用 JCSDK_GetLastError 获取具体错误码

专用错误码：