文档反馈
文档反馈
互动直播2.0 > 进阶功能 > 媒体流管理 > 旁路推流画面布局

旁路推流画面布局

在配置旁路推流任务时，您可以自定义频道画面的视频布局，本文档为您介绍视频布局的设置方式和推荐设置。

功能简介

网易云信互动直播产品提供简单易用的互动直播功能，当您通过各端SDK实现音视频通话后，可以将频道画面进行旁路推流和录制，即将实时音视频流转为标准直播流，进行互动直播。首先在云端进行混流、转码、编码等操作，然后生成旁路转推的视频流，并推送到视频直播中进行大规模下行加速的直播观看。如果您开通了点播服务，也可以将直播内容录制并保存到点播服务中，随时观看回放。

设置旁路推流任务时，可以自定义频道画面的各路视频布局方式，例如调整画布（Canvas）大小和颜色、各路视频的图像大小、位置等。

限制说明

画面布局设置方式

您可以通过客户端 API 接口或服务端 API 接口设置旁路推流热舞的画面布局，通常为 layout 请求参数。详细的接口参数信息请查看对应端的 API 接口文档。

画面布局设置示例

本文档以服务端 API 创建推流任务为例，为您展示通过服务端 API 接口 layout 参数设置旁路推流画面布局的方式。

请求示例

在本示例中，音视频房间中有两位主播/连麦者，其推流画面布局为横向左右均分布局，原始画布为深灰色，其中一人掉线后显示占位图片。

{
    "taskId" : "stream_1",  
    "streamUrl": "rtmp://test.url",  
    "layout":{
        "canvas": {
             "width": 720,
             "height": 640,
             "color": 16777215
                },
        "users": [{
            "uid": 66601,
            "x": 0,
            "y": 0,
            "width": 360,
            "height": 640,
            "adaption": 1,
            "pushAudio": true,
            "pushVideo": true
        },
         {
            "uid": 66602,
            "x": 360,
            "y": 0,
            "width": 360,
            "height": 640,
            "adaption": 1,
            "pushAudio": true,
            "pushVideo": true
        }
    ],
         "images": [{
            "url": "www.163.com/test.jpg",
            "x": 360,
            "y": 0,
            "width": 360,
            "height": 640,
            "adaption": 1
        }]
},                  
    "record":true,                   
    "version": 1                     
}

效果展示

常用布局设置

互动直播支持自定义配置视频布局，您也可以参考以下典型的常用布局配置，优化您的自定义布局。

双人横向平铺

{
    "canvas": {
        "width": 640,
        "height": 360,
        "color": 16777215
    },
    "users": [{
            "uid": 66601,
            "x": 0,
            "y": 0,
            "width": 320,
            "height": 360
        },
        {
            "uid": 66602,
            "x": 320,
            "y": 0,
            "width": 320,
            "height": 360
        }
    ],
    "images": [{
        "url": "www.163.com/test.jpg",
        "x": 360,
        "y": 0,
        "width": 360,
        "height": 640,
        "adaption": 1
    }]
}

三人纵向平铺

{
    "canvas": {
        "width": 360,
        "height": 640,
        "color": 16777215
    },
    "users": [{
            "uid": 123,
            "x": 0,
            "y": 0,
            "width": 360,
            "height": 640
        },
        {
            "uid": 456,
            "x": 0,
            "y": 320,
            "width": 180,
            "height": 320
        },
        {
            "uid": 789,
            "x": 180,
            "y": 320,
            "width": 180,
            "height": 320
        }
    ],
    "images": [{
        "url": "www.163.com/test.jpg",
        "x": 360,
        "y": 0,
        "width": 360,
        "height": 640,
        "adaption": 1
    }]
}

1 + N 悬浮布局

相关文档

相关产品

×

反馈成功

非常感谢您的反馈，我们会继续努力做得更好。
确定