全部产品
全部产品
实时互动 SDK
灵动课堂
本地服务端录制
互动白板
旁路推流
水晶球
全部平台
Android
iOS
macOS
Windows
C#
小程序
Electron
Unity
Flutter
React Native
服务端 Java
服务端 C++
控制台
Unreal (C++)
Unreal (Blueprint)
RESTful
JavaScript
如何升级到 Token 鉴权方案？
为提高项目的安全性，Agora 会逐步取消对 App ID 鉴权方案的支持。对于创建时选择 **APP ID** 为鉴权机制的项目，你可以参考本文升级到 Token 鉴权方案。
为什么使用 Unity 4.x SDK 开发的 iOS App 上传到 App Store 会报错？
将使用 Unity 4.x SDK 开发的 App 直接打包上传至 App Store 时，你可能会收到如下错误信息：
直播场景下，如何监听远端观众角色用户加入/离开频道的事件？
目前，声网没有在 RTC SDK 中提供监听远端观众加入或离开频道事件的回调。你可以通过消息通知服务提供的事件通知。
为什么在 Android 设备上切换到其他 App 会改变音频路由？
在 Android 设备上使用集成了声网 RTC SDK 的 App （以下简称 SDK App）进行实时音视频互动，切换到其他有音频输入或输出的 App，再切换回 SDK App 之后 SDK 的音频路由发生改变。
如何获取用户的通话时长？
在一个通话中，某个用户可能多次加入和离开 RTC 频道，该用户累计在频道内的时间为该用户的通话时长。通过声网 RTC SDK 或水晶球，你可以获取用户的通话时长。
如何实现摄像头曝光和对焦？
视频场景中，经常会使用到摄像头曝光和对焦的功能，帮助被拍摄物成像清晰、亮度适宜。声网 RTC SDK 在移动平台提供整套的摄像头管理方法，方便用户切换前后摄像头，并对摄像头的缩放、对焦和曝光进行设置。
如何处理频道相关常见问题？
SDK 不会让用户自动退出频道，除非用户自己主动退出，例如 App 调用 `leaveChannel`。
为什么无法上传课件？
上传课件时收到报错，如何处理？
如何自定义课堂 UI？
如何修改教室背景？
如何为录制文件指定动态存储路径？
在声网控制台通过 `fileNamePrefix` 字段配置录制文件存储路径时，你可以使用内置变量来指定动态路径用于存储录制文件。当录制发起时，会用真实的值替换变量。目前支持固定变量和日期变量。
集成和使用灵动课堂过程中的常见错误
如果你在运行灵动课堂 Web 项目时碰到以下报错：
如何处理 IM 相关问题？
聊天插件不显示、无法登录 IM 服务、发送消息失败时如何处理？
灵动课堂如何支持多语言？
灵动课堂目前支持中文、英文和西班牙语。如果你需要添加更多语言，只需要在指定目录找到语言相关的 key 值，进行修改即可。
如何自定义用户属性，课堂属性和 widget 属性？
灵动课堂支持自定义用户属性，课堂属性和 widget 属性。你可以结合自身的业务需求，设置任意课堂属性，灵动课堂会将这个属性的变更同步到所有端，以此来实现你自己的扩展业务。
课堂录制失败怎么办？
检查配置是否正确；检查权限设置；拼接页面录制 URL。
配置时报错“请先获取 RESTful API ID 和密钥”怎么办？
如果你在声网控制台配置灵动课堂时，发生“请先获取 RESTful API ID 和密钥”报错，请进行以下操作：
灵动课堂有哪些课堂状态？
灵动课堂有以下几种课堂状态：
如何关闭 3A（降噪、回声消除、增益）的配置?
通过配置实现关闭 3A 效果。
当使用命令行录制时，如何控制录制进程？
在使用命令行录制过程中，你可以参考如下内容控制录制进程。
如何处理 CocoaPods 常见问题？
一般的原因有：未安装 CocoaPods、安装 CocoaPods 时由于网络连接问题导致操作超时、本地 CocoaPods 仓库过时。
如何处理常见的 Web 浏览器控制台报错？
将 Web SDK 集成到你的 Web 应用后，遇到问题时可以通过浏览器控制台打印的日志进行调试。本文列出控制台日志中常见的错误和原因。
setEnabled 和 setMuted 有什么区别？
Web SDK 4.x 和 3.x 均提供 API 用于控制本地音视频的采集和发送，这些 API 的区别详见下表。
编译 Xcode 项目时遇到“无法打开 framework” 的弹窗警告怎么办？
在 macOS 11.6 或更高版本系统上，使用 Xcode 集成实时互动 SDK 时，你可能在项目编译运行时遇到弹窗警告：“macOS 无法打开 ‘\{library_name}.framework’，因为无法验证开发者。”
如何获取频道相关信息，例如频道名称，以及频道内的用户列表？
声网目前只支持在服务端通过 RESTful API 获取频道相关信息。
如何判断一个通话是语音通话还是视频通话？
在实时音视频通话场景中，你可以通过声网 RTC SDK 判断一个即将开始或正在进行的通话是语音通话还是视频通话。
如何将指定用户移出频道？
在实时音视频互动场景中，通常会有将指定用户移出频道的需求。声网根据实际场景需求，提供如下三种解决方案：
如何处理 RTC 小程序 SDK 常见问题？
本文汇总 RTC 小程序 SDK 常见问题和解决方法。
为什么 Android 设备上挂断系统电话后音乐文件不会自动恢复播放？
在 Android 设备上调用 `startAudioMixing` 方法播放音乐文件，播放过程中使用系统自带的电话软件接听或者拨打了电话，挂断电话后音乐文件没有自动恢复播放。
为什么用 Unity 组件播放背景音乐会无声？
在 iOS 设备中，用 Unity 组件（AudioSource 和 AudioClip）播放背景音乐，你可能会遇到以下问题：
为什么 Android 9 无法使用 startAudioMixing 或 playEffect 播放音频文件？
Android 9 手机上，调用 `startAudioMixing` 或 `playEffect` 无法播放音频文件。
为什么使用 CocoaPods 集成 iOS SDK 后运行 pod lib lint 命令报错？
在 Xcode 12 或之后版本的环境中，如果你使用 CocoaPods 集成 3.3.0 或之后版本 iOS SDK，运行 `pod lib lint` 命令时，你可能会收到如下报错：
单流录制模式和合流录制模式有什么区别？
如果你想要更灵活的处理录制文件，可以选择单流录制模式。例如，在在线课堂这一场景中，如果父母只想观看老师和自己孩子的视频，你可以选择单流模式，分别录制老师和每位学生的视频，然后将老师的视频分别与每位学生的视频合并。又比如，在内容审核场景中，如果需要识别出发布违规内容的用户 ID，你可以选择单流模式，分开录制并审核每位用户的音频和视频。
录制生成的文件支持哪些播放器？
根据选择的录制模式不同，在录制结束后生成的录制文件也不一样。
如何处理服务端 RESTful API 调用超出频率限制？
当一个服务端 RESTful API 调用超出频率限制时，会返回状态码 429，表示请求过于频繁。你可以结合业务实际并发需求，参考以下建议，优化 API 调用频率：
如何在 RESTful API 中进行 HTTP 基本认证和 Token 认证?
在使用 RESTful API 前，你需要通过 HTTP 基本认证或 Token 认证。
如何设置日志文件？
声网 SDK 提供设置 SDK 的输出日志文件的功能，SDK 运行时产生的所有 log 将写入该文件。
如何区分媒体音量和通话音量？
<a name="volume_type"></a>
如何使用连麦鉴权功能？
连麦鉴权，主要用于控制频道内的用户是否有发布流的权限，需要开发者通过自己的业务服务端部署并生成 Token、声网服务器再对生成的 Token 校验实现。
如何处理 Token 相关错误码？
当你的声网项目中不存在**无证书**并且启用了[主要/次要证书](https://docs.agora.io/cn/Agora%20Platform/manage_projects?platform=All%20Platforms#manage)，则表示你选择使用动态密钥 Token 对用户进行鉴权。
如何使用视频增强插件？
Video SDK v4.x 中提供了视频增强插件，可以实现美颜、暗光增强、色彩增强、视频降噪功能。
如何处理小程序 SDK 常见问题？
本文汇总小程序 SDK 常见问题和解决方法。
如何导出 PDF？
导出 PDF 功能需要使用 `window.postMessage` 事件发起导出任务。以下为详细步骤：
如何处理 Windows 7 窗口共享异常？
- 在 Windows 7 版本上共享文件资源管理器窗口时，远端用户看到的共享窗口的搜索框颜色可能异常（黑色）。