网络摄像头
功能介绍
将 RTMP、RTSP 等网络视频流作为一路“摄像头”接入,与本地摄像头一样可设为默认或多路发送、被远端订阅观看。适用于接入监控、推流等网络视频源。
1. 添加网络摄像头
调用 addIPCam(url, jsonParam) 添加一路网络摄像头。
-
url:网络流地址,支持协议:rtmp、rtsp。
-
jsonParam:可选 JSON 参数,例如:
- name:摄像头名称,不配置则使用 url。
- maxRetry:连接失败或中断时的重试次数,<0 表示无限重试,默认 -1。
-
返回值:≥0 表示成功,返回值为 videoID(视频设备 ID);<0 表示失败,参见 CRVSDK_ERR_DEF。
-
数量:最多支持添加5个;添加的摄像头在 CRVideoSDKMain 销毁时被删除。
-
识别:通过 getAllVideoInfo 可获取本端视频设备列表,其中设备类型可区分网络摄像头。
示例:
const char* url = "rtsp://192.168.1.100:554/stream1";
const char* jsonParam = R"({"name":"前台监控","maxRetry":-1})";
int videoID = meeting.addIPCam(url, jsonParam);
if (videoID >= 0)
{
// 可设为默认视频设备或加入 setMutiVideos 多路发送
}
相关 API 请参考:
2. 删除网络摄像头
调用 delIPCam(videoID) 删除指定网络摄像头。
相关 API 请参考:
3. 使用方式
- 添加成功后与本地视频设备处理一致:可 setDefaultVideo 设为默认视频设备,或通过 setMutiVideos 作为多路之一发送,远端通过 addCanvas / addCustomRender 按 videoID 订阅观看。
- 若需从网络摄像头获取音频并作为自定义音频源,可在 自定义音频采集 的 param 中配置 fromIPCam 为对应视频设备 ID,由 SDK 自动从该 IPCam 拉取音频。