Loading...

    拉流以及布局

    功能说明

    通过参会者事件回调开发者可获取到参会者信息，根据参会者信息可通过平台拉取音视频流。平台默认返回20路以内的音视频流，如需获取更多，可通过获取指定roster信息，然后进行拉流。将拉流的数据结合布局策略开发者可自由定义多种布局。

    在SDK3.3.1最新版本新增了全量ROSTER功能，SDK上报会中全量ROSTER，最大支持500人。

    核心功能

    1. 获取参会者信息

    2. 视频流控制

    3. 布局管理

    4. 参会者管理

    使用流程

    基础拉流流程

    1. 入会成功后接收 OnRosterInfo 回调
    2. 使用 GetVideoElement 获取视频控件
    3. 使用 SetCustomLayout 设置布局
    4. 接收 OnVideoStreams 获取视频流

    全量ROSTER使用流程

    1. 在后台打开全量ROSTER开关
    2. 正常登录并入会
    3. 接收 OnBulkRosterInfo 获取全量ROSTER
    4. 使用 SubscribeRoster 订阅ROSTER
    5. 接收 OnRosterInfo 获取详细信息
    6. 使用 SetCustomLayout 设置布局
    7. 接收 OnVideoStreams 获取视频流

    1080P拉流示例

    使用 SetCustomLayout 设置1080P参数时，需注意：

    • width和height参数仅代表最大拉流分辨率
    • 实际分辨率受发送端能力、接收端能力及带宽等因素影响

    示例代码

    // 指定大画面
    [FocusVideoStream](/common/meeting/api/stream_and_layout?platform=windows#eHblR)(uint participantId);

    // 开启自定义布局
    [EnableCustomLayout](/common/meeting/api/stream_and_layout?platform=windows#wpIdk)(bool enabled);

    // 设置自定义布局
    [SetCustomLayout](/common/meeting/api/stream_and_layout?platform=windows#wvQSC)([SDKCustomLayoutInfo](/common/meeting/api/class_and_enum?platform=windows#niPQ3) param);

    // 订阅ROSTER信息
    [SubscribeRoster](/common/meeting/api/stream_and_layout?platform=windows#mNoxj)([SDKConfDevInfo](/common/meeting/api/class_and_enum?platform=windows#SDDev)[] devList);

    // 请求指定Roster信息
    [RequestRoster](/common/meeting/api/stream_and_layout?platform=windows#HokbN)(int startIndex, int length);

    // 设置视频控件背景色
    [SetVideoBkColor](/common/meeting/api/stream_and_layout?platform=windows#PupNf)(byte r, byte g, byte b);

    // 获取视频控件
    [GetVideoElement](/common/meeting/api/stream_and_layout?platform=windows#RGj9z)(string videoSourceId);

    // 获取摄像头视频控件
    [GetVideoElement4Camera](/common/meeting/api/stream_and_layout?platform=windows#hbwuF)([SDKCameraOrdinal](/common/meeting/api/class_and_enum?platform=windows#RPXEV) ordinal);

    相关接口

    更多接口请查阅API概览中的拉流&布局部分。

    2025-04-25 19:58:34
    导出PDF文档
    意见反馈