互动白板混流录制

2020-07-21 17:01:59 浏览数 (2)

1、开通服务

通过官网工单提交开通混流录制申请

申请模板

代码语言：javascript复制
公司名：
账号ID：
AppID：
联系人姓名： 
联系电话：
行业类型：
预计并发用户数：
预计并发房间数：
预计上线时间：

2、发起录制请求

1、文档入口

2、发起请求

代码语言：javascript复制
{
    "Action":"StartOnlineRecord",//接口名
    "AppId":******,//腾讯云账号
    "AudioFileNeeded":false,//是否需要在结果回调中返回各路流的纯音频录制文件，文件格式为mp3
   "Concat":{
        "Enabled":true
    },//实时录制视频拼接参数
    "Extras":[
        "MIX_STREAM"
    ],//MIX_STREAM - 混流功能
    "MixStream":{
        "Custom":{
            "Canvas":{
                "BackgroundColor":"#808080",
                "LayoutParams":{
                    "Height":1224,
                    "Width":1320
                }
            },
            "InputStreamList":[
                {
                    "InputStreamId":"tic_record_user",//表示当前画面用于显示白板视频流
                    "LayoutParams":{
                        "Height":960,
                        "Width":1280,
                        "X":8,
                        "Y":256,
                        "ZOrder":1
                    }
                },
                {
                    "InputStreamId":"tic_substream",//表示当前画面用于显示辅路视频流
                    "LayoutParams":{
                        "Height":960,
                        "Width":1280,
                        "X":8,
                        "Y":256,
                        "ZOrder":2
                    }
                },
                {
                    "InputStreamId":"qovrqm8lnnx7m0g",//用户ID表示当前画面用于显示指定用户的视频流
                    "LayoutParams":{
                        "Height":240,
                        "Width":320,
                        "X":8,
                        "Y":8,
                        "ZOrder":3
                    }
                }
            ]
        },
        "DisableAudio":true,//是否禁用音频混流
        "Enabled":true,//是否开启拼接功能
        "ModelId":1,//内置混流布局模板ID, 取值 [1, 2]
        "TeacherId":"qovrqm8lnnx7m0g"//老师id
    },
    //实时录制服务用户Id，格式为tic_record_user_${RoomId}_${Random}
    "RecordUserId":"tic_record_user_368693147_770430",
    //RecordUserId对应的签名
    "RecordUserSig":"eJxNjl1PgzAUhv8LtzPaUkr*************T43*XE*****5T-H*****YChVLWFCpTuoQXJtZKNLnlnlObED-yQYI9xxpBHLjuibaHkwnKiy3*nTLnjg*oZ9hDCfsg8Okp1akErLio7NAV*Hx*********C16chIZcy2PY4mWf3D4uUsdlirgu0RO3RUEi3zX61U3fppgveRLNPJhMD7zdBRbMIogwSs17Fr-K0KV6wv671x5LkOdj8UHzH1WlGxXMErJLsOJ06v39mN1-B",
    "Region":"ap-guangzhou",//地域
    "ResultDomain":"whiteboard-cam-test-1257307760.cos.ap-nanjing.myzijiebao.com",
    "RoomId":368****147,//需要录制的房间号
    "SdkAppId":1400****140,//应用账号
    "Whiteboard":{
        "Height":720,
        "Width":1280
    }
}

2、响应

代码语言：javascript复制
{
  "Response": {
    "RequestId": "eac6b301-a322-493a-8e36-83b295459397",
    "TaskId": "bj0mt2l23osdj300hl30"
  }
}

3、实时录制常见问题

1、白板支持录制吗？可以与视频/音频/音视频一起录制吗？

互动白板提供了云端实时录制功能，可以录下白板画面。同时也支持混流录制，将实时音视频与白板画面混流录制，也支持白板与音频或视频混流录制。

2、混流录制完成后回调没有混流的数据

  • 查看原始房间音视频数据是否正常，查看地址
  • 检查混流参数是否填写正确

3、自定义混流布局为什么视频会有黑边？

这里取决于LayoutParams设置的width与height两个参数，这里设置的是混流录制里视频位的宽高，如果希望录制的视频没有黑边的话，需要与原始视频流的宽高比保持一致

4、录制的文件要怎么获取？在哪里可以看到？录制文件保存多久？

需要客户设置回调地址，录制下来的文件会通过回调地址返回。默认保存3天，需要尽快自行转移保存。

5、实时录制过程中异常退出，录制会暂停吗？生成的录制结果是怎样的？

房间内5分钟没有音视频上行及白板操作，以及暂停超过30分钟会导致实时录制自动停止。

如果只是暂时停止推流，请调用暂停接口，如果录制暂停时间超过30分钟，请调用停止录制接口，在需要恢复录制的时候再次开始录制。

如果同一个录制任务生成了多个录制视频，在发起录制时设置了Enabled为true，则后台会自动进行拼接；

如果同一个房间暂停时间过长导致的重新发起录制，这时两个录制任务生成的录制视频需要用户自己采用其他工具或sdk（点播）进行视频拼接

6、使用互动白板播放视频，这个过程可以被录制下来吗？

目前不支持录制视频文件演示过程

7、发起录制失败

根据接口返回的错误码排查，常见的有数据格式与参数类型错误可对照文档校对

8、白板与音频/视频/音视频录制之后，都会混流为mp4文件吗？

是的。

9、实时录制为什么会自动结束了？

房间内5分钟没有音视频上行及白板操作，以及暂停超过30分钟会导致实时录制自动停止。如果只是暂时停止推流，请调用暂停接口，如果录制暂停时间超过30分钟，请调用停止录制接口，在需要恢复录制的时候再次开始录制

10、文档说实时录制的视频只保存三天，如何永久保存？

可以通过点播接口把将网络上的视频拉取到云点播平台把文件拉取到点播，不主动删除 就会永久保存 ，点播存储会收取一定的费用，参考点播收费文档

11、混流实时录制，可以动态修改布局吗？

可以 ，多写几个流布局备用

混流布局混流布局

12、如果老师有音视频 学生只有音频 ，那这种用混流可以成功吗？

可以，音频的布局也需要添加宽高

13、为什么视频录制文件type=2？为什么混流录制白板与视频的位置错乱？

上麦用户不要用以tic_record_user开头的用户ID，在混流的时候会被当成是白板视频；

因为混流的时候进行布局匹配的时候，是根据前缀进行匹配的，所以只要用户ID的前缀与InputStreamID相匹配，就会占用对应的布局；

4、其他问题

需要提供一下信息通过工单反馈

  • taskid
  • requestid
  • 发起录制时间

5、结尾

针对实时录制的使用和遇到的问题欢迎大家留言

互动白板 互动课堂

0 人点赞