#ifndef __APPWRAPPER_H_ #define __APPWRAPPER_H_ #ifdef __cplusplus extern "C" { #endif #include #include #include #ifdef WINDOWS #ifdef IPCLIBRARY_EXPORTS # define IPCLIBRARY_API __declspec(dllexport) #else # define IPCLIBRARY_API __declspec(dllimport) #endif #else # define IPCLIBRARY_API #endif #define MAX_SIZE_OF_PARAMS 3000 static const char * VIDEOSDKVERSION = "2.4.x+git.2a469eda"; typedef enum { XP2P_PROTOCOL_AUTO = 0, //auto模式，udp不通自动切换tcp XP2P_PROTOCOL_UDP = 1, //udp传输 XP2P_PROTOCOL_TCP = 2, //tcp传输 } XP2PProtocolType; typedef enum { XP2PTypeClose = 1000, //数据传输完成 XP2PTypeLog = 1001, //日志输出 XP2PTypeCmd = 1002, // command json XP2PTypeDisconnect = 1003, // p2p链路断开 XP2PTypeDetectReady = 1004, // p2p链路初始化成功 XP2PTypeDetectError = 1005, // p2p链路初始化失败 XP2PTypeDeviceMsgArrived = 1006, // 设备端向App发消息 XP2PTypeCmdNOReturn = 1007, // 设备未返回app自定义信令 XP2PTypeStreamEnd = 1008, // 设备停止推流，或者由于达到设备最大连接数，拒绝推流 XP2PTypeDownloadEnd = 1009, // 设备停止推流，下载结束 XP2PTypeStreamRefush = 1010, // 设备拒绝推流，请求的devicename不一致 XP2PTypeSaveFileOn = 8000, //获取保存音视频流开关状态 XP2PTypeSaveFileUrl = 8001 //获取音视频流保存路径 } XP2PType; typedef enum { XP2PVoiceServiceClose = 2000, //语音对讲服务关闭 XP2PStreamServiceClose = 2001 //音视频流接收服务关闭 } XP2PCloseSubType; typedef enum { XP2P_ERR_NONE = 0, //成功 XP2P_ERR_INIT_PRM = -1000, //入参为空 XP2P_ERR_GET_XP2PINFO = -1001, // SDK内部请求xp2p info失败 XP2P_ERR_PROXY_INIT = -1002, //本地p2p代理初始化失败 XP2P_ERR_UNINIT = -1003, //数据接收/发送服务未初始化 XP2P_ERR_ENCRYPT = -1004, //数据加密失败 XP2P_ERR_TIMEOUT = -1005, //请求超时 XP2P_ERR_REQUEST_FAIL = -1006, //请求错误 XP2P_ERR_VERSION = -1007, //设备版本过低，请升级设备固件 XP2P_ERR_APPLICATION = -1008, // application初始化失败 XP2P_ERR_REQUEST = -1009, // request初始化失败 XP2P_ERR_DETECT_NOTREADY = -1010, // p2p探测未完成 XP2P_ERR_P2P_ININED = -1011, //当前id对应的p2p已完成初始化 XP2P_ERR_P2P_UNININ = -1012, //当前id对应的p2p未初始化 XP2P_ERR_NEW_MEMERY = -1013, //内存申请失败 XP2P_ERR_XP2PINFO_RULE = -1014, //获取到的xp2p info格式错误 XP2P_ERR_XP2PINFO_DECRYPT = -1015, //获取到的xp2p info解码失败 XP2P_ERR_PROXY_LISTEN = -1016, //本地代理监听端口失败 XP2P_ERR_CLOUD_EMPTY = -1017, //云端返回空数据 XP2P_ERR_JSON_PARSE = -1018, // json解析失败 XP2P_ERR_SERVICE_NOTRUN = -1019, //当前id对应的服务(语音、直播等服务)没有在运行 XP2P_ERR_CLIENT_NULL = -1020 //从map中取出的client为空 } XP2PErrCode; typedef struct data_report_t { unsigned char* report_buf; size_t report_size; uint64_t live_size; // uint64_t voice_size; const char *data_action; const char *status; const char *uniqueId; const char *appPeerName; const char *deviceP2PInfo; uint64_t appUpByte; uint64_t appDownByte; const char *appConnectIp; int errorcode; } data_report_t; typedef struct app_config_t { const char *server; const char *ip; uint64_t port; XP2PProtocolType type; bool cross; } app_config_t; typedef const char *(*msg_handle_t)(const char *id, XP2PType type, const char *msg); typedef void (*av_recv_handle_t)(const char *id, uint8_t *recv_buf, size_t recv_len); typedef char *(*device_data_recv_handle_t)(const char *id, uint8_t *recv_buf, size_t recv_len); typedef void (*av_log_handle_t)(const char *id, data_report_t data_buf); /** * @brief 设置回调函数 * * @param recv_handle: 音视频数据回调 * @param msg_handle: 控制类消息回调 * @param device_data_handle: 设备端向App发送消息的回调 * @return 无返回值 */ IPCLIBRARY_API void setUserCallbackToXp2p(av_recv_handle_t recv_handle, msg_handle_t msg_handle, device_data_recv_handle_t device_data_handle); /** * @brief 发送信令消息给camera设备并等待回复，同步阻塞方式 * * @param id: 目标camera在app端的唯一标识符 * @param command: * 可以为任意格式字符或二进制数据，长度由cmd_len提供，建议在16KB以内，否则会影响实时性 * @param cmd_len: command长度 * @param recv_buf: * 用于存放camera回复的数据，内存由接口内部申请外部释放，实际数据长度根据recv_len获取 * @param recv_len: camera回复的数据长度 * @param timeout_us: 命令超时时间，单位为微秒，值为0时采用默认超时(7500ms左右) * @return 0 为成功 */ IPCLIBRARY_API int postCommandRequestSync(const char *id, const unsigned char *command, size_t cmd_len, unsigned char **recv_buf, size_t *recv_len, uint64_t timeout_us); /** * @brief 发送信令消息给camera设备，camera回复的数据由注册的回调函数返回，异步非阻塞方式 * * @param id: 目标camera在app端的唯一标识符 * @param command: * 可以为任意格式字符或二进制数据，长度由cmd_len提供，建议在16KB以内，否则会影响实时性 * @param cmd_len: command长度 * @return 0 为成功 */ IPCLIBRARY_API int postCommandRequestWithAsync(const char *id, const unsigned char *command, size_t cmd_len); /** * @brief 向camera设备请求媒体流，异步回调方式 * * @param id: 目标camera在app端的唯一标识符 * @param params: 直播(`action=live`)或回放(`action=playback`)参数 * @param crypto: 是否开启传输层加密，如果关闭(crypto=false)，则建议用户在应用层加密，否则有安全风险 * @return 请求句柄 */ IPCLIBRARY_API void *startAvRecvService(const char *id, const char *params, bool crypto); /** * @brief 关闭媒体流传输 * * @param id: 目标camera在app端的唯一标识符 * @param req: 接口`startAvRecvService`的返回值，当前版本可传入null * @return 0 为成功 */ IPCLIBRARY_API int stopAvRecvService(const char *id, void *req); /** * @brief 初始化xp2p服务 * * @param id: 目标camera在app端的唯一标识符 * @param product_id: 产品ID * @param device_name: 设备名称 * @param sensor_timeout: 探测失败切换tcp的超时时间 * @return 0 为成功 */ IPCLIBRARY_API int startService(const char *id, const char *product_id, const char *device_name, app_config_t config); /** * @brief 初始化xp2p服务 * * @param id: 目标camera在app端的唯一标识符 * @param product_id: 产品ID * @param device_name: 设备名称 * @param remote_host: 局域网设备ip * @param remote_port: 局域网设备端口 * @return 0 为成功 */ IPCLIBRARY_API int startLanService(const char *id, const char *product_id, const char *device_name, const char *remote_host, const char *remote_port); /** * 延迟设置xp2pinfo,节省start时间 */ IPCLIBRARY_API int setDeviceXp2pInfo(const char *id, const char *xp2p_info); /** * @brief 获取本地代理url * * @param id: 目标camera在app端的唯一标识符 * @return 本地代理url */ IPCLIBRARY_API const char *delegateHttpFlv(const char *id); /** * @brief 获取局域网url * * @param id: 目标camera在app端的唯一标识符 * @return 局域网url */ IPCLIBRARY_API const char *getLanUrl(const char *id); /** * @brief 获取局域网url * * @param id: 目标camera在app端的唯一标识符 * @return 局域网本地代理端口号 */ IPCLIBRARY_API int getLanProxyPort(const char *id); /** * @brief 启动向camera设备发送语音或自定义数据服务，异步非阻塞方式 * * @param id: 目标camera在app端的唯一标识符 * @param params: 请求参数采用 key1=value&key2=value2 * 格式，key不允许以下划线_开头，且key和value中间不能包含&/+=特殊字符 * @param crypto: 是否开启传输层加密，如果关闭(crypto=false)，则建议用户在应用层加密，否则有安全风险 * @return 请求句柄 */ IPCLIBRARY_API void *runSendService(const char *id, const char *params, bool crypto); /** * @brief 关闭语音发送传输 * * @param id: 目标camera在app端的唯一标识符 * @param req: 接口`runSendService`的返回值，当前版本可传入null * @return 请求句柄 */ IPCLIBRARY_API int stopSendService(const char *id, void *req); /** * @brief 设置云api信息，若不用sdk获取xp2p信息，该接口可不用设置 * * @param sec_id: 云API secrct_id * @param sec_key: 云API secrct_key * @return 0 为成功 */ IPCLIBRARY_API int setQcloudApiCred(const char *sec_id, const char *sec_key); /** * @brief 向camera设备发送语音或自定义数据 * * @param id: 目标camera在app端的唯一标识符 * @param data: 要发送的数据内容 * @param len: 要发送的数据长度 * @return 0 为成功 */ IPCLIBRARY_API int dataSend(const char *id, uint8_t *data, size_t len); /** * @brief 停止xp2p服务 * * @param id: 目标camera在app端的唯一标识符 * @return 0 为成功 */ IPCLIBRARY_API void stopService(const char *id); /** * @brief 日志开关 * * @param console: 是否输出日志到控制台 * @param file: 是否输出日志到文件 */ IPCLIBRARY_API void setLogEnable(bool console, bool file); /*================================废弃接口=======================================*/ /** * @brief 发送信令消息给camera设备并等待回复，同步阻塞方式 * * @param id: 目标camera在app端的唯一标识符 * @param command: 字符格式命令 * @param buf: 用于存放camera回复的数据，内存由接口内部申请外部释放，实际数据长度根据len获取 * @param len: camera回复的数据长度 * @param timeout_us: 命令超时时间，单位为微秒，值为0时采用默认超时(7500ms左右) * @return 0 为成功 */ IPCLIBRARY_API int getCommandRequestWithSync(const char *id, const char *command, char **buf, size_t *len, uint64_t timeout_us); /** * @brief 发送信令消息给camera设备，camera回复的数据由注册的回调函数返回，异步非阻塞方式 * * @param id:目标camera在app端的唯一标识符 * @param command:字符格式命令 * @return 0 为成功 */ IPCLIBRARY_API int getCommandRequestWithAsync(const char *id, const char *command); /** * @brief 获取当前发送链路的连接模式：0 无效；62 直连；63 转发 * * @param id:目标camera在app端的唯一标识符 * @param command:字符格式命令 * @return 0 为成功 */ IPCLIBRARY_API int getStreamLinkMode(const char *id); /** * @brief 调试接口，便于通过播放器请求httpflv时，保存拉取的原始流数据就行分析 * @param id:目标camera在app端的唯一标识符 */ IPCLIBRARY_API void startRecordPlayerStream(const char *id); /** * @brief 获取发送对讲流缓存大小，可根据此接口判断 当发现p2p的水线超过一定值时，降低视频码率。送入体积较大的I帧、网络波动等都会影响水位值 * @param id:目标camera在app端的唯一标识符 */ IPCLIBRARY_API size_t getStreamBufSize(const char *id); IPCLIBRARY_API void setStunServerToXp2p(const char *server, uint16_t port); IPCLIBRARY_API void setContentDetail(const char *content, const char *detail, av_log_handle_t reportdata_handle); IPCLIBRARY_API const char* getUserID(); /** * @brief 是否走双中转开关 */ IPCLIBRARY_API void setCrossStunTurn(bool enable); #ifdef __cplusplus } #endif #endif