TgCloudConst.h

浏览该文件的文档.

/**
 * @file TgCloudConst.h
 * @brief 探鸽云SDK常数定义
 */
 
#ifndef __TgCloudConst_h__
#define __TgCloudConst_h__
 
#include "ec_const.h"
 
/** \defgroup api_const API用到的常数和枚举
 * @{*/
 
/** @defgroup status_code TciCB::on_status()回调状态码
 * @{
 * \name TciCB::on_status()回调状态码
 * @{
 */
#define STATUS_LOGON         1 ///< 设备上线. data: NULL.
#define STATUS_LOGOFF        2 ///< 设备下线. data: NULL.
#define STATUS_DELETED       3 ///< 设备被删除. data: NULL.
#define STATUS_UPDATE_SERVICE 4 ///< 更新云服务. data: TCISERVICEINFO *; len: sizeof(TCISERVICEINFO)
#define STATUS_AP_CONNECT    5  ///< 用户通过ap直连. data:NULL
#define STATUS_STREAMING     6  ///< 用户打开实时视频. data: int(number of clients); len:0
#define STATUS_START_TELNETD 7  ///< 请求开启telnetd服务(用于调试). data:NULL
#define STATUS_SDER          8  ///< 服务器定义事件上传(server defined event record). data: @ref SDER. Return: 0(ok), -1(错误, 无文件等)
/** 设备休眠查询.
  - \c data: NULL
  - \c len: 
        - \c >0:  设备可以进入休眠时，应用在此回调里做清理动作，并与唤醒服务器建立。当这些动作完成后，再返回0
        - \c ==0: sdk已经下线，设备要立即下电
 
  本状态当 \c len!=0 时, 要求应用返回一个值。
    - 返回值大于0时，sdk会在返回值(秒)后再次查询.
    - 返回值<0时，sdk不会再触发本查询
    - 返回值=0时，sdk执行内部的清理过程。清理完成后会以 `len=0` 再触发一次本事件. 此时设备应给主控下电, 系统进入休眠状态
*/
#define STATUS_IDLE          9  
#define STATUS_AI            10 ///< 服务器端AI检测到正的结果. data: struct AiResult *
#define STATUS_SWD_TIMEOUT   11 ///< soft watchdog timeout. data: name
//#define STATUS_ERROR_SERVICE 10 ///< 服务器或外部网络错
#define STATUS_USER_DATA     12 ///< 用户数据. data: @ref TgUserData *; len: TgUserData结构长度
 
/** 有用户呼入. 
 * - \c data: struct InCallInfo *
 * - \c len:  data指向的空间的长度
 *
 * 固件判断当前是否正在通话或正在呼叫，是则要调用 `TciRejectInCall(data)`拒绝呼入, \n
 * 否则要显示一个界面展示是谁呼叫，并给用户决定是否接听。
 *   - 调用 `TciAcceptInCall(roomid)`接听
 *   - 调用`TciRejectInCall(roomid)`拒接。
 
   应用不能阻塞`on_status`调用。返回`0`时，SDK会释放`data`指向的空间。所以如果应用 \n
   弹出了待接界面，在回调里要保存 `data`指针并返回`1`.
 */
#define STATUS_INCALL         13
 
/** 实时传输监控.
 * - \c data: int *, 目前内容为发送缓冲区占用百分比. 如果以后扩展，len值会变化. \n
 *            占比为100%时，表示出现丢帧. >0时，表示当前占比相对之前在增加，小于0时，相比上一次统计在减少.
 * - \c len: sizeof(int)
 */
#define STATUS_TRANSFER_MONITOR 14
 
#define STATUS_RESOLVE_FAILED 21  ///< 域名解析错
 
#define STATUS_WRITE_BACKSTORE 22
 
/** 长连接状态.
 * - \c data: 
 *   - \c NULL: 连接断开
 *   - \c non-NULL: 连接建立
 */
#define STATUS_WS_CONNECTION   23
 
/** 获取取注册信息
 * - \c data: 注册信息
 * - \c len:  长度
 */
#define STATUS_GOT_REGINFO        24
/**@}*/ //name: Status Code
/**@}*/ //group status_code
 
/** @name Wifi 配置获取方式
 * @{ */
#define GWM_QRCODE        0x1 ///<二维码
#define GWM_AP            0x2 ///<AP或蓝牙模式
/**@}@}*/
 
/** @anchor pic_type*/
/** @name 图片类别指示
 * @{ */
#define PIC_USE_THUMBNAIL   0 ///<缩略图。大小不超过320*240
#define PIC_USE_AI_BD       1 ///<人形检测。图片大小约640*352
#define PIC_USE_AI_FD       2 ///<人脸检测
#define PIC_HIGH_RES        3 ///<高清晰度
/**@}*/
 
/** 呼叫者类型 */
typedef enum {
    CALLER_TANGE,  ///< 探鸽
    CALLER_WEIXIN  ///< 微信小程序
} ECALLERTYPE;
 
/**@}*///api_const
 
/** \addtogroup api_structure
 * @{*/
/** 呼叫者信息. 除 type/user_id/nickname 外，其它域对应用是透明的 */
struct InCallInfo {
    int  type;      ///< 呼叫者类型。 @ref ECALLERTYPE
    char *user_id;  ///< 呼叫者ID, 可为NULL
    char *nickname; ///< 呼叫者昵称, 可为NULL
 
    //以下数据在SDK内部使用并可能变化，应用不要访问
    union {
        char *roomid;   // 微信呼叫房间号
        struct {
            int sub_type;
            void *ptr;
        } tg;
    };
    char data[1];
};
/**@}*/
 
/** \addtogroup api_const
 * @{*/
 
/** 插入到媒体流(实时或回放)或命令通道中的消息类型.
 * - 插入命令流的是通知类信息，用TciSendRtMsg()发送一个 RTMSG_t 结构
 * - 插入媒体流的信息用于辅助描述流相关的事件或提供额外信息, 调用 TciSendLiveMessage() 或 TciSendPbMessage(),
 *   发送的是 RTMSGHEAD_t 结构
 * 有的消息是设备SDK自动插入，设备应用层不要主动发送.
 */
typedef enum {
    /** 回放: 时间同步帧, 用于告诉播放器下一帧发生时的的UTC时间. 在时间戳中断时（例如自动跳到下一个文件）发送
     *  - data2 = 下一帧发生时的UTC时间;
     *  - data1 = 时间的毫秒部分;
     *  - extra_len = 0;
     *  SDK 提供辅助宏 @ref TciSendPbSyncFrame() 来发送这个帧
     */
    RTM_SYNCTIME = 0,
 
    /** 实时流: 多目摄像机在变焦过程中发生镜头切换，在切换完成后、新镜头的第一个I帧前发送此标志 
     *  - data1 = 视频通道号; 
     *  - data2 = 码流编号;
     *  - extra_len = 0;
     *
     *  \n使用辅助宏 @ref TciSendLiveMsg_LensSwitch() （或旧的 TciSendLensSwitchFlag()）发送
     */
    RTM_LENS_SWITCH = 1,
 
    /** 回放: 同 @ref RTM_SYNCTIME, 但在响应 @ref TCI_CMD_RECORD_PLAYCONTROL 命令发生跳转的第一帧前发送
     *  - data1 = 0; 
     *  - data2 = 下一帧发生时的UTC时间;
     *  - extra_len = 0;
     */
    RTM_SYNCTIME_RESPONSE_TO_USER = 2,
 
    /** 实时: 到达预置位. 
     * 响应APP调用预置位命令, 在转到预置位置时在实时流中发送.用于通知APP更新预置位图片。 \n
     * 当App端没有预置位缩略图时(分享、换手机、第三方设置了预置位等)，依赖此特性自动更新。
     * - data1: 视频通道号(或摄像头索引)
     * - data2: 预置位编号(>0)
     * - extra_len: 0
     * \n使用辅助宏 @ref TciSendLiveMsg_ReachPsp()  来发送这个消息
     */
    RTM_REACH_PSP = 3,
 
    /** 回放: 缩时录像回放启停标志.
     * 在sd卡回放时进入和退出缩时录像发送此标志。
     * - data1: 1:缩时录像回放开始; 0:缩时录像回放结束
     * - data2: 0 或 倍速
     * - extra_len: 0
     * \n使用辅助宏 @ref TciSendPbTimelapseFlag() 发送本消息
     */
    RTM_TIME_LAPSED = 4,
 
    /** 呼叫结束.
     * 呼叫事件在设备端超时，或者接听者挂断，向所有(别的)连接发送此通知. \n
     * 内部事件。目前在实时流里发送
     * - data1: 状态 @ref ECALLSTATE
     * - data2: 0
     * - extra_len: 0
     */
    RTM_UPDATE_CALL_STATE = 5,
 
    /** 实时或命令: 设备休眠通知, APP收到命令后要退出实时视频 
     * - data1: 0
     * - data2: 0
     * - extra_len: 0
     */
    RTM_GOINGTO_SLEEP = 6,
 
    /** 回放: 事件结束标志
     * 事件(单文件)(参见 @ref TCIC_RECORD_PLAY_START)回放模式下，当事件(文件)播放结束时发送此标志。
     * 支持单文件模式时必需发送
     * - data1: 0
     * - data2: 0
     * - extra_len: 0
     * \n使用辅助宏 @ref TciSendPbEndOfEvent() 发送本消息
     */
    RTM_END_OF_EVENT = 7,
 
    /** 命令: 取消呼叫小程序. 这个是发给转发服务器的内部消息 */
    RTM_CANCEL_CALL = 8,
 
    /** 用户自定义的消息 */
    RTM_USER = 255
} RTMTYPE;
/**@}*/ //group: api_const
 
/** \addtogroup api_structure
 * @{*/
 
/** 服务端定义的事件上报(Server Defined Event Report), 在 on_status() 回调里通过 STATUS_SDER 通知 */
typedef struct SDER {
    char event[16]; ///< 事件名。这个值传给 TciUduBegin2() 的evt参数
    time_t t_start; ///< 录像开始时间
    int tLen;       ///< 录像长度
    int need_image; ///< 1:上传图片和视频; 2:仅上传图片
} SDER;
 
/** 用户自定义数据通知. 
 * 用户自定义数据通过STATUS_USER_DATA 在本结构中传递给应用
 */
typedef struct TgUserData {
    unsigned char *data;  ///< 用户数据
    int len;              ///< 用户数据长度
    const char *id;       ///< 请求标识
    unsigned char *resp;  ///< 应用返回的数据. 目前忽略
    int resp_len;         ///< 返回数据长度
} TgUserData;
 
/** 在媒体流中插入的 消息/数据帧 帧头 (for App Developer).
 * 本结构与 @ref FRAMEINFO_t 一样有相同的长度，并用 codec_id来区分结构体内容；extra_len 为结构后的数据长度。 \n
 * 插放器遇到不能识别的 codec_id 时，可以跳过本结构和后面的 extra_len 字节。 \n
 * 设备端调用 TciSendLiveMessage() 或 TciSendPbMessage() 分别在实时流或回放流中插入消息
 */
typedef struct RTMSGHEAD_t
{
    unsigned short codec_id;    ///< 0: 标志本结构
    unsigned short type;        ///< 消息类型。 @ref RTMTYPE
 
    unsigned int data1;         ///< 消息类型相关数据1
 
    unsigned int extra_len; ///< Size of frame
 
    unsigned int data2;         ///< 消息类型相关数据2
} RTMSGHEAD_t;
 
/**@}*/ //addtogroup api_struct
 
/** \defgroup error_code 错误码
 * @{
 * \name 错误码
 * @{*/
 
#define TCE_OK               0     ///< 成功
#define TCE_GENERIC_ERROR    -1    ///< 一般性错误
 
/*一般性错误*/
#define TCE_INVALID_PARAMETER  -10001001  ///<输入参数错
#define TCE_INVALID_UUID       -10001002  ///<无效UUID
#define TCE_INVALID_AI_UUID    -10001003  ///<无效AI UUID
#define TCE_NOT_ALLOWED        -10001004  ///<操作不允许
#define TCE_IN_PROCESSING      -10001005  ///<操作进行中,不要重复启动
 
/*服务器错误*/
#define TCE_SERVER_FAILURE     -10002001  ///<服务器错误
#define TCE_SERVER_IS_DOWN     -10002002  ///<服务器没有运行
 
/*用户错误*/
#define TCE_ALGRTHM_DISABLED   -10003001  ///<算法没有开启
#define TCE_BUFFER_TOO_SMALL   -10003002  ///<缓冲区太小
 
/*其它*/
#define TCE_NETWORK_BUSY       -10004001  ///<网络拥堵
#define TCE_MD_NOT_MATCH       -10004002  ///<下载文件内容校验失败
#define TCE_SERVICE_UNVAILABLE -10004003  ///<服务不可用
#define TCE_INCALL_HAS_GONE    -10004004  ///<呼入已经无效
#define TCE_LACK_OF_RESOURCE   -10004005  ///<资源(内存)不足
/**@}*/
/**@}*///error_code
 
 
#endif