常见问题
在这里，您可以查询不同产品、不同平台或框架的常见问题。
集成问题
Express SDK 是否支持断线重连机制？
Express 如何设置和获取 SDK 的日志、堆栈信息？
如何选择视频分辨率、帧率、码率？
Express 如何从 AppSign 鉴权升级为 Token 鉴权？
媒体音量和通话音量有什么区别？
CocoaPods 常见问题
如何设置音频设备模式 ZegoAudioDeviceMode？
如何防止音视频互动中的幽灵麦或炸房的现象？
如何开启耳返？
设置 Android minSdkVersion 为 23 后，APK 包体积增大了？
如何使用附带 ASan 工具的 ZEGO SDK？
如何减少集成 Native SDK 的 App 体积？
如何交叉编译 Linux v4l-utils 依赖库？
如何实现开关摄像头/视频画面/麦克风/音频/扬声器？
如何通过自定义采集实现屏幕共享？
如何自定义视频采集旋转方式？
在 iOS 应用开发中，出现卡顿、设备发热、内存占用过多等的问题，该如何分析？
为什么在 Chrome 81 及以上版本浏览器上无法获取设备 ID？
如何交叉编译 Linux alsa-lib 依赖库？
ZIM SDK 是否支持断线重连机制？
什么是 SDK 的安装包大小增量？
为什么 iOS 或 Android 设备连接蓝牙设备后不能通过蓝牙设备通话？
Mac 端如何实现系统声卡采集？
如何切换屏幕共享流和摄像头视频流？
为什么有些文件会转码失败？
直播场景下，如何监听远端观众角色用户登录/退出房间的事件？
OBS 推流后，iOS 小程序端拉流没有声音怎么办？
打包 iOS 时 Xcode 报错提示 Bitcode 版本不兼容？
Express Android SDK 如何查看 API 注释和文档？
如何监听房间内用户的麦克风和摄像头状态？
如何获取 ZIM SDK 的日志信息？
StorageParams 中的各个云存储相关的参数如何填写？
在 Android 平台开发中，出现 CPU 占用率过高、设备发热的问题该如何分析？
在 Windows 应用开发中，出现 CPU 占用高、内存泄漏等的问题，该如何分析？
如何对远端用户进行上下麦/禁言/禁摄像头操作？
运行生成 Token 的 Java 源码时，如果出现 "java.security.InvalidKeyException
Key Size" 异常提示，该如何处理？移动端如何使用 ZEGO Express Web SDK？
在 Xcode 12.3 及之后版本中使用 iOS 模拟器构建项目为什么会失败？
ZIM 如何从 AppSign 鉴权升级为 Token 鉴权？
小程序推流时，如何设置横屏？
为什么在网页端禁用自己的视频后摄像头指示灯还亮着？
为什么通过系统音量无法调节背景音乐？
如何解决 macOS 权限问题？
如何修改音频 3A 处理的配置？
为什么有些文件会转码失败？
Express 如何处理 Token 相关错误码？
如何处理常见的 Web 浏览器控制台报错？
支持发送消息给自己吗？
Web 平台上，Express SDK 是否支持断线重连机制？
云录制结束后，没有在云存储中看到录制的文件，该怎么处理？
文件上传或加载失败怎么处理？
如何获取、上传音频的 Dump 文件？
如何解决 macOS 窗口相关问题?
如何使用视频大小流？
客户端集成了 Express SDK，是否需要维护房间？
iOS 12 系统真机调试的时候出现 Metal 相关的 crash 怎么解决？
浏览器窗口全屏时如何让白板正常显示?
为什么点击动态 PPT 文件页面不能进行翻页？
如何处理白板或文件显示不完整或留白的问题？
屏幕共享时，鼠标为什么会有重影（有两个光标显示）？
使用 ZIM SDK，在 Flutter 框架下打包 release 版本的 Android apk 包，在真机设备上安装后，无法请求网络，该怎么处理？
混流时开启音浪功能，使用 Safari 浏览器播放视频出现卡顿现象，如何处理？
使用浏览器推第三方视频流，推流/预览正常，但拉流时画面黑屏，该如何处理？
Express 从 2.8.0 之前的版本升级以后，Xcode 编译报错如何处理？
Xcode Archive 时提示 "Undefined symbols for architecture armv7: "OBJC_CLASS$_ZegoProduct""，该如何处理？
在 Windows 平台上集成 Express uni-app SDK 后，使用 dev 证书云打包运行 iOS 应用时出错，该如何处理？
如何清理缓存？
如何将指定用户移出房间？
如何处理 Windows 7 窗口共享异常？
SDK 在 macOS 10.13 及以下的系统版本为什么会崩溃？
Express SDK 登录房间的时候，为什么会报错：1002001？
为什么各端看到的白板或者文件内容不同步？
如何处理集成 Express SDK 时的相关问题？
如何获取 ZegoEffects SDK 的日志信息？
单流和混流的录制分辨率分别在哪里设置？
如何通过白板来加载文件？
为什么设置转码清晰度后，没有立马生效，重新渲染也没有生效？
升级 Express v2.20.0 或以上版本后编译报错？
摄像头支持的情况下，预览设置 1920 * 1080，但实际推流只有 640 * 480，该如何处理？
如何设置 Web 平台互动白板 SDK、文件转码 SDK 的环境？
Web 平台上，Express 如何在通话中切换音视频输入设备？
双方连麦成功后，如果一方由于关机退出程序（或者杀进程）停止推流，拉流方需多久能收到流删除消息？
Express 如何设置镜像模式？
从 GitHub 下载 Go 课堂源码后直接运行为什么会报错？
在房间内点击离开课堂后页面未跳转怎么处理？
在单流录制过程中，为什么白板文件设置的 StreamType 不生效？
如何搭配使用互动白板 SDK 和 实时音视频 SDK？
Web 平台创建流时出现 "devices detect error: NotReadableError Could not start video source" 错误？
如何在服务端 API 中进行鉴权认证?
Web 端如何实现自动播放？
集成 RoomKit iOS SDK 打包时报错："Failed to verify bitcode in xxx.framework/xxx" 如何处理？
Qt 的枚举窗口和 SDK 内的窗口枚举有什么对应关系？
macOS Monterey(12.2.1) 及以上版本运行 electron 应用导致摄像头等设备不能使用或者 crash？
为什么有些文件转码后的字体在多端显示会不一致？
上传文件失败怎么处理？
Web 端大班课，H5 端看不到教师的画面如何处理？
为什么 Web 平台在 Windows 设备上使用手写板时无法在白板上进行绘制？
一个用户最多支持同时拉取几条流 ？
如何解决 Web 平台互动白板 SDK 登录失败的问题？
为什么区域采集设置失效？
如何获取 ZIM SDK 的堆栈信息？
白板创建成功后，调用翻页接口不生效？
在 uni-app 平台上，本地预览、拉流，均无画面显示，该如何处理？
为什么指定了 StreamId，但自定义布局不生效？
录制过程中，房间内的白板不需要录制了，要如何操作？
运行 App 时提示："Building for iOS Simulator..." 如何处理？
超级白板 SDK 是否支持快捷键操作？
如何设置超级白板日志？
如何调节摄像头的焦距（变焦功能）？
Web 平台如何实现从 CDN 拉流？
如何处理文件共享 SDK 所有接口均异常的问题？
混流的 MixInputList 参数，如果 ViewType 设为 2，StreamId 需要如何设置？
编译 Roomkit 源码时，遇到 "No version of NDK..." 错误如何处理?
使用互动白板前需要做些什么？
浏览器窗口全屏时如何让白板正常显示?
文件共享 SDK 的 token 是否和互动白板 SDK 的 token 通用？
如何搭配使用超级白板 SDK 和 实时音视频 SDK？
使用 "switchRoom" 切换房间的时候，为什么报错：1000002-没有登录房间？
Express 各平台 SDK 互通时，userID/roomID/streamID 是否有什么限制？
如何获取 ZegoEffects SDK 的堆栈信息？
Web 平台如何获取 CDN 的拉流地址？
在加载动态 PPT 文件后，点击动态 PPT 无法翻页，该如何处理？
Web 平台如何实现对预览、拉流画面进行截图？
Web 平台通过 "createStream" 方法创建了流，并已给 video 对象的 "srcObject" 赋值，为什么 video 对象没有画面？
如何获取 Roomkit SDK 日志？
开始进行屏幕分享报错 "onScreenCaptureError 3" 怎么处理？
如何添加白板工具？
Web 平台上，RoomKit 大班课，作为学生加入时看不到教师的画面如何处理？
Web 平台从 CDN 拉流，使用 flv 格式播放，为什么暂停后、再播放会导致延迟累积呢？
调用 createEngine 接口创建引擎时，如果将房间场景设置为 "语音通话/语聊房/KTV" 等场景时，还需要主动调用 "enableCamera" 接口关闭摄像头吗？
为什么设置转码清晰度后，没有立马生效，重新渲染也没有生效？
Web 端推流时，报错："code: 1103065, msg: Not Readable Error: device is not readable"，该如何处理？
如何设置文件/白板的日志？
如何处理超级白板 SDK 所有接口均异常的问题？
Web 平台上，当设置的视频分辨率"宽"大于"高"时，PC 端和移动端分别怎么展示？
Web 平台上，Express 如何设置镜像模式？
Express SDK 发送实时消息后，为什么收不到回调？
什么应用在后台时，不支持打开摄像头？
动态 PPT 内的动画点击无反应，该如何处理？
ZIM 默认多长时间发送一次心跳？超过多长时间没有收到用户心跳时，后台会判断为超时？
将流转推到 CDN 过程中，连接断开后如何处理？
如何减少 Express SDK 在 Web 控制台打印的信息？
Express SDK 退出房间，是否需要主动停止推拉流？
为什么 Web 平台在 Windows 设备上使用手写板时无法在白板上进行绘制？
ZIM SDK 中的 onConnectionStateChanged 回调与 onRoomStateChanged 回调的区别是什么？分别在什么情况下触发？
Web 平台报错 "https or localhost required"，是否必须要求 "https"？
Web 平台只预览推流，没有拉流时存在杂音/啸叫声，如何处理？
如何将媒体播放器播放文件的声音混入推流中？
推流时，调用 "enableTrafficControl" 方法开启流控后，网络质量比较差时，为什么仅主路流会触发流控策略？
如何解决同时集成 Firebase Cloud Message 时的冲突？
使用 "muteMicrophone"、"enableAudioCaptureDevice" 接口时，将参数设置为 false，两者有什么区别？
Web 平台屏幕分享，如何将系统声音和麦克风声音分享出去？
调用编译打包后 Roomkit SDK 的接口时报错怎么处理？
文件转码加载文件失败，返回 60018 错误码是什么原因？
Web 平台 "playQualityUpdate" 中有音频码率，但拉流成功后有画面没有声音，是什么原因？
混流时开启了音浪功能，使用 "flv.js" 拉流播放在部分浏览器上会黑屏？
Web 平台使用 "https" 上线，但 SDK 返回的 flv 拉流地址是 "http" 的，无法兼容，如何解决？
Web 平台如何推纯音频的流？
在需频繁切换房间的场景，拉流端画面渲染的速度比较慢，如何进行优化？
不同用户之间如何传递混流流名信息？
通过 ZIM 服务端 "查询用户在线状态" 接口返回 660200001 错误码，该如何处理？
如何获取离线推送 PushID？
Web 平台调用 createStream 方法创建流，参数 "audioInput" 和 "videoInput" 可以传空串吗？
Web 平台 SDK 推流报错 "stream not from zego"，该如何处理？
使用 "uni-app" 框架，拉流的时候 "playerStateUpdate" 显示拉流成功，但是使用 "srcObject" 无法渲染出画面？
在 Web 平台上，进行屏幕分享过程中，点击 "停止共享"按钮，会有回调信息吗？
动态 PPT 转码完成后部分动画与源文件有差异，该如何处理？
为什么"后台回调-录制文件生成回调"会回调两次? 并且两次回调的视频内容都是一样的？
使用实时音视频（ZEGO Express SDK）的"实时消息与信令"功能，是否支持查询历史消息？
使用 Express SDK，小程序作为推流端时，拉流端如何获取麦克风、摄像头的状态变化？
Web 平台如何设置预览和拉流的镜像？
小程序如何直推 CDN？
客户端在线鉴权，通过 URL 地址访问 ZegoEffects 服务端时，为什么有时会出现失败？
Express SDK 有哪些 Token 鉴权方式，该如何使用？
使用 CDN 录制时，当推流端出现断流的情况下，会生成多个录制文件，如何将这些录制文件进行合并呢？
使用外部采集时，是否支持推送携带透明通道的 PNG 图片？
在 Web 平台上，如何禁止麦克风/摄像头的访问权限弹框？
Web 平台拉流时候报错："Player already exist！" 是什么原因？
Express SDK 如何将 SDK 日志打印到控制台？
Web 平台登录房间时提示报错："cmd=login, err_code=1011, err_message=token format error"？
如何指定 StreamID 进行云端录制？
AI 美颜如何实现挂件功能？
使用 ZegoEffects 时，如何解决服务端错误"No valid license"（无法拿到证书）？
Express 推流是否支持设置密钥，需要使用对应密钥才能拉流？
Web 平台登录房间报错："content":"cmd=login, err_code=1000000101, err_message=login liveroom request fail", 或者 "content":"server error=1000000101"，原因是什么？
文件转码加载文件失败，返回 2030004 错误码是什么原因？
PPT 转码完成后会出现文字丢失，该如何处理？
调用 "enablePublishDirectToCDN" 直推 CDN，停止推流后，是否需要再将 "enablePublishDirectToCDN" 重新设置成 "false"？
用户通过 ZIM SDK 接口，修改自己的名称、头像、个人信息扩展字段后，如何查询修改后的信息？
当 Windows 端的白板遮挡住用户的模态对话框后，用户的程序无法点击时该如何处理？
Unity SDK 将图像渲染到网格上时，为什么 shader 选择 "Universal Render Pipeline > Lit" 可以渲染成功，选择 "Universal Render Pipeline > Unlit" 则无法渲染？
为什么美颜设置滤镜后，看不出效果？
如何获取日志文件？
Android 平台下初始化白板 SDK 时报错：Didn't find class "com.zego.edu.logger.ZegoEduLogger"？
使用 ZIM SDK 时，解散了群组，还能用这个群组的 GroupID 重新创建群组吗？
Express 的服务端有创建房间、登录房间的 API 吗？
ZIM SDK 为什么没办法查到房间历史消息？
服务端的"流创建"和"流关闭"回调通知，能否保证是有序的？
房间没人时，房间会立即销毁吗？
更新 ZIM SDK 版本后，需要重新打基座吗?
多次上传文件时，为什么会返回相同的 fileID？
使用 Express SDK 时，如果不同的客户端使用同一个userID 登录房间，会出现什么问题？
如何处理调用 ZegoEffects SDK 接口导致崩溃的问题？
如何自定义通话中的返回按钮事件？
启用瘦脸效果后，当屏幕上用户人脸靠近边缘会导致四周有黑块，应该如何处理？
如何处理拿到证书但美颜没效果？
如何暂停/恢复接收房间内的流？
在 RTC 的自定义前处理功能中使用 ZegoEffects 功能时，预览和推流出现黑屏，如何处理？
如何禁用 callInviteButton 的 toast 显示？
使用实时音视频的 SDK，可以实现音频通话或者语聊房场景吗？
客户端在线鉴权时，如何处理通过 URL 地址访问 ZegoEffects 服务端失败？
如何处理调用 processImageBuffer 后导致的黑屏？
Express 如何创建房间？
动态转码出现某些字体错位，或大小不一致的情况，如何处理？
ZIM 的 login 接口和实时音视频 loginRoom 接口有何差异？
何时会显示悬浮窗视频？
如何处理接入错误？
质量问题
为什么我无法打开摄像头？
怎么处理视频放大或黑边问题？
如何处理 Web 平台直播过程中出现黑屏或无声？
怎么处理音频回声问题？
怎么处理音画不同步问题？
如何避免直播上下麦时音量的变化？
如何在较差的网络环境中保证音视频流畅（流控）？
怎么处理音量太小问题？
Express 怎么处理音频卡顿问题？
怎么处理视频模糊问题？
Express 怎么处理视频卡顿问题？
怎么处理音频噪声问题？
怎么处理无声问题？
如何解决 Web 平台屏幕共享的质量问题？
如何解决 Web 平台和 Native 平台互通时出现的画面异常问题（如黑屏、绿屏、花屏等）？
Express 怎么处理视频黑屏问题？
为什么启动录制后，录制任务成功，但是录制结果的视频中没有显示白板？
怎么处理视频花屏或绿屏问题？
如何处理白板显示不完整或留白的问题？
开启美白后画面整体变黑或者偏蓝，该如何处理？
为什么白板的窗口位置会显示背景图？
为什么录制结果中，白板的窗口变小，出现异常？
为什么白板的窗口位置会显示音视频流？
为什么有时文件转码需要很久？
文件白板中显示的字体异常怎么处理？
产品咨询
Avatar、MetaWorld 等产品及相关解决方案，下架后的替代方案是什么？
RoomKit、Go 课堂产品及其相关解决方案，下架后的替代方案是什么？
数据流录制产品及其相关解决方案，下架后的替代方案是什么？
ZEGO 提供哪些解决方案？
ZEGO Express Web SDK 支持哪些浏览器？
超级白板和互动白板和文件共享是什么关系？
ZEGO 和其他 RTMP + CDN 直播技术有什么区别？
什么是 Token？如何生成 Token？如何使用 Token？
为什么 PPT 内嵌的音频文件，无法暂停和拖动进度条？
即时通信 IM 支持海外接入吗？
在录制过程中，如果音视频流退出房间再重进，会是什么表现？
ZEGO 云通讯 SDK 支持哪些平台，各平台对系统版本的要求是什么？
什么是自定义图形？
普通小游戏（休闲类游戏、棋牌类游戏）相关文档已下架，如何获取相关内容？
ZIM 房间内是否包含实时音视频流？
ZEGO Express SDK 是否支持拉 60 帧的流？
开始录制后，如果房间内新增了流，这个新增的流会被录制吗？
支持录制 IM 信息吗？
云端录制服务器出现断网、异常崩溃时，会如何处理？
超级白板 SDK 支持的文件是否有大小、格式限制？
ZEGO 的音频处理有哪些特点？
录制 PPT 时，能隐藏 PPT Notes 吗？
互动白板 SDK 是否支持快捷键操作？
混流录制指定画面我们可以指定老师端或学生端的共享 PPT 吗？
用户程序崩溃对云录制会有什么影响？
自定义布局、水平布局、平分布局、垂直布局、悬浮布局都支持指定白板的位置吗？
混流录制自定义布局下，如果 mix_input_list 只有一个布局，可以录制多条流么？
互动白板的生命周期是什么样的？
第三方云存储参数（StorageParams）支持传入临时授权的 Token 吗？
支持录制动态 PPT 吗？
文件转码支持哪些格式？
录制视频里可以同时展示两个白板窗口么？
当开启了白板录制，但房间内过了一段时间才新增白板，白板如何录制？
文件上传转码和下载观看耗费的流量如何计算？
互动白板 SDK 与 文件共享 SDK 的关系是什么？
为什么在转码后的动态 PPT 文件页面上点击鼠标右键不会弹出菜单？
超级白板的生命周期是什么样的？
RoomKit 创建项目时要选择的各个使用场景有什么区别？
一个房间内最多可创建多少个白板？
如何获取 SDK 的版本号？
支持的文件是否有大小、格式限制？
超级白板是否支持音视频文件共享？
超级白板是否区分老师、学生等角色？
什么是自定义图形？
互动白板是否区分老师、学生等角色？
使用 OBS、小程序平台推流时，能否在 "星图 > 通话洞察" 中查到推拉流记录？
如何配置域名 CNAME？
如果用户同时在实时音视频和即时通讯的房间里，需要离开房间时，应该先调用 Express SDK 的 "logoutRoom" 接口，还是 ZIM SDK 的 "leaveRoom" 接口呢？
Express Web SDK 支持哪些浏览器？
ZIM 体验版套餐内，默认同一个 AppID 下最多可创建 20 个房间，如果创建 5 个后再销毁 5 个，此时还能再创建几个？
如何进行域名归属权认证？
云端录制什么时候会收到回调通知？
文件是否有大小限制？
ZIM 的 Google 离线推送是否可以用在国内环境？
文件转码加载文件的超时时间是多久？
在每个房间，通话中是否有管理员？
文件转码是否支持音视频文件共享？
多房间功能是否需要特殊配置？
RoomKit 小班课场景中，学生端是否支持 H5?
如何添加白板工具？
ZIM Flutter
sendMessage接口的ZIMMessageSentCallback中没有暴露errorcode，该如何获取呢？ZIM 中使用消息回执功能把消息设置为已读，为什么会话列表中消息未读数没有减少呢？
小游戏平台下架后的替代方案是什么？
其他问题
如何理解和使用 SEI（媒体补充增强信息）？
WebRTC 已知问题及规避方案？
如何处理使用 OBS 推流，SDK 拉流时出现画面卡顿或音画不同步的问题？
如何处理 macOS 系统上 App Nap（App 小憩）的问题？
如何使用位掩码？
如何根据场景选择语音检测的不同接口？
如何定义 streamID 比较合适？
什么时候使用自定义消息？
如何限制只有好友之间才能互发消息？
为什么 Android 9 应用锁屏或切后台后采集音视频无效？
拉流时如何静音某条流或者全部流？
IM 如何销毁房间？
如何设置消息的优先级更为合理？
在 Web 平台上部署服务器时，必须使用 HTTPS 协议吗？
一个用户是否可以加入多个房间？
在房间里时，按Home键回到桌面后，点击应用图标回到应用，为什么没有回到房间？
"后台回调-流创建回调"里面的 "pic_url" 可用于鉴黄，"pic_url" 能否配置 ssl？
网络环境差时，Express SDK 会强行让用户自动退出房间吗？
推流正常时，只有 Android 平台能使用微信浏览器正常拉流，iOS 平台无法拉流，但 "playQualityUpdate" 回调中有数据？
iOS 设备屏幕分享时系统崩溃是什么原因？
Express SDK 如何监听房间内谁在说话？
Web 平台推流时，如何只提供音频权限？
两条流混流时，若其中一条流断开了，混流是否会自动停止？
对配置较低的机型设备，如何选择采集配置、编码分辨率，才能降低性能开销？
调用 "房间用户踢出接口"，踢出一个不存在的用户，是否会报错？
使用服务端混流 API，开始混流接口中的 "seq" 值有什么作用？
使用云端录制时，房间内只有两个真实用户，但 onRoomOnlineUserCountUpdate 回调却显示有三个用户？
在纯音频场景下，混流想要显示背景图，该如何操作？
白板是否支持按轨迹擦除内容？
后台流创建与流关闭回调返回的数据，为什么使用 "Form" 格式处理时无效？
使用泛域名申请了 SSL 证书，为什么在 ZEGO 控制台上传证书时，提示当前上传的证书与域名不匹配？