常见问题

产品 / 插件
平台 / 框架

集成问题

Express SDK 是否支持断线重连机制?

Express 如何设置和获取 SDK 的日志、堆栈信息?

如何选择视频分辨率、帧率、码率?

Express 如何从 AppSign 鉴权升级为 Token 鉴权?

媒体音量和通话音量有什么区别?

如何防止音视频互动中的幽灵麦或炸房的现象?

如何减少集成 Native SDK 的 App 体积?

如何设置音频设备模式 ZegoAudioDeviceMode?

如何调节摄像头的焦距(变焦功能)?

如何开启耳返?

如何实现开关摄像头/视频画面/麦克风/音频/扬声器?

编译时遇到 Gradle 需要 JDK 11 的报错如何处理?

为什么在 Chrome 81 及以上版本浏览器上无法获取设备 ID?

如何交叉编译 Linux v4l-utils 依赖库?

如何使用附带 ASan 工具的 ZEGO SDK?

如何自定义视频采集旋转方式?

设置 Android minSdkVersion 为 23 后,APK 包体积增大了?

如何切换屏幕共享流和摄像头视频流?

直播场景下,如何监听远端观众角色用户登录/退出房间的事件?

为什么 iOS 或 Android 设备连接蓝牙设备后不能通过蓝牙设备通话?

ZIM SDK 是否支持断线重连机制?

在 Xcode 12.3 及之后版本中使用 iOS 模拟器构建项目为什么会失败?

如何通过自定义采集实现屏幕共享?

CocoaPods 常见问题

如何对远端用户进行上下麦/禁言/禁摄像头操作?

打包 iOS 时 Xcode 报错提示 Bitcode 版本不兼容?

Mac 端如何实现系统声卡采集?

什么是 SDK 的安装包大小增量?

如何监听房间内用户的麦克风和摄像头状态?

StorageParams 中的各个云存储相关的参数如何填写?

为什么通过系统音量无法调节背景音乐?

Express Android SDK 如何查看 API 注释和文档?

如何交叉编译 Linux alsa-lib 依赖库?

移动端如何使用 ZEGO Express Web SDK?

为什么在网页端禁用自己的视频后摄像头指示灯还亮着?

如何获取 ZIM SDK 的日志信息?

为什么有些文件会转码失败?

ZIM 的 login 接口和实时音视频 loginRoom 接口有何差异?

OBS 推流后,iOS 小程序端拉流没有声音怎么办?

ZIM 如何从 AppSign 鉴权升级为 Token 鉴权?

运行生成 Token 的 Java 源码时,如果出现 “java.security.InvalidKeyException:illegal Key Size” 异常提示,该如何处理?

如何清理缓存?

支持发送消息给自己吗?

如何将指定用户移出房间?

为什么进入课堂后无法分享或看不到别人的白板或文件?

如何处理常见的 Web 浏览器控制台报错?

iOS 12 系统真机调试的时候出现 Metal 相关的 crash 怎么解决?

为什么有些文件会转码失败?

如何处理 Windows 7 窗口共享异常?

单流和混流的录制分辨率分别在哪里设置?

Web 平台上,Express SDK 是否支持断线重连机制?

如何获取 Avatar SDK 的日志信息?

如何处理白板或文件显示不完整或留白的问题?

浏览器窗口全屏时如何让白板正常显示?

如何在服务端 API 中进行鉴权认证?

Express 如何处理 Token 相关错误码?

从 GitHub 下载 Go 课堂源码后直接运行为什么会报错?

如何使用视频大小流?

SDK 在 macOS 10.13 及以下的系统版本为什么会崩溃?

如何修改音频 3A 处理的配置?

在房间内点击离开课堂后页面未跳转怎么处理?

屏幕共享时,鼠标为什么会有重影(有两个光标显示)?

为什么设置转码清晰度后,没有立马生效,重新渲染也没有生效?

文件上传或加载失败怎么处理?

使用 Avatar SDK 后,提交自己的 App 到 App Store 中进行审核时被拒,该如何处理?

Web 端大班课,H5 端看不到教师的画面如何处理?

如何设置 Web 平台互动白板 SDK、文件转码 SDK 的环境?

为什么各端看到的白板或者文件内容不同步?

编译 Roomkit 源码时,遇到 "No version of NDK..." 错误如何处理?

如何解决 macOS 权限问题?

超级白板 SDK 是否支持快捷键操作?

云录制结束后,没有在云存储中看到录制的文件,该怎么处理?

如何通过白板来加载文件?

升级 Express v2.20.0 或以上版本后编译报错?

Express 如何设置镜像模式?

客户端集成了 Express SDK,是否需要维护房间?

小程序推流时,如何设置横屏?

为什么 Web 平台在 Windows 设备上使用手写板时无法在白板上进行绘制?

如何设置超级白板日志?

在单流录制过程中,为什么白板文件设置的 StreamType 不生效?

使用互动白板前需要做些什么?

Express 从 2.8.0 之前的版本升级以后,Xcode 编译报错如何处理?

如何搭配使用互动白板 SDK 和 实时音视频 SDK?

如何获取 Avatar SDK 的堆栈信息?

为什么点击动态 PPT 文件页面不能进行翻页?

白板创建成功后,调用翻页接口不生效?

如何搭配使用超级白板 SDK 和 实时音视频 SDK?

浏览器窗口全屏时如何让白板正常显示?

如何解决 Web 平台互动白板 SDK 登录失败的问题?

为什么指定了 StreamId,但自定义布局不生效?

Qt 的枚举窗口和 SDK 内的窗口枚举有什么对应关系?

Web 平台上,Express 如何在通话中切换音视频输入设备?

录制过程中,房间内的白板不需要录制了,要如何操作?

混流的 MixInputList 参数,如果 ViewType 设为 2,StreamId 需要如何设置?

混流时开启音浪功能,使用 Safari 浏览器播放视频出现卡顿现象,如何处理?

文件共享 SDK 的 token 是否和互动白板 SDK 的 token 通用?

上传文件失败怎么处理?

为什么区域采集设置失效?

如何解决 macOS 窗口相关问题?

在 Windows 平台上集成 Express uni-app SDK 后,使用 dev 证书云打包运行 iOS 应用时出错,该如何处理?

Express 如何创建房间?

如何处理文件共享 SDK 所有接口均异常的问题?

双方连麦成功后,如果一方由于关机退出程序(或者杀进程)停止推流,拉流方需多久能收到流删除消息?

为什么设置转码清晰度后,没有立马生效,重新渲染也没有生效?

如何获取 ZegoEffects SDK 的日志信息?

集成 RoomKit iOS SDK 打包时报错:“Failed to verify bitcode in xxx.framework/xxx” 如何处理?

如何处理超级白板 SDK 所有接口均异常的问题?

开始进行屏幕分享报错 “onScreenCaptureError 3” 怎么处理?

如何添加白板工具?

运行 App 时提示:“Building for iOS Simulator...” 如何处理?

Express SDK 登录房间的时候,为什么会报错:1002001?

摄像头支持的情况下,预览设置 1920 * 1080,但实际推流只有 640 * 480,该如何处理?

Web 平台上,RoomKit 大班课,作为学生加入时看不到教师的画面如何处理?

如何处理集成 Express SDK 时的相关问题?

使用 ZIM SDK,在 Flutter 框架下打包 release 版本的 Android apk 包,在真机设备上安装后,无法请求网络,该怎么处理?

如何获取、上传音频的 Dump 文件?

如何获取 Roomkit SDK 日志?

在加载动态 PPT 文件后,点击动态 PPT 无法翻页,该如何处理?

Express 各平台 SDK 互通时,userID/roomID/streamID 是否有什么限制?

Web 平台创建流时出现 “devices detect error: NotReadableError Could not start video source” 错误?

动态 PPT 内的动画点击无反应,该如何处理?

一个用户最多支持同时拉取几条流 ?

推流时,调用 “enableTrafficControl” 方法开启流控后,网络质量比较差时,为什么仅主路流会触发流控策略?

Web 平台如何实现从 CDN 拉流?

动态转码出现某些字体错位,或大小不一致的情况,如何处理?

在 iOS 应用开发中,出现卡顿、设备发热、内存占用过多等的问题,该如何分析?

将流转推到 CDN 过程中,连接断开后如何处理?

Web 平台上,Express 如何设置镜像模式?

Web 平台如何实现对预览、拉流画面进行截图?

使用 “switchRoom” 切换房间的时候,为什么报错:1000002-没有登录房间?

Web 平台上,当设置的视频分辨率“宽”大于“高”时,PC 端和移动端分别怎么展示?

如何设置文件/白板的日志?

Web 平台如何获取 CDN 的拉流地址?

如何获取 ZIM SDK 的堆栈信息?

为什么有些文件转码后的字体在多端显示会不一致?

macOS Monterey(12.2.1) 及以上版本运行 electron 应用导致摄像头等设备不能使用或者 crash?

调用 createEngine 接口创建引擎时,如果将房间场景设置为 “语音通话/语聊房/KTV” 等场景时,还需要主动调用 “enableCamera” 接口关闭摄像头吗?

如何获取 ZegoEffects SDK 的堆栈信息?

在需频繁切换房间的场景,拉流端画面渲染的速度比较慢,如何进行优化?

在 Android 平台开发中,出现 CPU 占用率过高、设备发热的问题该如何分析?

Web 平台屏幕分享,如何将系统声音和麦克风声音分享出去?

Express SDK 发送实时消息后,为什么收不到回调?

Web 平台从 CDN 拉流,使用 flv 格式播放,为什么暂停后、再播放会导致延迟累积呢?

在 uni-app 平台上,本地预览、拉流,均无画面显示,该如何处理?

Web 平台通过 “createStream” 方法创建了流,并已给 video 对象的 “srcObject” 赋值,为什么 video 对象没有画面?

客户端在线鉴权,通过 URL 地址访问 ZegoEffects 服务端时,为什么有时会出现失败?

Web 平台报错 “https or localhost required”,是否必须要求 “https”?

小程序如何直推 CDN?

Web 端如何实现自动播放?

混流时开启了音浪功能,使用 “flv.js” 拉流播放在部分浏览器上会黑屏?

Web 平台如何推纯音频的流?

为什么 Web 平台在 Windows 设备上使用手写板时无法在白板上进行绘制?

调用编译打包后 Roomkit SDK 的接口时报错怎么处理?

Web 平台调用 createStream 方法创建流,参数 “audioInput” 和 “videoInput” 可以传空串吗?

使用 “uni-app” 框架,拉流的时候 “playerStateUpdate” 显示拉流成功,但是使用 “srcObject” 无法渲染出画面?

ZIM 默认多长时间发送一次心跳?超过多长时间没有收到用户心跳时,后台会判断为超时?

使用 CDN 录制时,当推流端出现断流的情况下,会生成多个录制文件,如何将这些录制文件进行合并呢?

Express SDK 退出房间,是否需要主动停止推拉流?

使用外部采集时,是否支持推送携带透明通道的 PNG 图片?

Web 平台 “playQualityUpdate” 中有音频码率,但拉流成功后有画面没有声音,是什么原因?

Web 平台如何设置预览和拉流的镜像?

Web 端推流时,报错:“code: 1103065, msg: Not Readable Error: device is not readable”,该如何处理?

动态 PPT 转码完成后部分动画与源文件有差异,该如何处理?

如何获取 MetaWorld SDK 的日志信息?

ZIM SDK 中的 onConnectionStateChanged 回调与 onRoomStateChanged 回调的区别是什么?分别在什么情况下触发?

Express SDK 如何将 SDK 日志打印到控制台?

不同用户之间如何传递混流流名信息?

为什么“后台回调-录制文件生成回调”会回调两次? 并且两次回调的视频内容都是一样的?

Web 平台只预览推流,没有拉流时存在杂音/啸叫声,如何处理?

在 Windows 应用开发中,出现 CPU 占用高、内存泄漏等的问题,该如何分析?

文件转码加载文件失败,返回 60018 错误码是什么原因?

如何将媒体播放器播放文件的声音混入推流中?

Express 推流是否支持设置密钥,需要使用对应密钥才能拉流?

使用 Express SDK,小程序作为推流端时,拉流端如何获取麦克风、摄像头的状态变化?

当 Windows 端的白板遮挡住用户的模态对话框后,用户的程序无法点击时该如何处理?

Web 平台登录房间报错:"content":"cmd=login, err_code=1000000101, err_message=login liveroom request fail", 或者 "content":"server error=1000000101",原因是什么?

Web 平台登录房间时提示报错:“cmd=login, err_code=1011, err_message=token format error”?

文件转码加载文件失败,返回 2030004 错误码是什么原因?

Web 平台拉流时候报错:“Player already exist!” 是什么原因?

Unity SDK 将图像渲染到网格上时,为什么 shader 选择 “Universal Render Pipeline > Lit” 可以渲染成功,选择 “Universal Render Pipeline > Unlit” 则无法渲染?

如何减少 Express SDK 在 Web 控制台打印的信息?

Web 平台使用 “https” 上线,但 SDK 返回的 flv 拉流地址是 “http” 的,无法兼容,如何解决?

如何指定 StreamID 进行云端录制?

调用 “enablePublishDirectToCDN” 直推 CDN,停止推流后,是否需要再将 “enablePublishDirectToCDN” 重新设置成 “false”?

PPT 转码完成后会出现文字丢失,该如何处理?

服务端的“流创建”和“流关闭”回调通知,能否保证是有序的?

Android 平台下初始化白板 SDK 时报错:Didn't find class "com.zego.edu.logger.ZegoEduLogger"?

多次上传文件时,为什么会返回相同的 fileID?

在 Web 平台上,进行屏幕分享过程中,点击 “停止共享”按钮,会有回调信息吗?

用户通过 ZIM SDK 接口,修改自己的名称、头像、个人信息扩展字段后,如何查询修改后的信息?

Web 平台 SDK 推流报错 “stream not from zego”,该如何处理?

使用实时音视频(ZEGO Express SDK)的“实时消息与信令”功能,是否支持查询历史消息?

如何处理开播失败?

提示“模型在下载,请稍微再开播”,超过30分钟,无法进入控制台页面,应该如何处理?

在 Web 平台上,如何禁止麦克风/摄像头的访问权限弹框?

通过 ZIM 服务端 “查询用户在线状态” 接口返回 660200001 错误码,该如何处理?

如何获取离线推送 PushID?

使用 Express SDK 时,如果不同的客户端使用同一个userID 登录房间,会出现什么问题?

Xcode Archive 时提示 “Undefined symbols for architecture armv7: "_OBJC_CLASS_$_ZegoProduct"”,该如何处理?

ZIM SDK 为什么没办法查到房间历史消息?

微信视频号直播工具提示“开启识别失败”,该如何处理?

Express SDK 有哪些 Token 鉴权方式,该如何使用?

使用浏览器推第三方视频流,推流/预览正常,但拉流时画面黑屏,该如何处理?

使用 “muteMicrophone”、“enableAudioCaptureDevice” 接口时,将参数设置为 false,两者有什么区别?

Express 的服务端有创建房间、登录房间的 API 吗?

怎么设置产品对应的素材,实现数智人介绍不同产品时,切换至对应的素材图片?

使用 ZegoEffects 时,如何解决服务端错误“No valid license”(无法拿到证书)?

启用瘦脸效果后,当屏幕上用户人脸靠近边缘会导致四周有黑块,应该如何处理?

客户端在线鉴权时,如何处理通过 URL 地址访问 ZegoEffects 服务端失败?

如何处理拿到证书但美颜没效果?

如何处理调用 ZegoEffects SDK 接口导致崩溃的问题?

为什么美颜设置滤镜后,看不出效果?

在 RTC 的自定义前处理功能中使用 ZegoEffects 功能时,预览和推流出现黑屏,如何处理?

如何处理调用 processImageBuffer 后导致的黑屏?

更新 ZIM SDK 版本后,需要重新打基座吗?

使用 ZIM SDK 时,解散了群组,还能用这个群组的 GroupID 重新创建群组吗?

产品咨询

ZEGO Express Web SDK 支持哪些浏览器?

ZEGO 提供哪些解决方案?

超级白板和互动白板和文件共享是什么关系?

ZEGO 和其他 RTMP + CDN 直播技术有什么区别?

什么是 Token?如何生成 Token?如何使用 Token?

在录制过程中,如果音视频流退出房间再重进,会是什么表现?

即时通信 IM 支持海外接入吗?

开始录制后,如果房间内新增了流,这个新增的流会被录制吗?

云端录制服务器出现断网、异常崩溃时,会如何处理?

ZEGO 云通讯 SDK 支持哪些平台,各平台对系统版本的要求是什么?

ZEGO Express SDK 是否支持拉 60 帧的流?

支持录制 IM 信息吗?

ZIM 房间内是否包含实时音视频流?

自定义信令是否有发送频率限制?

自定义布局、水平布局、平分布局、垂直布局、悬浮布局都支持指定白板的位置吗?

ZEGO 的音频处理有哪些特点?

如何回放超过 4 条流?录制超过 4 条流会如何表现?

第三方云存储参数(StorageParams)支持传入临时授权的 Token 吗?

用户程序崩溃对云录制会有什么影响?

录制 PPT 时,能隐藏 PPT Notes 吗?

互动白板 SDK 是否支持快捷键操作?

混流录制指定画面我们可以指定老师端或学生端的共享 PPT 吗?

什么是自定义图形?

支持录制动态 PPT 吗?

互动白板的生命周期是什么样的?

超级白板 SDK 支持的文件是否有大小、格式限制?

混流录制自定义布局下,如果 mix_input_list 只有一个布局,可以录制多条流么?

畅直播和原有的超低延时直播、CDN 直播的关系?

当开启了白板录制,但房间内过了一段时间才新增白板,白板如何录制?

为什么 PPT 内嵌的音频文件,无法暂停和拖动进度条?

互动白板 SDK 与 文件共享 SDK 的关系是什么?

为什么在转码后的动态 PPT 文件页面上点击鼠标右键不会弹出菜单?

一个房间内最多可创建多少个白板?

录制视频里可以同时展示两个白板窗口么?

超级白板的生命周期是什么样的?

支持的文件是否有大小、格式限制?

超级白板是否支持音视频文件共享?

超级白板是否区分老师、学生等角色?

RoomKit 创建项目时要选择的各个使用场景有什么区别?

文件上传转码和下载观看耗费的流量如何计算?

文件转码支持哪些格式?

什么是自定义图形?

文件是否有大小限制?

Express Web SDK 支持哪些浏览器?

如何获取 SDK 的版本号?

互动白板是否区分老师、学生等角色?

使用 OBS、小程序平台推流时,能否在 “星图 > 通话洞察” 中查到推拉流记录?

多房间功能是否需要特殊配置?

在每个房间,通话中是否有管理员?

如何配置域名 CNAME?

如果用户同时在实时音视频和即时通讯的房间里,需要离开房间时,应该先调用 Express SDK 的 “logoutRoom” 接口,还是 ZIM SDK 的 “leaveRoom” 接口呢?

如何添加白板工具?

文件转码是否支持音视频文件共享?

如何进行域名归属权认证?

ZIM 体验版套餐内,默认同一个 AppID 下最多可创建 20 个房间,如果创建 5 个后再销毁 5 个,此时还能再创建几个?

文件转码加载文件的超时时间是多久?

云端录制什么时候会收到回调通知?

RoomKit 小班课场景中,学生端是否支持 H5?

实时互动数智人产品交付物包括哪些?

ZIM 的 Google 离线推送是否可以用在国内环境?

软硬一体版本(极速版)可以只购买软件吗?

若想要数智人在回答的时,尽量在已设置的知识库里回答,该如何设置?

在互动问答过程中,问题没问完数智人就开始回答,该如何调整?

数智人可以回答英文问题吗?

除了点击屏幕按钮外,还提供哪些交互方式?可以用唤醒词提问吗?

如何避免数智人每次回复时,都先说“您好”、“您的问题非常好,我需要想一想。”,该如何将提示语删除?

不想每次提问都重新唤醒数智人,该如何实现?

在数智人回答用户问题时,如何给用户推荐和当前问题相关的其他问题?

用户与数智人对话时,若很久没有提问,如何让数智人提醒用户?

如何在互动数智人界面添加自己业务的跳转链接?

其他问题

如何理解和使用 SEI(媒体补充增强信息)?

WebRTC 已知问题及规避方案?

如何处理使用 OBS 推流,SDK 拉流时出现画面卡顿或音画不同步的问题?

如何处理 macOS 系统上 App Nap(App 小憩)的问题?

什么时候使用自定义消息?

如何定义 streamID 比较合适?

如何根据场景选择语音检测的不同接口?

如何使用位掩码?

如何限制只有好友之间才能互发消息?

如何设置消息的优先级更为合理?

IM 如何销毁房间?

一个用户是否可以加入多个房间?

在房间里时,按Home键回到桌面后,点击应用图标回到应用,为什么没有回到房间?

为什么 Android 9 应用锁屏或切后台后采集音视频无效?

拉流时如何静音某条流或者全部流?

iOS 设备屏幕分享时系统崩溃是什么原因?

推流正常时,只有 Android 平台能使用微信浏览器正常拉流,iOS 平台无法拉流,但 “playQualityUpdate” 回调中有数据?

在 Web 平台上部署服务器时,必须使用 HTTPS 协议吗?

“后台回调-流创建回调”里面的 “pic_url” 可用于鉴黄,“pic_url” 能否配置 ssl?

Express SDK 如何监听房间内谁在说话?

两条流混流时,若其中一条流断开了,混流是否会自动停止?

Web 平台推流时,如何只提供音频权限?

调用 “房间用户踢出接口”,踢出一个不存在的用户,是否会报错?

在纯音频场景下,混流想要显示背景图,该如何操作?

使用服务端混流 API,开始混流接口中的 “seq” 值有什么作用?

网络环境差时,Express SDK 会强行让用户自动退出房间吗?

使用云端录制时,房间内只有两个真实用户,但 onRoomOnlineUserCountUpdate 回调却显示有三个用户?

白板是否支持按轨迹擦除内容?

后台流创建与流关闭回调返回的数据,为什么使用 “Form” 格式处理时无效?

对配置较低的机型设备,如何选择采集配置、编码分辨率,才能降低性能开销?

使用泛域名申请了 SSL 证书,为什么在 ZEGO 控制台上传证书时,提示当前上传的证书与域名不匹配?