You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Agora云录制Composite模式:发起者音视频未被录制的解决求助

解决Agora云录制Composite模式下发起者UID未被包含在合屏的问题

针对你遇到的发起请求的UID(123)未出现在合屏MP4中的问题,可按以下步骤排查解决:

  • 确认发起者已成功发布音视频流
    Web端用户必须成功调用publish方法并触发stream-published事件,才能被云录制服务识别。同时检查设备状态:确保摄像头未被占用、麦克风未静音,且浏览器已授予音视频权限。

  • 移除订阅组参数或确保UID在目标组内
    当前配置中subscribeUidGroup:1的优先级高于subscribeVideoUids/subscribeAudioUids。如果频道内用户未设置分组,或该UID不属于组1,就会被过滤。
    解决方式二选一:

    1. 删除subscribeUidGroup参数,让订阅UID列表生效;
    2. 在客户端加入频道时为该UID设置uidGroup:1,确保其属于目标分组。
  • 明确指定订阅的UID列表
    即使设置了maxResolutionUid,也需在subscribeVideoUids和subscribeAudioUids中明确添加该UID,同时避免与subscribeUidGroup冲突。修改后的配置示例:

    "recordingConfig": {
        "channelType": 0,
        "streamTypes": 2,
        "audioProfile": 1,
        "videoStreamType": 0,
        "maxIdleTime": 120,
        "transcodingConfig": {
            "width": 1920,
            "height": 1080,
            "fps": 30,
            "bitrate": 3150,
            "maxResolutionUid": "123",
            "mixedVideoLayout": 0
        },
        "subscribeVideoUids": ["123"],
        "subscribeAudioUids": ["123"]
    }
    
  • 保证UID格式全一致
    顶层请求的uid、transcodingConfig中的maxResolutionUid、订阅列表中的UID必须格式统一(全为字符串或全为数字)。Web端使用字符串UID时,所有配置项都要保持字符串格式。

  • 测试不同合屏布局
    当前使用的mixedVideoLayout:0是悬浮布局,若频道内有多个用户,可能因布局逻辑导致该UID未显示。可临时切换为网格布局(mixedVideoLayout:1)测试,确认该UID的流是否能被正常录制。

内容的提问来源于stack exchange,提问作者Rytis Jokubas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.02 13:32:35