newConsumer

简要描述

• 用户进入房间以后， 信令服务器会下发房间现有用户/新进房间用户的订阅信息给当前用户
• 用户收到newConsumer消息以后，通过服务器下发的rtpParameters进行pc->setRemoteDescription以及pc->CreateAnswer操作与远端用户进行sdp交换
• 以上操作均成功以后，会生成mediasoupclient::Consumer 对象，程序将这个对象指针保存起来用于后续对其管理操作。

请求方式

• Websocket.Send

参数

[通用协议部分点击这里查看](https://www.showdoc.com.cn/1591639269927039/7912937086999827 "通用协议部分点击这里查看")

参数名	必选	类型	说明
rtpParameters.codecs	是	{}	新的订阅数据所使用的编码信息
rtpParameters.headerExtensions	是	{}	新的订阅数据所使用的标头信息
rtpParameters.encodings	是	{}	新的订阅数据所使用的分层传输信息
rtpParameters.rtcp	是	{}	新的订阅数据所使用的实时传输控制协议信息
rtpParameters.mid	是	int	新的订阅数据所使用的分层传输ID
type	是	string	新的订阅用户类型
appData	是	{}	新的订阅用户信息
producerPaused	是	bool	订阅数据是否已被暂停

请求示例

{
    "data": {
        "appData": {
            "peerId": "qprlm6yu"
        },
        "id": "8791fce3-31e6-4e89-89af-2da8ee91120c",
        "kind": "audio",
        "peerId": "qprlm6yu",
        "producerId": "4ee7126d-e653-4210-839e-15bdd113d5cc",
        "producerPaused": false,
        "rtpParameters": {
            "codecs": [
                {
                    "channels": 2,
                    "clockRate": 48000,
                    "mimeType": "audio/opus",
                    "parameters": {
                        "minptime": 10,
                        "sprop-stereo": 1,
                        "usedtx": 1,
                        "useinbandfec": 1
                    },
                    "payloadType": 100,
                    "rtcpFeedback": []
                }
            ],
            "encodings": [
                {
                    "ssrc": 947885922
                }
            ],
            "headerExtensions": [
                {
                    "encrypt": false,
                    "id": 1,
                    "parameters": {},
                    "uri": "urn:ietf:params:rtp-hdrext:sdes:mid"
                },
                {
                    "encrypt": false,
                    "id": 4,
                    "parameters": {},
                    "uri": "http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time"
                },
                {
                    "encrypt": false,
                    "id": 10,
                    "parameters": {},
                    "uri": "urn:ietf:params:rtp-hdrext:ssrc-audio-level"
                }
            ],
            "mid": "0",
            "rtcp": {
                "cname": "DfVaONMTIVyQ3fx4",
                "mux": true,
                "reducedSize": true
            }
        },
        "type": "simple"
    },
    "id": 6161510,
    "method": "newConsumer",
    "peerId": "adfaa0af-0504-4050-9298-644e455f7053",
    "request": true,
    "roomId": "c09a36b8-4ac3-43fa-b6f1-da5d1c659c20"
}

返回示例

{
    "data": null,
    "id": 1383697,
    "ok": true,
    "response": true
}

返回参数说明

参数名	类型	说明

(空消息体)

备注

• 注意, 该通知消息比较特殊, 前端必须作出回复, 否则服务器会因流程走不通挂掉.

• 更多返回错误代码请看首页的错误代码描述