音视频通话

自定义视频采集

功能介绍

本节介绍自定义摄像头:

  • 自定义采集:不采用 SDK 内置的摄像头/桌面/网络源,由应用自己采集视频帧并送入 SDK,作为一路“视频”发送(如第三方采集、滤镜后数据、文件推流等)。

自定义采集

通过创建“自定义摄像头”设备,再向 SDK 送入图像帧,即可实现自定义采集。

创建与销毁

  • 调用 createCustomVideoDev(camName, pixFmt, width, height, extParams) 创建自定义摄像头。
  • 返回值:≥0 表示成功,返回值为 videoID;<0 表示失败。最多支持添加5个;在 SDK 销毁时被删除。
  • 调用 destroyCustomVideoDev(videoID) 删除自定义摄像头。

送入数据

  • 创建成功后,调用 inputCustomVideoDat(videoID, frm) 将采集到的数据 NSData 送入 SDK。格式、宽高需与创建时一致;推荐像素格式为 YUV420P 以获较好性能。

示例(逻辑示意):

RTCMeeting *meeting = [RTCMeeting shareInstance];

// 创建自定义视频设备
int videoID = [meeting createCustomVideoDev:@"我的采集" 
                                     pixFmt:CRVSDK_VFMT_YUV420P 
                                      width:640 
                                     height:480 
                                  extParams:@""];
if (videoID >= 0) {
    NSLog(@"自定义视频设备创建成功,设备ID: %d", videoID);
    
    // 准备视频帧数据(YUV420P 格式,640x480)
    NSData *yuvData = ...; // YUV420P 数据,大小 = width * height * 3 / 2
    int timestamp = 0;     // 时间戳(毫秒)
    
    // 输入自定义视频数据
    [meeting inputCustomVideoDat:videoID data:yuvData timeStamp:timestamp];
}

// 不再使用时销毁设备
[meeting destroyCustomVideoDev:videoID];

相关 API 请参考:

自定义摄像头会出现在 getAllVideoInfo 中,可 setDefaultVideo 使用。