数据结构体定义

CRNetworkProxy

{"type":1,"addr":"192.168.0.2","port":8080}

CRSDKCreateParams SDK创建扩展参数

CRLoginDat 登录数据

CRMeetInfo 房间信息

CRDevJoinCfg 设备入会配置

  {"devInfo":{"autoOpenMic":0,"userID":"123456","nickname":"xxx","videoSize":"1280*720","videoSize2":"228*160"}}

devInfo参数说明

CRUserStatus 用户在线状态信息

CRQueInfo 队列信息

CRQueUserInfo 排队用户信息

CRQueStatus 队列状态

CRQueuingInfo 我的排队信息

CRTransReqInfo 文件传输请求信息

CRFileTransInfo 文件传输状态信息

CRMeetingMember 房间成员信息

CRAudioDevInfo 音频设备信息

CRVideoDevInfo 视频设备信息

CRUserVideoID 用户视频ID

CRAudioCfg 音频配置

CRVideoCfg 视频配置

maxbps 与 qp 之间的关系说明：

• SDK默认使用min_qp(最佳qp）编码视频；
• 当SDK检测到视频流发不动时，会逐步降低qp值直到max_qp(最差qp)，以便减少带宽需求提升流畅度；
• 当SDK检测到网络变好时，会逐步恢复qp值直到min_qp(最佳qp）；
• maxbps为视频流的最大码率，当qp值与maxbps冲突时（以当前qp编码的码率将突破maxbps），以maxbps为准；

CRAudioFrame 音频帧数据

CRVideoFrame 图像帧数据

getRawDatPtr使用举例：

获取rgb格式如下：
uint8_t* pRGBDat[1];
int      linesize[1];
getRawDatPtr(&pRGBDat, &linesize, 1);

获取yuv420p格式如下：
uint8_t* yuv[3];
int      linesize[3];
getRawDatPtr(yuv, linesize, 3);

CREncPacket 编码数据

CRScreenCaptureSourceInfo 屏幕共享采集源信息

CRScreenShareCfg 屏幕共享配置参数

屏幕共享场景：传入正确的monitorID， 不传catchWnd、catchRect；
窗口共享场景：传入正确的catchWnd， 不传monitorID、catchRect；
区域共享场景：传入正确的catchRect， 不传monitorID、catchWnd；
monitorID、catchWnd、catchRect传入多值时，将共享交集内容；

CRScreenShareInfo 屏幕共享状态信息

CRMediaInfo 影音共享状态信息

CRVStreamInfo 图像流信息

CRNetStateInfo 网络状态信息

CRCanvas SDK内部渲染对象

CRCustomRenderHandler 自渲染对象

CRVideoAttributesObj 视频设备私有属性

//只开大流，清晰度为720p
{ "size":"1280*720", "fps":15, "maxbps":1000000 }
//开启大小流，大流720p， 小流160p
{ "size":"1280*720", "fps":15, "maxbps":1000000, "quality2":{"size":"228*160", "maxbps":120000} }

CRVideoEffectsObj 视频效果参数

 {"denoise":1,"mirror":1}

CRLocMixerCfgObj 本地混图器规格配置

 {"width":640,"height":360,"frameRate":8,"bitRate":500000,"defaultQP":28,"gop":120}

CRMixerContentObj 混图器内容

{"type":0,"keepAspectRatio":1,"left":5,"top":10, "width":633,"height":356,"param":{"camid":"usr1.1"}}

type描述：

• 当type=CRVSDK_MIXCONT_VIDEO时，表示混图的是视频，param必须包含camid；
• 当type=CRVSDK_MIXCONT_PIC时，表示混图的是指定的图片，param必须包含resourceid；（仅用于本地混图）
• 当type=CRVSDK_MIXCONT_SCREEN时，表示混图的是本地屏幕，param可以增加附加参数screenid/pid/area/window；（仅用于本地混图）
• 当type=CRVSDK_MIXCONT_MEDIA时，表示混图的是影音共享，不用附加任何参数；
• 当type=CRVSDK_MIXCONT_SCREEN_SHARED时，表示混图的是共享的屏幕，不用附加任何参数；
• 当type=CRVSDK_MIXCONT_WBOARD时，表示混图的是白板，不用附加任何参数；（仅用于云端混图，本地混图应该生成图像用MIXVTP_PIC)
• 当type=CRVSDK_MIXCONT_TEXT时，表示混图的是文本，width和height将被忽略，元素大小由文本信息自动确定。 param必须包含text，可选text-color，bk-color，font-size，text-margin；

param 支持的参数如下：

• camid：用户id.视频设备id, 如："testuser.1"。 视频设备id可以为-1，代表此用户的默认视频设备
• resourceid：具有唯一属性的字符串id，通过setPicResource将图片存储到SDK内供混图模块使用
• screenid：屏幕序号，-1表示主屏
• pid：进程号
• area：抓屏区域:"x,y,w,h"
• text：文本内容，支持时间戳参数"%timestamp%"，格式为：YYYY-MM-DD HH:MM:SS
• text-color：文本颜色，支持格式："#RGB","#RRGGBB", "#AARRGGBB"， 默认"#FFFFFF"
• bk-color：背景色，支持格式："#RGB","#RRGGBB", "#AARRGGBB"， 默认"#7D000000"
• font-size：字体大小，默认18
• text-margin：边距，默认5

CRLocMixerOutputObj 本地混图器输出配置

  输出到文件配置：{"type":0,"filename":"D:/1.mp4"}
  直播推流配置：{"type":1,"liveUrl":"rtmp://xxx"}

当输出到文件时，参数如下：

当输出推流时，参数如下：

CRLocMixerOutputInfoObj 本地混图器输出信息

{ "state":2, "duration":100,"fileSize":10000 }

CRCloudMixerCfgObj 云端混图器配置

为房间中所有人录制独立的声音文件，独立的默认视频流文件

{
    "mode": 1,
    "audioFileCfg": {
        "svrPathName": "/2021-09-24/会议号/$UID$_$TIME$.mp3",
        "subscribeAudios": ["_cr_all_"]
    },
    "videoFileCfg": {
        "aStreamType": 1,
        "svrPathName": "/2021-09-24/会议号/$UID$_cam$CAMID$_$TIME$.mp4",
        "subscribeVideos": ["_cr_allDefCam_"]
    }
}

录制一个2分屏左右布局图像+房间声音的mp4文件

{
    "mode": 0,
    "videoFileCfg": {
        "svrPathName": "/2021-09-24/2021-09-24_13-47-41_Win32_73542046.mp4",
        "vWidth": 1280,
        "vHeight": 720,
        "vFps": 15,
        "layoutConfig": [
            {
                "type": 0,
                "top": 180,
                "left": 0,
                "width": 640,
                "height": 360,
                "keepAspectRatio": 1,
                "param": {"camid": "1.-1"}
            },
            {
                "type": 0,
                "top": 180,
                "left": 640,
                "width": 640,
                "height": 360,
                "keepAspectRatio": 1,
                "param": {"camid": "2.-1"}
            }
        ]
    }
}

CRCloudMixerAudioFileCfg 云端录制语音文件配置

1. 单流模式参数：

2. 合流模式参数：

CRCloudMixerVideoFileCfg 云端录制视频文件配置

1. 单流模式参数：

CRStreamPushCfg结构说明：

说明:
录制时：svrPathName、subscribeVideos必传，aStreamType可选；
推流时：pushCfg必传，aStreamType可选；

2. 合流模式参数：

CRCloudStorageConfig 云端录制存储配置

CRCloudMixerInfoList 云端混图器信息列表

list<CRCloudMixerInfo>

CRCloudMixerInfo 云端混图器信息

CRCloudRecordFileInfo 云端录制文件信息

CRCloudMixerEventInfoObj 云端混图器事件信息

CRMeetingAttrOptions 操作房间属性选项

CRAttrObjs 房间属性集

{
    "KeyXX": {
        "value": "11111",
        "lastModifyUserID": "111",
        "lastModifyTs": 11111
    },
    "KeyYY": {
        "value": "22222",
        "lastModifyUserID": "222",
        "lastModifyTs": 22222
    }
}

CRUsrAttrObjs 用户属性集

 {
    "userid1": {
        "KeyXX": {
            "value": "11111",
            "lastModifyUserID": "111",
            "lastModifyTs": 11111
        },
        "KeyYY": {
            "value": "22222",
            "lastModifyUserID": "222",
            "lastModifyTs": 22222
        }
    },
    "userid2": {
        "KeyXX": {
            "value": "11111",
            "lastModifyUserID": "111",
            "lastModifyTs": 11111
        },
        "KeyYY": {
            "value": "22222",
            "lastModifyUserID": "222",
            "lastModifyTs": 22222
        }
    }
}

CRScreenMarkData 屏幕共享标注数据

CRCustomEncParams 创建自定义编码器参数

CRCustomDecParams 创建自定义解码器参数

CRCustomEncRslt 自定义编解码结果

CRSize 尺寸

CRBeautyCfg 美颜配置

CRBeautyFilter 美颜滤镜配置

CRVirtualBkCfg 虚拟背景配置

  {"type":1, "colorKey":"0,255,0", "bkImgFile":"d:\\imgs\\1.jpg"}

• 补充说明:

1. bkImgFile, bkImgFromResID, bkImgFromCamID 三个必须传一个，传多个时按顺序启用前者。