diff --git "a/markdown/chatroom/01-\350\277\233\345\207\272\346\210\277\351\227\264.wsd" "b/markdown/chatroom/01-\350\277\233\345\207\272\346\210\277\351\227\264.wsd"
new file mode 100644
index 00000000000..e03c28b3641
--- /dev/null
+++ "b/markdown/chatroom/01-\350\277\233\345\207\272\346\210\277\351\227\264.wsd"
@@ -0,0 +1,34 @@
+@startuml
+title 用户进出语聊房的流程图
+start
+: 进入语聊房列表;
+: 初始化信令系统;
+: 登录信令系统;
+if (是否需要创建房间) then (Yes)
+    : 创建房间;
+else(No)
+endif
+:进入房间;
+fork
+    :初始化 RTC 引擎;
+    :[RTC] 加入频道;
+  fork again
+    :[信令] 加入聊天室;
+  endfork
+:显示聊天消息和声音;
+if (是否离开房间) then (Yes)
+fork
+:[RTC] 退出频道;
+:销毁 RTC 引擎;
+fork again
+:[信令] 离开聊天室;
+endfork
+if (角色是否为房主) then (Yes)
+:销毁房间;
+else (No)
+:离开房间;
+endif
+else (No)
+endif
+stop
+@enduml
\ No newline at end of file
diff --git "a/markdown/chatroom/02-\346\210\277\344\270\273\351\202\200\350\257\267.wsd" "b/markdown/chatroom/02-\346\210\277\344\270\273\351\202\200\350\257\267.wsd"
new file mode 100644
index 00000000000..9ec1e6bcb77
--- /dev/null
+++ "b/markdown/chatroom/02-\346\210\277\344\270\273\351\202\200\350\257\267.wsd"
@@ -0,0 +1,26 @@
+@startuml
+title 房主邀请听众上麦的流程图
+start
+if (角色是否为房主) then (Yes)
+    :房主向听众发起上麦邀请;
+    :房主收到听众对邀请的响应;
+    if (听众同意房主的邀请) then (Yes)
+    :房主收到麦位已更新的通知;
+    else (No)
+    stop
+    endif
+else(No)
+    :听众收到房主的上麦邀请;
+    if (听众是否同意房主的邀请) then (Yes)
+    :听众发起同意邀请的通知;
+    :上麦并修改麦位信息;
+    :[RTC] 更新当前用户角色为主播;
+    :[RTC] 发布本地音频流;
+    else (No)
+    :发起拒绝邀请的通知;
+    stop
+    endif
+endif
+:更新麦位 UI 界面;
+stop
+@enduml
\ No newline at end of file
diff --git "a/markdown/chatroom/03-\350\247\202\344\274\227\347\224\263\350\257\267.wsd" "b/markdown/chatroom/03-\350\247\202\344\274\227\347\224\263\350\257\267.wsd"
new file mode 100644
index 00000000000..3224fc89bbe
--- /dev/null
+++ "b/markdown/chatroom/03-\350\247\202\344\274\227\347\224\263\350\257\267.wsd"
@@ -0,0 +1,21 @@
+@startuml
+title 听众向房主申请上麦的流程图
+start
+if (角色是否为房主) then (Yes)
+    :房主收到听众的上麦申请;
+    if (房主是否同意申请) then (Yes)
+    :房主发送接受听众上麦申请的通知;
+    :房主修改麦位信息以让听众上麦;
+    else (No)
+    :房主发送拒绝听众上麦申请的通知;
+    stop
+    endif
+else(No)
+    :听众向房主发起上麦申请;
+    :房主接受后，听众收到自己上麦的消息;
+    :[RTC] 更新当前用户角色为主播;
+    :[RTC] 发布本地音频流;
+endif
+:更新麦位 UI 界面;
+stop
+@enduml
\ No newline at end of file
diff --git a/markdown/chatroom/AUIVoiceRoom/chatroom_pass_overview.md b/markdown/chatroom/AUIVoiceRoom/chatroom_pass_overview.md
new file mode 100644
index 00000000000..2d4e9f4a5c9
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/chatroom_pass_overview.md
@@ -0,0 +1,9 @@
+声动语聊解决方案提供了同时支持含 UI 和无 UI 组件的集成方案。
+
+无 UI 组件的语聊集成方案是 PaaS 方案。该方案通过集成声网的实时互动（RTC）、即时通讯（IM）、云服务（Service）产品，提供房间管理、麦位控制、聊天打赏、音频特效等核心功能。
+
+相较于含 UI 组件的集成方案，无 UI 组件的语聊集成方案具有以下特点和优势：
+
+- 灵活开发：交互逻辑完全在客户端实现，修改业务逻辑时无需依赖后端介入，更加灵活。
+- 全面功能演示：含有最新的功能迭代，提供更全面的效果演示能力。
+- 丰富最佳实践参考：积累了丰富的语聊集成最佳实践，为开发者提供更多可参考的代码逻辑。
diff --git a/markdown/chatroom/AUIVoiceRoom/input-and-ktv.md b/markdown/chatroom/AUIVoiceRoom/input-and-ktv.md
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/markdown/chatroom/AUIVoiceRoom/input-and.md b/markdown/chatroom/AUIVoiceRoom/input-and.md
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/markdown/chatroom/AUIVoiceRoom/input-ios.md b/markdown/chatroom/AUIVoiceRoom/input-ios.md
new file mode 100644
index 00000000000..966616c8894
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/input-ios.md
@@ -0,0 +1,355 @@
+`VoiceChatUIKit` 基于声网 RTC、RTM 引擎、AUIKit 等模块封装，帮助你轻松管理语聊房。你可以使用 `VoiceChatUIKit` 类中的 API 实现语聊房间的创建、用户进房、退出和销毁等功能。
+
+### 1. 初始化 VoiceChatUIKit
+
+本节展示初始化 `VoiceChatUIKit` 的代码逻辑：
+
+1. 在 `AppDelegate.swift` 文件里导入依赖库：
+
+    ```swift
+    import AUIKitCore
+    import AScenesKit
+    ```
+
+2. 在 `AppDelegate` 类中调用 `VoiceChatUIKit` 类的 `setup` 方法并传入如下参数，初始化 `VoiceChatUIKit`：
+
+    - `roomConfig`：通用配置，包含后端域名地址、用户 ID、用户名、用户头像。
+    - `rtcEngine`：声网 RTC 引擎。
+    - `rtcClient`：声网 RTM 引擎。
+
+    ```swift
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        // 生成一个随机的用户 ID
+        let uid = Int(arc4random_uniform(99999999))
+
+        // 创建一个 AUICommonConfig 实例
+        let commonConfig = AUICommonConfig()
+
+        // 设置 AUICommonConfig 的属性值
+        commonConfig.host = "https://service.agora.io/uikit-voiceroom" // 设置主机地址
+        commonConfig.userId = "\(uid)" // 设置用户 ID
+        commonConfig.userName = "user_\(uid)" // 设置用户名
+        commonConfig.userAvatar = "https://accktvpic.oss-cn-beijing.aliyuncs.com/pic/sample_avatar/sample_avatar_1.png" // 设置用户头像
+
+        // 调用 VoiceChatUIKit 的 setup 方法进行初始化设置
+        VoiceChatUIKit.shared.setup(roomConfig: commonConfig,
+                                    rtcEngine: nil,   // 如果有外部初始化的 rtc engine，可以传入该实例
+                                    rtmClient: nil)   // 如果有外部初始化的 rtm client，可以传入该实例
+
+        // 在应用程序启动完成后的自定义逻辑（可根据需要进行覆盖）
+        ...
+
+        return true
+    }
+    ```
+
+### 2. 房主创建房间
+
+本节展示如何让房主创建语聊房。
+
+#### 添加按钮：创建房间
+
+在 `ViewController.swift` 文件里导入依赖库：
+
+```swift
+import AUIKitCore
+import AScenesKit
+```
+
+在 `ViewController` 类中，通过 iOS 原生方法增加一个「创建房间」按钮，用于让房主点击创建。
+
+```swift
+override func viewDidLoad() {
+    super.viewDidLoad()
+
+    // 作为房主创建房间的按钮
+    let createButton = UIButton(frame: CGRect(x: 10, y: 100, width: 100, height: 60))
+    createButton.setTitle("创建房间", for: .normal)
+    createButton.setTitleColor(.red, for: .normal)
+    createButton.addTarget(self, action: #selector(onCreateAction), for: .touchUpInside)
+    view.addSubview(createButton)
+}
+```
+
+#### 创建语聊房
+
+在 `ViewController` 类中，调用 `VoiceChatUIKit` 类的 `createRoom` 并传入 `roomInfo` 参数以创建语聊房。`roomInfo` 里需传入房间信息。
+
+如果创建房间成功，那么执行 `enterRoom` 函数。
+
+
+```swift
+@objc func onCreateAction(_ button: UIButton) {
+    // 生成一个随机的房间 ID
+    let roomId = Int(arc4random_uniform(99999999))
+    // 创建一个 AUICreateRoomInfo 实例
+    let room = AUICreateRoomInfo()
+    // 设置房间名为生成的随机房间 ID
+    room.roomName = "\(roomId)"
+    // 禁用按钮，防止重复点击
+    button.isEnabled = false
+
+    // 调用 VoiceChatUIKit 的 createRoom 方法创建房间
+    VoiceChatUIKit.shared.createRoom(roomInfo: room) { roomInfo in
+        // 成功创建房间后的回调
+        self.enterRoom(roomInfo: roomInfo!) // 加入房间
+        button.isEnabled = true // 恢复按钮可用状态
+    } failure: { error in
+        // 创建房间失败的回调
+        print("on create room fail: \(error.localizedDescription)")
+        button.isEnabled = true // 恢复按钮可用状态
+    }
+}
+```
+
+### 3. 加入房间
+
+本节展示如何让房主加入语聊房。
+
+#### 声明属性
+
+在 `ViewController` 类中声明了一个可选属性，用于存储 `AUIVoiceChatRoomView` 实例以显示语聊房的详情界面。
+
+```swift
+class ViewController: UIViewController {
+    var voiceChatView: AUIVoiceChatRoomView?
+    ...
+}
+```
+
+#### 创建房间详情页并启动房间
+
+在 `ViewController` 中，创建一个 `AUIVoiceChatRoomView` 实例，并将它设置为 `voiceChatView` 属性，用于显示语聊房的详情界面。
+
+调用 `VoiceChatUIKit` 类的 `launchRoom` 方法，并传入以下参数，以启动语聊房：
+
+- `roomInfo`：房间信息。
+- `voiceChatView`：房间的 UI View。
+
+
+```swift
+func enterRoom(roomInfo: AUIRoomInfo) {
+    // 创建一个 AUIVoiceChatRoomView 实例，并设置其 frame 为当前视图的边界
+    voiceChatView = AUIVoiceChatRoomView(frame: self.view.bounds)
+
+    if let roomView = self.voiceChatView {
+        // 调用 VoiceChatUIKit 的 launchRoom 方法，启动房间
+        VoiceChatUIKit.shared.launchRoom(roomInfo: roomInfo,
+                                         roomView: roomView) { [weak self] error in
+            guard let self = self else { return }
+            // 如果出现错误，直接返回
+            if let _ = error { return }
+
+            // 将 roomView 添加到当前视图中
+            self.view.addSubview(roomView)
+        }
+    }
+}
+```
+
+### 4. （可选）听众加入房间
+
+本节展示如何让听众加入已存在的房间。
+
+#### 添加按钮：加入房间
+
+在 `ViewController` 类中，通过 iOS 原生方法增加一个「加入房间」按钮，用于让听众点击加入。
+
+```swift
+override func viewDidLoad() {
+    super.viewDidLoad()
+
+    // 作为房主创建房间的按钮
+    let createButton = UIButton(frame: CGRect(x: 10, y: 100, width: 100, height: 60))
+    createButton.setTitle("创建房间", for: .normal)
+    createButton.setTitleColor(.red, for: .normal)
+    createButton.addTarget(self, action: #selector(onCreateAction), for: .touchUpInside)
+    view.addSubview(createButton)
+
+    // highlight-start
+    // 作为听众加入房间的按钮
+    let joinButton = UIButton(frame: CGRect(x: 10, y: 160, width: 100, height: 60))
+    joinButton.setTitle("加入房间", for: .normal)
+    joinButton.setTitleColor(.red, for: .normal)
+    joinButton.addTarget(self, action: #selector(onJoinAction), for: .touchUpInside)
+    view.addSubview(joinButton)
+    // highlight-end
+}
+```
+
+
+#### 获取房间列表
+
+在 `ViewController` 类中，调用 `VoiceChatUIKit` 类的 `getRoomInfoList` 方法并传入如下参数，以获取语聊房间列表：
+
+- `lastCreateTime`：房间列表的起始时间。
+- `pageSize`：房间列表的数量。
+
+如果在房间列表中找到匹配的房间名，那么执行 `enterRoom` 函数。通过[此前步骤](//TODO)中已添加的 `enterRoom` 函数即可实现加入房间。
+
+```swift
+@objc func onJoinAction() {
+    // 创建 UIAlertController 实例，用于显示弹出对话框
+    let alertController = UIAlertController(title: "房间名", message: "", preferredStyle: .alert)
+    alertController.addTextField { (textField) in
+        textField.placeholder = "请输入"
+    }
+    // 创建一个「取消」按钮，并指定点击事件
+    let cancelAction = UIAlertAction(title: "取消", style: .cancel) { (_) in
+    }
+    // 创建一个「确认」按钮，并指定点击事件
+    let saveAction = UIAlertAction(title: "确认", style: .default) { (_) in
+        // 获取用户输入的文本内容
+        if let inputText = alertController.textFields?.first?.text {
+            // 处理用户输入的内容
+            VoiceChatUIKit.shared.getRoomInfoList(lastCreateTime: nil, pageSize: 50) { error, roomList in
+                // 检查是否有错误发生，并确保成功获取到了房间列表
+                guard let roomList = roomList else {return}
+                // 遍历房间列表
+                for room in roomList {
+                    // 比对房间名与用户输入的文本内容是否匹配
+                    if room.roomName == inputText {
+                        // 找到匹配的房间名，调用 enterRoom 方法加入房间
+                        self.enterRoom(roomInfo: room)
+                        // 结束循环
+                        break
+                    }
+                }
+            }
+        }
+    }
+
+    // 将「取消」按钮添加到弹出对话框
+    alertController.addAction(cancelAction)
+    // 将「确认」按钮添加到弹出对话框
+    alertController.addAction(saveAction)
+    // 在当前视图上显示弹出对话框
+    present(alertController, animated: true, completion: nil)
+}
+```
+
+### 5. （可选）退出或销毁房间
+
+本节展示如何退出并销毁房间。
+
+在语聊房中，房主可以主动销毁房间，房间销毁时听众会被动退出房间。房间存在时，听众也可以主动退出房间。
+
+
+#### 主动退出或销毁房间
+
+在 `enterRoom` 函数中添加如下高亮的几行代码，即可实现通过点击按钮主动退出房间（听众）或销毁房间（房主）。
+
+```swift
+func enterRoom(roomInfo: AUIRoomInfo) {
+    // 创建一个 AUIVoiceChatRoomView 实例，并设置其 frame 为当前视图的边界
+    voiceChatView = AUIVoiceChatRoomView(frame: self.view.bounds)
+
+    // highlight-start
+    // 点击退出房间按钮
+    voiceChatView?.onClickOffButton = { [weak self] in
+            self?.destroyRoom(roomId: roomInfo.roomId)
+        }
+    // highlight-end
+
+    if let roomView = self.voiceChatView {
+        // 调用 VoiceChatUIKit 的 launchRoom 方法，启动房间
+        VoiceChatUIKit.shared.launchRoom(roomInfo: roomInfo,
+                                         roomView: roomView) { [weak self] error in
+            guard let self = self else { return }
+            // 如果出现错误，直接返回
+            if let _ = error { return }
+
+            // 将 roomView 添加到当前视图中
+            self.view.addSubview(roomView)
+        }
+    }
+}
+```
+
+
+#### 被动退出房间
+
+听众被动退出房间的代码逻辑如下：
+
+1. 在 `enterRoom` 函数中添加如下高亮的代码行。调用 `VoiceChatUIKit` 类的 `bindRespDelegate` 方法，订阅房间被销毁的回调。
+
+    ```swift
+    func enterRoom(roomInfo: AUIRoomInfo) {
+        // 创建一个 AUIVoiceChatRoomView 实例，并设置其 frame 为当前视图的边界
+        voiceChatView = AUIVoiceChatRoomView(frame: self.view.bounds)
+
+        // highlight-start
+        // 点击退出房间按钮
+        voiceChatView?.onClickOffButton = { [weak self] in
+                self?.destroyRoom(roomId: roomInfo.roomId)
+            }
+        // highlight-end
+
+        if let roomView = self.voiceChatView {
+            // 调用 VoiceChatUIKit 的 launchRoom 方法，启动房间
+            VoiceChatUIKit.shared.launchRoom(roomInfo: roomInfo,
+                                             roomView: roomView) { [weak self] error in
+                guard let self = self else { return }
+                // 如果出现错误，直接返回
+                if let _ = error { return }
+                // highlight-start
+                VoiceChatUIKit.shared.bindRespDelegate(delegate: self)
+                // highlight-end
+                // 将 roomView 添加到当前视图中
+                self.view.addSubview(roomView)
+            }
+        }
+    }
+    ```
+
+2. 在 `ViewController` 文件中，通过 `AUIRoomManagerRespDelegate` 中的 `onRoomDestroy` 回调来监听房间销毁事件。当监听到房间被销毁时，执行 `destroyRoom` 函数。
+
+    ```swift
+    extension ViewController: AUIRoomManagerRespDelegate {
+        // 房间销毁回调
+        func onRoomDestroy(roomId: String) {
+            self.destroyRoom()
+        }
+        // 房间信息更新回调
+        func onRoomInfoChange(roomId: String, roomInfo: AUIKitCore.AUIRoomInfo) {
+        }
+         // 房间成员列表更新回调
+        func onRoomAnnouncementChange(roomId: String, announcement: String) {
+        }
+        // 听众被房主踢出房间回调
+        func onRoomUserBeKicked(roomId: String, userId: String) {
+            self.destroyRoom()
+        }
+    }
+    ```
+
+3. 在 `ViewController` 类中，增加 `destroyRoom` 函数。在该函数中，调用 `VoiceChatUIKit` 类的 `unbindRespDelegate` 方法，取消订阅房间被销毁的回调。
+
+    ```swift
+    func destroyRoom(roomId: String) {
+        // 在退出房间时取消订阅，调用 VoiceChatUIKit 的 unbindRespDelegate 方法
+        VoiceChatUIKit.shared.unbindRespDelegate(delegate: self)
+    }
+    ```
+
+#### 添加销毁逻辑
+
+在 `destroyRoom` 函数中，添加如下高亮的几行代码。调用 `VoiceChatUIKit` 类的 `destoryRoom` 方法并传入房间 ID，以销毁房间。至此，`destroyRoom` 函数的代码补充完成。
+
+```swift
+func destroyRoom(roomId: String) {
+    // highlight-start
+    // 点击退出，调用 VoiceChatView 的 onBackAction 方法
+    self.VoiceChatView?.onBackAction()
+
+    // 将 VoiceChatView 从父视图中移除
+    self.VoiceChatView?.removeFromSuperview()
+
+    // 调用 VoiceChatUIKit 的 destoryRoom 方法销毁房间，传入房间 ID
+    VoiceChatUIKit.shared.destoryRoom(roomId: roomId)
+    // highlight-end
+
+    // 在退出房间时取消订阅，调用 VoiceChatUIKit 的 unbindRespDelegate 方法
+    VoiceChatUIKit.shared.unbindRespDelegate(delegate: self)
+}
+```
\ No newline at end of file
diff --git a/markdown/chatroom/AUIVoiceRoom/uivoice_enable_service.md b/markdown/chatroom/AUIVoiceRoom/uivoice_enable_service.md
new file mode 100644
index 00000000000..917e69346b2
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/uivoice_enable_service.md
@@ -0,0 +1,18 @@
+//TODO
+- 同时还需要开通以下服务
+    - RTM, [联系客服人员开通](https://www.shengwang.cn)
+    - NCS, RTC频道事件回调通知, 处理人员进出/房间销毁逻辑
+        - [开通消息通知服务
+          ](https://docs.agora.io/cn/video-call-4.x/enable_webhook_ncs?platform=All%20Platforms)
+            - 选择以下事件类型
+                - channel create, 101
+                - channel destroy, 102
+                - broadcaster join channel, 103
+                - broadcaster leave channel, 104
+            - 回调地址
+                - https://你的域名/v1/ncs/callback
+            - 修改Secret
+                - 根据配置界面提供的Secret值, 修改项目配置文件application.yml的ncs.secret
+        - [频道事件回调
+          ](https://docs.agora.io/cn/video-call-4.x/rtc_channel_event?platform=All%20Platforms)
+    - 环信 IM，在环信 Console 控制台进行配置 [开通配置环信即时通讯 IM 服务](https://docs-im-beta.easemob.com/document/server-side/enable_and_configure_IM.html)
\ No newline at end of file
diff --git a/markdown/chatroom/AUIVoiceRoom/uivoice_integration_android.md b/markdown/chatroom/AUIVoiceRoom/uivoice_integration_android.md
new file mode 100644
index 00000000000..e872328d9e5
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/uivoice_integration_android.md
@@ -0,0 +1,169 @@
+---
+title: 实现语聊房
+---
+
+本文介绍如何集成语聊 UIKit 来实现房间的创建、用户进房、退房和销毁等功能。
+
+## 示例项目
+
+声网提供 [API-Examples-AUIKit/Android/VoiceRoomApp](https://github.com/AgoraIO-Community/API-Examples-AUIKit/tree/dev/voiceroom-android/Android/VoiceRoomApp) 示例项目供你参考本文提到的集成步骤和代码逻辑。
+
+
+## 准备开发环境
+
+### 前提条件
+
+- [Android Studio](https://developer.android.com/studio/) 3.5 及以上。本文以 [Android Studio Giraffe | 2022.3.1](https://developer.android.google.cn/studio/releases?hl=zh-cn) 和 JBR 17.0.6 为例。
+- Android 手机，版本 Android 5.0（API Level 21）及以上。
+- 可以访问互联网的计算机。确保你的网络环境没有部署防火墙，否则无法正常使用声网服务。
+- [开通服务](./enable-service)。
+
+
+### 创建项目
+
+如需创建新项目，在 **Android Studio** 里，依次选择 **Phone and Tablet > Empty Activity**，创建 [Android 项目](https://developer.android.com/studio/projects/create-project)。
+
+<Admonition type="caution" title="注意">
+创建项目后，<b>Android Studio</b> 会自动开始同步 gradle，稍等片刻至同步成功后再进行下一步操作。
+</Admonition>
+
+### 集成依赖
+
+本节介绍如何集成语聊项目所需的依赖库：
+
+1. 下载声网提供的 [AUIVoiceRoom/Android/asceneskit](https://github.com/AgoraIO-Community/AUIVoiceRoom/tree/main/Android/asceneskit) 文件夹，并将该文件夹复制到与你的 `app` 文件夹所在的同一级目录下。
+
+2. 在 `<your_app>/setting.gradle.kts` 文件中添加如下行：
+
+    ```kotlin
+    dependencyResolutionManagement {
+        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+        repositories {
+            google()
+            mavenCentral()
+            // 添加 jitpack 仓库，拉取 auikit 库
+            maven { url = java.net.URI.create("https://www.jitpack.io") }
+        }
+    }
+
+    // 项目名需为你的 Android Studio 项目的真实名称
+    rootProject.name = "VoiceRoomApp"
+    include(":app")
+    // 添加 asceneskit 库到项目里
+    include(":asceneskit")
+    ```
+
+3. 在 `<your_app>/app/build.gradle.kts` 文件中添加如下行：
+
+    ```kotlin
+    dependencies {
+        ...
+
+        // 添加 asceneskit 依赖
+        implementation(project(":asceneskit"))
+    }
+    ```
+
+4. 点击 **Sync Now** 按钮，等待 gradle 同步完成。//TODO 图
+
+### 配置权限
+
+本节介绍如何配置项目所需权限：
+
+1. 在 `<your_app>/app/Manifests/AndroidManifest.xml` 文件中添加如下行，配置网络、录音等权限：
+
+    ```xml
+    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+        xmlns:tools="http://schemas.android.com/tools">
+
+        <!-- 网络权限 -->
+        <uses-permission android:name="android.permission.INTERNET" />
+        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+        <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+        <!-- 录音权限 -->
+        <uses-permission android:name="android.permission.RECORD_AUDIO" />
+        <uses-permission android:name="android.permission.CALL_PHONE" />
+        <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
+        ...
+
+    </manifest>
+    ```
+
+2. 如果你的后端服务 host url 不是 https 开头，那么你需要在 `<your_app>/app/Manifests/AndroidManifest.xml` 文件中添加如下高亮行：//TODO 后端 link
+
+    ```xml
+    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+        xmlns:tools="http://schemas.android.com/tools">
+
+        <!-- 网络权限 -->
+        <uses-permission android:name="android.permission.INTERNET" />
+        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+        <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+        <!-- 录音权限 -->
+        <uses-permission android:name="android.permission.RECORD_AUDIO" />
+        <uses-permission android:name="android.permission.CALL_PHONE" />
+        <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
+
+        <!-- highlight-start -->
+        <application
+            android:usesCleartextTraffic="true">
+            ...
+        </application>
+        <!-- highlight-end -->
+
+        ...
+
+    </manifest>
+    ```
+
+### 配置主题
+
+在 `<your_app>/app/src/main/res/values/themes.xml` 文件中添加如下行配置语聊房 UI 主题：
+
+```xml
+<resources>
+    <!-- 将 VoiceRoomApp 改成你实际的项目名 -->
+    <style name="Theme.VoiceRoomApp" parent="Theme.VoiceRoom" />
+</resources>
+```
+
+### （可选）防止代码混淆
+
+在 `<your_app>/app/proguard-rules.pro` 文件中添加如下行，以防止声网 SDK 的代码被混淆：
+
+```kotlin
+-keep class io.agora.**{*;}
+-dontwarn javax.**
+-dontwarn com.google.devtools.build.android.**
+```
+
+## 实现语聊房
+
+### 1. 初始化 AUIVoiceRoomUiKit
+
+### 2. 房主创建房间
+
+#### 2.1 添加按钮：创建房间
+
+#### 2.2 创建语聊房
+
+### 3. 房主加入房间
+
+#### 3.1 创建房间详情页
+
+#### 3.2 启动房间
+
+### 4. （可选）观众加入房间
+
+#### 4.1 添加按钮：加入房间
+
+#### 4.2 获取房间列表
+
+### 5. （可选）退出或销毁房间
+
+
+## 下一步
+
+在创建、进入房间后，你可以参考如下业务流程图开发后续的麦位管理、聊天、礼物等功能。
+
+![](https://web-cdn.agora.io/docs-files/1697095578162)
\ No newline at end of file
diff --git a/markdown/chatroom/AUIVoiceRoom/uivoice_integration_ios.md b/markdown/chatroom/AUIVoiceRoom/uivoice_integration_ios.md
new file mode 100644
index 00000000000..11be2bb7d6d
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/uivoice_integration_ios.md
@@ -0,0 +1,502 @@
+---
+title: 实现语聊房
+---
+
+本文介绍如何集成语聊 UIKit 来实现房间的创建、用户进房、退房和销毁等功能。
+
+## 示例项目
+
+声网提供 [API-Examples-AUIKit/iOS/VoiceChatApp](https://github.com/AgoraIO-Community/API-Examples-AUIKit/tree/dev/ios/iOS/VoiceChatApp) 示例项目供你参考本文提到的集成步骤和代码逻辑。
+
+## 准备开发环境
+
+### 前提条件
+
+- [Xcode](https://apps.apple.com/cn/app/xcode/id497799835?mt=12) 14.0 及以上。
+- iOS 设备，版本 13.0 及以上。
+- 有效的苹果开发者账号。
+- 可以访问互联网的计算机。确保你的网络环境没有部署防火墙，否则无法正常使用声网服务。
+- [开通服务](./enable-service)。
+
+### 创建项目
+
+本节介绍如何在 Xcode 创建项目：
+
+1. [创建一个新的项目](https://help.apple.com/xcode/mac/current/#/dev07db0e578)，**Application** 选择 **App**，**Interface** 选择 **Storyboard**，**Language** 选择 **Swift**。
+
+    <Admonition type="caution" title="注意">
+    如果你没有添加过开发团队信息，会看到 <b>Add account…</b> 按钮。点击该按钮并按照屏幕提示登入 Apple ID，点击 <b>Next</b>，完成后即可选择你的 Apple 账户作为开发团队。
+    </Admonition>
+
+2. 为你的项目设置[自动签名](https://help.apple.com/xcode/mac/current/#/dev23aab79b4)。
+
+3. 设置部署你的 app 的[目标设备](https://help.apple.com/xcode/mac/current/#/deve69552ee5)。
+
+4. 设置 **Minimum Deployments** 为 iOS 13。
+
+    ![](https://web-cdn.agora.io/docs-files/1697686309702)
+
+
+5. 添加项目的设备权限。在项目导航栏中打开 `info.plist` 文件，编辑[属性列表](https://help.apple.com/xcode/mac/current/#/dev3f399a2a6)，添加以下属性：
+
+    | key                                    | type   | value                                                        |
+    | -------------------------------------- | ------ | ------------------------------------------------------------ |
+    | Privacy - Microphone Usage Description | String | 使用麦克风的目的，例如 for a live interactive streaming |
+
+### 集成依赖
+
+本节介绍如何集成语聊项目所需的依赖库：
+
+1. 开始前请确保你已安装 CocoaPods，如尚未安装 CocoaPods，参考 [Getting Started with CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 安装说明。
+
+2. 下载声网提供的 [AUIVoiceRoom/iOS/AScenesKit/AScenesKit](https://github.com/AgoraIO-Community/AUIVoiceRoom/tree/main/iOS/AScenesKit/AScenesKit) 文件夹，并将该文件夹复制到与你的 `*.xcodeproj` 文件所在的同一级目录下。
+
+    <Image alt="" src="/img/chatroom/ascenskit.png" />
+
+3. 在终端里进入 `*.xcodeproj` 文件的上一级目录，并运行 `pod init` 命令。项目文件夹下会生成一个 `Podfile` 文本文件。
+
+5. 打开 `Podfile` 文件，修改文件为如下内容。注意 target 和 path 的填写。
+
+    ```shell
+    source 'https://github.com/CocoaPods/Specs.git'
+    platform :ios, '13.0'
+
+    # target 需改为你的项目中实际的 Target 名称
+    target 'AUIKitDemo' do
+      use_frameworks!
+
+      # path 需为 AScenesKit 依赖库的实际路径
+      pod 'AScenesKit', :path => './AScenesKit'
+      # 推荐你指定 RTC SDK 版本为 4.1.1.17
+      pod 'AgoraRtcEngine_Special_iOS', '4.1.1.17'
+    end
+
+    post_install do |installer|
+      installer.pods_project.targets.each do |target|
+        target.build_configurations.each do |config|
+          config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
+        end
+      end
+    end
+    ```
+
+6. 在终端里进入 `*.xcodeproj` 文件的上一级目录，运行如下命令安装 AUIKit 依赖：
+
+    ```shell
+    pod update --verbose
+    ```
+
+    <Detail title="安装过程截图">
+    ![](https://web-cdn.agora.io/docs-files/1697696810206)
+    ![](https://web-cdn.agora.io/docs-files/1697696820778)
+    ![](https://web-cdn.agora.io/docs-files/1697696829568)
+    </Detail>
+
+    如果等待安装的时间太久，请参考[加速 Pod](#加速-pod)。依赖库安装成功后，与 `*.xcodeproj` 文件所在的同一级目录下会出现一个 `*.xcworkspace` 文件。打开该文件即可体验安装了 AScenesKit 和 AUIKit 等依赖的项目。
+
+    ![](https://web-cdn.agora.io/docs-files/1697696837811)
+
+
+## 实现语聊房
+
+`VoiceChatUIKit` 基于声网 RTC、RTM 引擎、AUIKit 等模块封装，帮助你轻松管理语聊房。
+
+你可以使用 `VoiceChatUIKit` 类中的 API 实现语聊房间的创建、用户进房、退房和销毁等功能。
+
+### 1. 初始化 VoiceChatUIKit
+
+本节展示初始化 `VoiceChatUIKit` 的代码逻辑：
+
+1. 在 `AppDelegate.swift` 文件里导入依赖库：
+
+    ```swift
+    import AUIKitCore
+    import AScenesKit
+    ```
+
+2. 在 `AppDelegate` 类中调用 `VoiceChatUIKit` 类的 `setup` 方法并传入如下参数，初始化 `VoiceChatUIKit`：
+
+    - `roomConfig`：通用配置，包含后端域名地址、用户 ID、用户名、用户头像。
+    - `rtcEngine`：声网 RTC 引擎。
+    - `rtcClient`：声网 RTM 引擎。
+
+    ```swift
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        // 生成一个随机的用户 ID
+        let uid = Int(arc4random_uniform(99999999))
+
+        // 创建一个 AUICommonConfig 实例
+        let commonConfig = AUICommonConfig()
+
+        // 设置 AUICommonConfig 的属性值
+        commonConfig.host = "https://service.agora.io/uikit-voiceroom" // 设置 host url
+        commonConfig.userId = "\(uid)" // 设置用户 ID
+        commonConfig.userName = "user_\(uid)" // 设置用户名
+        commonConfig.userAvatar = "https://accktvpic.oss-cn-beijing.aliyuncs.com/pic/sample_avatar/sample_avatar_1.png" // 设置用户头像
+
+        // 调用 VoiceChatUIKit 的 setup 方法进行初始化设置
+        VoiceChatUIKit.shared.setup(roomConfig: commonConfig,
+                                    rtcEngine: nil,   // 如果有外部初始化的 rtc engine，可以传入该实例
+                                    rtmClient: nil)   // 如果有外部初始化的 rtm client，可以传入该实例
+
+        // 在应用程序启动完成后的自定义逻辑（可根据需要进行覆盖）
+        ...
+
+        return true
+    }
+    ```
+
+### 2. 房主创建房间
+
+本节展示如何让房主创建语聊房。
+
+#### 2.1 添加按钮：创建房间
+
+在 `ViewController.swift` 文件里导入依赖库：
+
+```swift
+import AUIKitCore
+import AScenesKit
+```
+
+在 `ViewController` 类中，通过 iOS 原生方法增加一个「创建房间」按钮，用于让房主点击创建。
+
+```swift
+override func viewDidLoad() {
+    super.viewDidLoad()
+
+    // 作为房主创建房间的按钮
+    let createButton = UIButton(frame: CGRect(x: 10, y: 100, width: 100, height: 60))
+    createButton.setTitle("创建房间", for: .normal)
+    createButton.setTitleColor(.red, for: .normal)
+    createButton.addTarget(self, action: #selector(onCreateAction), for: .touchUpInside)
+    view.addSubview(createButton)
+}
+```
+
+#### 2.2 创建语聊房
+
+在 `ViewController` 类中，调用 `VoiceChatUIKit` 类的 `createRoom` 并传入 `roomInfo` 参数以创建语聊房。`roomInfo` 里需传入房间信息。
+
+如果创建房间成功，那么执行 `enterRoom` 函数。
+
+
+```swift
+@objc func onCreateAction(_ button: UIButton) {
+    // 生成一个随机的房间 ID
+    let roomId = Int(arc4random_uniform(99999999))
+    // 创建一个 AUICreateRoomInfo 实例
+    let room = AUICreateRoomInfo()
+    // 设置房间名为生成的随机房间 ID
+    room.roomName = "\(roomId)"
+    // 禁用按钮，防止重复点击
+    button.isEnabled = false
+
+    // 调用 VoiceChatUIKit 的 createRoom 方法创建房间
+    VoiceChatUIKit.shared.createRoom(roomInfo: room) { roomInfo in
+        // 成功创建房间后的回调
+        self.enterRoom(roomInfo: roomInfo!) // 加入房间
+        button.isEnabled = true // 恢复按钮可用状态
+    } failure: { error in
+        // 创建房间失败的回调
+        print("on create room fail: \(error.localizedDescription)")
+        button.isEnabled = true // 恢复按钮可用状态
+    }
+}
+```
+
+### 3. 加入房间
+
+本节展示如何让房主加入语聊房。
+
+#### 3.1 声明属性
+
+在 `ViewController` 类中声明了一个可选属性，用于存储 `AUIVoiceChatRoomView` 实例以显示语聊房的详情界面。
+
+```swift
+class ViewController: UIViewController {
+    var voiceChatView: AUIVoiceChatRoomView?
+    ...
+}
+```
+
+#### 3.2 创建房间详情页并启动房间
+
+在 `ViewController` 中，创建一个 `AUIVoiceChatRoomView` 实例，并将它设置为 `voiceChatView` 属性，用于显示语聊房的详情界面。
+
+调用 `VoiceChatUIKit` 类的 `launchRoom` 方法，并传入以下参数，以启动语聊房：
+
+- `roomInfo`：房间信息。包含如下：
+  - `roomId`：房间 ID。
+  - `owner`：房主信息。
+  - `memberCount`：房间内的人数。
+  - `createTime`：房间创建的时间（毫秒）。
+- `voiceChatView`：房间的 UI View。
+
+
+```swift
+func enterRoom(roomInfo: AUIRoomInfo) {
+    // 创建一个 AUIVoiceChatRoomView 实例，并设置其 frame 为当前视图的边界
+    voiceChatView = AUIVoiceChatRoomView(frame: self.view.bounds)
+
+    if let roomView = self.voiceChatView {
+        // 调用 VoiceChatUIKit 的 launchRoom 方法，启动房间
+        VoiceChatUIKit.shared.launchRoom(roomInfo: roomInfo,
+                                         roomView: roomView) { [weak self] error in
+            guard let self = self else { return }
+            // 如果出现错误，直接返回
+            if let _ = error { return }
+
+            // 将 roomView 添加到当前视图中
+            self.view.addSubview(roomView)
+        }
+    }
+}
+```
+
+### 4. （可选）听众加入房间
+
+本节展示如何让听众加入已存在的房间。
+
+#### 4.1 添加按钮：加入房间
+
+在 `ViewController` 类中，通过 iOS 原生方法增加一个「加入房间」按钮，用于让听众点击加入。
+
+```swift
+override func viewDidLoad() {
+    super.viewDidLoad()
+
+    // 作为房主创建房间的按钮
+    let createButton = UIButton(frame: CGRect(x: 10, y: 100, width: 100, height: 60))
+    createButton.setTitle("创建房间", for: .normal)
+    createButton.setTitleColor(.red, for: .normal)
+    createButton.addTarget(self, action: #selector(onCreateAction), for: .touchUpInside)
+    view.addSubview(createButton)
+
+    // highlight-start
+    // 作为听众加入房间的按钮
+    let joinButton = UIButton(frame: CGRect(x: 10, y: 160, width: 100, height: 60))
+    joinButton.setTitle("加入房间", for: .normal)
+    joinButton.setTitleColor(.red, for: .normal)
+    joinButton.addTarget(self, action: #selector(onJoinAction), for: .touchUpInside)
+    view.addSubview(joinButton)
+    // highlight-end
+}
+```
+
+
+#### 4.2 获取房间列表
+
+在 `ViewController` 类中，调用 `VoiceChatUIKit` 类的 `getRoomInfoList` 方法并传入如下参数，以获取语聊房间列表：
+
+- `lastCreateTime`：房间列表的起始时间（毫秒）。例如，1681879844085。
+- `pageSize`：每一页房间列表所展示的房间数量。
+
+如果在房间列表中找到匹配的房间名，那么执行 `enterRoom` 函数。通过[此前步骤](#创建房间详情页并启动房间)中已添加的 `enterRoom` 函数即可实现加入房间。
+
+```swift
+@objc func onJoinAction() {
+    // 创建 UIAlertController 实例，用于显示弹出对话框
+    let alertController = UIAlertController(title: "房间名", message: "", preferredStyle: .alert)
+    alertController.addTextField { (textField) in
+        textField.placeholder = "请输入"
+    }
+    // 创建一个「取消」按钮，并指定点击事件
+    let cancelAction = UIAlertAction(title: "取消", style: .cancel) { (_) in
+    }
+    // 创建一个「确认」按钮，并指定点击事件
+    let saveAction = UIAlertAction(title: "确认", style: .default) { (_) in
+        // 获取用户输入的文本内容
+        if let inputText = alertController.textFields?.first?.text {
+            // 处理用户输入的内容
+            VoiceChatUIKit.shared.getRoomInfoList(lastCreateTime: nil, pageSize: 50) { error, roomList in
+                // 检查是否有错误发生，并确保成功获取到了房间列表
+                guard let roomList = roomList else {return}
+                // 遍历房间列表
+                for room in roomList {
+                    // 比对房间名与用户输入的文本内容是否匹配
+                    if room.roomName == inputText {
+                        // 找到匹配的房间名，调用 enterRoom 方法加入房间
+                        self.enterRoom(roomInfo: room)
+                        // 结束循环
+                        break
+                    }
+                }
+            }
+        }
+    }
+
+    // 将「取消」按钮添加到弹出对话框
+    alertController.addAction(cancelAction)
+    // 将「确认」按钮添加到弹出对话框
+    alertController.addAction(saveAction)
+    // 在当前视图上显示弹出对话框
+    present(alertController, animated: true, completion: nil)
+}
+```
+
+### 5. （可选）退出或销毁房间
+
+本节展示如何退出并销毁房间。
+
+在语聊房中，房主可以主动销毁房间，房间销毁时听众会被动退出房间。房间存在时，听众也可以主动退出房间。
+
+
+#### 5.1 主动退出或销毁房间
+
+在 `enterRoom` 函数中添加如下高亮的几行代码，即可实现通过点击按钮主动退出房间（听众）或销毁房间（房主）。
+
+```swift
+func enterRoom(roomInfo: AUIRoomInfo) {
+    // 创建一个 AUIVoiceChatRoomView 实例，并设置其 frame 为当前视图的边界
+    voiceChatView = AUIVoiceChatRoomView(frame: self.view.bounds)
+
+    // highlight-start
+    // 点击退出房间按钮
+    voiceChatView?.onClickOffButton = { [weak self] in
+            self?.destroyRoom(roomId: roomInfo.roomId)
+        }
+    // highlight-end
+
+    if let roomView = self.voiceChatView {
+        // 调用 VoiceChatUIKit 的 launchRoom 方法，启动房间
+        VoiceChatUIKit.shared.launchRoom(roomInfo: roomInfo,
+                                         roomView: roomView) { [weak self] error in
+            guard let self = self else { return }
+            // 如果出现错误，直接返回
+            if let _ = error { return }
+
+            // 将 roomView 添加到当前视图中
+            self.view.addSubview(roomView)
+        }
+    }
+}
+```
+
+
+#### 5.2 被动退出房间
+
+听众被动退出房间的代码逻辑如下：
+
+1. 在 `enterRoom` 函数中添加如下高亮的代码行。调用 `VoiceChatUIKit` 类的 `bindRespDelegate` 方法，订阅房间被销毁的回调。
+
+    ```swift
+    func enterRoom(roomInfo: AUIRoomInfo) {
+        // 创建一个 AUIVoiceChatRoomView 实例，并设置其 frame 为当前视图的边界
+        voiceChatView = AUIVoiceChatRoomView(frame: self.view.bounds)
+
+        // highlight-start
+        // 点击退出房间按钮
+        voiceChatView?.onClickOffButton = { [weak self] in
+                self?.destroyRoom(roomId: roomInfo.roomId)
+            }
+        // highlight-end
+
+        if let roomView = self.voiceChatView {
+            // 调用 VoiceChatUIKit 的 launchRoom 方法，启动房间
+            VoiceChatUIKit.shared.launchRoom(roomInfo: roomInfo,
+                                             roomView: roomView) { [weak self] error in
+                guard let self = self else { return }
+                // 如果出现错误，直接返回
+                if let _ = error { return }
+                // highlight-start
+                VoiceChatUIKit.shared.bindRespDelegate(delegate: self)
+                // highlight-end
+                // 将 roomView 添加到当前视图中
+                self.view.addSubview(roomView)
+            }
+        }
+    }
+    ```
+
+2. 在 `ViewController` 文件中，通过 `AUIRoomManagerRespDelegate` 监听如下事件：
+
+    - `onRoomDestroy`：房间被房主销毁事件。
+    - `onRoomUserBeKicked`：听众被房主踢出房间时间。
+
+    当监听到这些事件时，执行 `destroyRoom` 函数。
+
+    ```swift
+    extension ViewController: AUIRoomManagerRespDelegate {
+        // 房间销毁回调
+        @objc func onRoomDestroy(roomId: String) {
+            self.destroyRoom(roomId: roomId)
+        }
+        // 听众被房主踢出房间回调
+        @objc func onRoomUserBeKicked(roomId: String,userId: String) {
+            self.destroyRoom(roomId: roomId)
+        }
+    }
+    ```
+
+3. 在 `ViewController` 类中，增加 `destroyRoom` 函数。在该函数中，调用 `VoiceChatUIKit` 类的 `unbindRespDelegate` 方法，取消订阅房间被销毁的回调。
+
+    ```swift
+    func destroyRoom(roomId: String) {
+        // 在退出房间时取消订阅，调用 VoiceChatUIKit 的 unbindRespDelegate 方法
+        VoiceChatUIKit.shared.unbindRespDelegate(delegate: self)
+    }
+    ```
+
+#### 5.3 添加销毁逻辑
+
+在 `destroyRoom` 函数中，添加如下高亮的几行代码。调用 `VoiceChatUIKit` 类的 `destoryRoom` 方法并传入房间 ID，以销毁房间。至此，`destroyRoom` 函数的代码补充完成。
+
+```swift
+func destroyRoom(roomId: String) {
+    // highlight-start
+    // 点击退出，调用 VoiceChatView 的 onBackAction 方法
+    self.VoiceChatView?.onBackAction()
+
+    // 将 VoiceChatView 从父视图中移除
+    self.VoiceChatView?.removeFromSuperview()
+
+    // 调用 VoiceChatUIKit 的 destoryRoom 方法销毁房间，传入房间 ID
+    VoiceChatUIKit.shared.destoryRoom(roomId: roomId)
+    // highlight-end
+
+    // 在退出房间时取消订阅，调用 VoiceChatUIKit 的 unbindRespDelegate 方法
+    VoiceChatUIKit.shared.unbindRespDelegate(delegate: self)
+}
+```
+
+## 注意事项
+
+### 加速 Pod
+
+为加速 Pod 命令的执行结果，建议你使用国内镜像源，步骤如下：
+
+1. 打开 `Podfile` 文件，更改 source 为国内镜像源
+
+    ```shell
+    # 移除官方源
+    # source 'https://github.com/CocoaPods/Specs.git'
+
+    # 使用国内镜像源
+    source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
+    ```
+
+2. 保存并退出 `Podfile`，重新执行 Pod 命令安装依赖库。
+
+### 问题排查
+
+如果在 Xcode 15 编译项目时遇到 `Sandbox: rsync.samba(47334) deny(1) file-write-create...` 报错信息，你可以依次进行如下操作：
+
+1. 在 Xcode 中选中 **PROJECT**，点击 **Build Settings**，在 Filter 搜索框中搜索 User Script Sandboxing，将该选项设为 **No**。
+2. 选中 **TARGETS**，检查并确保 User Script Sandboxing 的设置为 **No**。
+
+![](https://web-cdn.agora.io/docs-files/1697685882007)
+
+### 后端部署
+
+为方便你快速集成语聊房，声网已经帮你部署好后端，无需你进行操作。
+
+声网在示例项目中提供的后端服务 host url（`https://service.agora.io/uikit-voiceroom`）仅用于测试体验，请你不要商用。
+
+如需将项目商用，请参考[配置示例项目](../get-started/run-github-project#配置示例项目)部署后端并在项目中配置你的后端服务 host url。
+
+## 下一步
+
+在创建、进入房间后，你可以参考如下业务流程图开发后续的麦位管理、聊天、礼物等功能。
+
+![](https://web-cdn.agora.io/docs-files/1697095578162)
\ No newline at end of file
diff --git a/markdown/chatroom/AUIVoiceRoom/uivoice_overview.md b/markdown/chatroom/AUIVoiceRoom/uivoice_overview.md
new file mode 100644
index 00000000000..cf2fb7ec9c9
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/uivoice_overview.md
@@ -0,0 +1,9 @@
+声动语聊解决方案提供了同时支持含 UI 和无 UI 组件的集成方案。
+
+声网语聊 UI 组件（AUIVoiceRoom）是声网为语聊场景开发的开源 UI 组件。该组件已集成声网的[实时互动（RTC）](https://doc.shengwang.cn/doc/rtc/homepage)、[实时消息（RTM）](https://doc.shengwang.cn/doc/rtm2/homepage)和[环信 IM](http://docs-im-beta.easemob.com/product/introduction.html) 等产品，提供房间管理、麦位控制、聊天打赏、音频特效等核心功能。
+
+相较于无 UI 组件的集成方案，含 UI 组件的语聊集成方案具有以下特点和优势：
+
+- **模块化的 UI**：支持你使用语聊 UI 组件提供的互动、送礼物、直播等模块化的 UI 快速搭建语聊业务逻辑，就像搭积木一样灵活方便。
+- **低学习成本、短开发时间**：无需深入理解模型层逻辑即可自定义 UI。只需修改几行代码，便可在几分钟内运行 AUIVoiceRoom 的示例项目。声网推荐开发者在人力有限或项目周期紧迫的情况下选择含 UI 组件的方案。
+- **强大的拓展性**：当有更灵活的自定义需求时，可以利用 AUIKit 提供的 UI 和 Service 组件进行进一步开发。
diff --git a/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_android.md b/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_android.md
new file mode 100644
index 00000000000..07d3a6d1c85
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_android.md
@@ -0,0 +1,54 @@
+本文介绍如何快速跑通 [AUIVoiceRoom/Android](https://github.com/AgoraIO-Community/AUIVoiceRoom/tree/main/Android) 示例项目，体验在线语聊房。
+
+如需更深入了解项目代码，请参考 [AScenesKit](https://github.com/AgoraIO-Community/AUIVoiceRoom/tree/main/Android/asceneskit) 和 [AUIKit](https://github.com/AgoraIO-Community/AUIKit/blob/main/Android/README.zh.md)。
+
+## 项目技术架构
+
+同 iOS //TODO
+
+
+## 前提条件
+
+- [Git](https://git-scm.com/downloads)
+- [Java Development Kit](https://www.oracle.com/java/technologies/javase-downloads.html)
+- [Android Studio](https://developer.android.com/studio/) 4.1 及以上
+- Android 手机，版本 Android 5.0（API Level 21）及以上
+- 有效的声网[开发者账号](https://docs.agora.io/cn/Agora%20Platform/sign_in_and_sign_up)
+
+<div class="alert note">声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。</div>
+
+
+## 克隆仓库
+
+在根目录下运行以下命令克隆 `AUIVoiceRoom` 仓库到本地：
+
+```shell
+git clone git@github.com:AgoraIO-Community/AUIVoiceRoom.git
+```
+
+
+## 配置示例项目
+
+1. 参考[使用语聊后端服务](//TODO)进行部署。
+
+2. 创建 `AUIVoiceRoom/Android/local.properties` 文件并在该文件中设置你的后端服务主机地址：
+
+    ```text
+    SERVER_HOST= "Your_Host_Url"
+    ```
+
+    如果你暂时无意部署后端服务，可以使用 `https://service.agora.io/uikit-voiceroom`。这是声网为测试体验提供的地址，请你不要商用。
+
+
+## 编译并运行示例项目
+
+1. 开启 Android 设备的开发者选项，打开 USB 调试，通过 USB 连接线将 Android 设备接入电脑。
+
+2. 用 Android Studio 打开 `AUIVoiceRoom/Android` 文件夹。
+
+3. 在 Android Studio 中，点击 **Sync Project with Gradle Files** 按钮，以让项目与 Gradle 文件同步。
+
+4. 待同步成功后，点击 `Run 'app'`。片刻后，语聊应用便会安装到你的 Android 设备上。
+
+5. 打开应用，即可进行体验。房主可以创建语聊房；观众可以加入语聊房。
+
diff --git a/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_backend.md b/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_backend.md
new file mode 100644
index 00000000000..712510d125d
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_backend.md
@@ -0,0 +1,261 @@
+本文介绍如何使用语聊 UI Kit 的后端服务。源代码你可参考 [AUIVoiceRoom/backend](https://github.com/AgoraIO-Community/AUIVoiceRoom/tree/main/backend)。
+
+## 项目简介
+
+`AUIVoiceRoom/backend` 项目基于 Spring Boot 框架开发，依赖以下组件或服务：
+
+- Redis：用于定时刷新在线人数并通过分布式锁方式保证数据更新的一致性。
+- MongoDB：用于维护房间列表。
+- 声网实时消息（RTM）：提供场景数据存储和消息传输通道。
+- 环信 IM：用于提供聊天服务功能。
+- 声网消息通知服务：用于处理人员进出和房间销毁逻辑，并通过声网 RTC 频道事件回调通知相关操作。
+
+如果你想深入了解项目源代码，可以参考[项目文件介绍](#项目文件介绍)。
+
+## 服务部署
+
+### 1. 快速体验
+
+本节介绍如何快速体验示例项目中已经搭建好的后端服务。
+
+#### 前提条件
+
+请确保已经安装如下环境或工具：
+
+- Docker 环境
+- 最新版 [docker-compose](https://docs.docker.com/compose/) 工具
+
+你可以直接下载安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 工具，它已默认安装 docker-compose。
+
+
+#### 运行步骤
+
+以下是运行服务的步骤：
+
+1. 在项目根目录创建 `.env` 文件，并填入以下字段：
+
+    ```
+    TOKEN_APPID=<Your_App_ID>
+    TOKEN_APPCERTIFICATE=<Your_App_Certificate>
+    TOKEN_BASICAUTH_USERNAME=<Your_BasicAuth_Username>
+    TOKEN_BASICAUTH_PASSWORD=<Your_BasicAuth_Password>
+    NCS_SECRET=<Your_NCS_Secret>
+    EM_AUTH_APPKEY=<Your_IM_Auth_AppKey>
+    EM_AUTH_CLIENTID=<Your_IM_Auth_ClientID>
+    EM_AUTH_CLIENTSECRET=<Your_IM_Auth_ClientSecret>
+    ```
+
+    你可以在[开通声网服务](//TODO)后，获取这些字段的值，详情如下：
+
+
+    | 字段名                   | 字段描述         | 获取方式    |
+    |----------------------|-----------------------|----------------------------------|
+    | `TOKEN_APPID`          | 声网项目的 App ID，用于登录 RTC 和 RTM 系统                 |[获取 App ID](https://docportal.shengwang.cn/cn/Agora%20Platform/get_appid_token?platform=All%20Platforms#获取-app-id) |
+    | `TOKEN_APPCERTIFICATE` | 声网项目的 App 证书，用于登录 RTC 和 RTM 系统                            | [获取 App 证书](https://docportal.shengwang.cn/cn/Agora%20Platform/get_appid_token?platform=All%20Platforms#获取-app-证书) |
+    | `TOKEN_BASICAUTH_USERNAME` | [声网频道管理 RESTful 服务](https://doc.shengwang.cn/doc/rtc/restful/best-practice/user-privilege)所需的客户 ID，用于实现封禁 RTC 频道内的用户权限              | [生成客户 ID 和密钥](https://doc.shengwang.cn/doc/rtc/restful/get-started/enable-service#获取客户-id-和客户密钥) |
+    | `TOKEN_BASICAUTH_PASSWORD` | [声网频道管理 RESTful 服务](https://doc.shengwang.cn/doc/rtc/restful/best-practice/user-privilege)所需的客户密钥，用于实现封禁 RTC 频道内的用户权限               | [生成客户 ID 和密钥](https://doc.shengwang.cn/doc/rtc/restful/get-started/enable-service#获取客户-id-和客户密钥) |
+    | `NCS_SECRET`           | 声网消息通知服务的密钥，用于保障消息通知服务安全性                     | [验证签名](https://doc.shengwang.cn/doc/rtc/restful/advanced-features/webhook#验证签名) |
+    | `EM_AUTH_APPKEY`       | 环信 IM 服务的 App Key，用于创建 IM 聊天室                        | [获取 IM 信息](https://docs-im-beta.easemob.com/document/server-side/enable_and_configure_IM.html#获取环信即时通讯-im-的信息) |
+    | `EM_AUTH_CLIENTID`     | 环信 IM 服务的 Client ID，用于创建 IM 聊天室                        | 登录[环信管理后台](https://console.easemob.com/user/login)到**应用列表** > **查看**获取 |
+    | `EM_AUTH_CLIENTSECRET` | 环信 IM 服务的 Client Secret，用于创建 IM 聊天室                     | 登录[环信管理后台](https://console.easemob.com/user/login)到**应用列表** > **查看**获取 |
+
+    在体验阶段，你可以根据需求选择是否开通声网消息通知、声网 RTM、环信 IM 服务。如果未开通这些服务，你会受到如下影响：
+
+    - 如果未开启声网消息通知服务，将无法自动处理用户进出房间和房间销毁的逻辑。
+    - 如果未开启 RTM 和 IM 服务，功能体验会受限。
+
+2. 在项目根目录下执行以下命令启动服务：
+
+    ```shell
+    docker compose up -d --build
+    ```
+
+    该命令会拉取所需的镜像并启动 Redis、MongoDB 和 Web 服务。如果遇到镜像拉取失败的问题，你可以通过配置国内镜像源解决。
+
+3. 服务启动后，继续输入如下命令进行测试：
+
+    ```shell
+    curl http://localhost:8080/health/check
+    ```
+
+4. 如果你需要使用移动端 App 调试本地服务，你需要将移动端 App 上对应的后端服务域名替换成如下：
+
+    ```http
+    http://{your_ip}:8080
+    ```
+
+    `your_ip` 为本地运行服务的机器 IP 地址。
+
+5. 如果你需要停止服务，执行如下命令：
+
+    ```shell
+    docker compose down
+    ```
+
+
+### 2. 本地开发
+
+本节介绍如何通过 Visual Studio Code（简称 VS Code）工具在本地开发语聊后端服务。如果你使用其他工具，你也可以参考本节步骤进行相应操作。
+
+#### 前提条件
+
+除了满足[上一步的前提条件](#前提条件)外，还需确保已经安装如下环境或工具：
+
+- Java 11 或之后
+- VS Code 和如下插件：
+    - Dev Containers
+    - Extension Pack for Java
+
+Dev Containers 插件允许你在 Linux 环境的 Docker 容器中进行开发。因为 RTM 服务的运行依赖于 Linux 环境，所以使用 VS Code 工具开发时建议你安装 Dev Containers。
+
+#### 开发步骤
+
+以下是本地开发的步骤：
+
+1. 使用 VS Code 中打开项目目录，并进入容器开发模式。
+
+    在 Docker 容器中开发时可以使用示例项目中的 [Dockerfile](https://github.com/AgoraIO-Community/AUIVoiceRoom/blob/main/backend/Dockerfile_Dev)，相关配置项已经在该文件中设置。
+
+2. 修改 [application.yml](https://github.com/AgoraIO-Community/AUIVoiceRoom/blob/main/backend/src/main/resources/application.yml) 配置文件中的以下内容：
+
+   - `spring.data.mongodb.uri`：将应用连接到数据库。
+   - `spring.redis.host`：配置 Redis 缓存。
+   - `spring.redis.password`：配置 Redis 缓存。
+   - `ncs.secret`
+   - `token.appId`
+   - `token.appCertificate`
+   - `token.basicAuth.username`
+   - `token.basicAuth.password`
+   - `em.auth.appKey`
+   - `em.auth.clientId`
+   - `em.auth.clientSecret`
+
+    `spring.*` 之外的内容含义详见[字段描述](#运行步骤)。
+
+3. 构建并运行 Spring Boot 应用。
+
+
+### 3. 上线部署
+
+完成本地开发后，你还需要进行以下操作才能将服务部署上线：
+
+1. 确保已[开通所有声网服务](//TODO)，并根据[本地开发中的步骤 2](#开发步骤) 检查 `application.yml` 中字段内容填写无误。
+
+2. 调整 Redis 和 MongoDB 配置。
+
+3. 将服务部署在网关。网关可提供鉴权和限流等能力。本示例项目中展示的服务暂时未包含网关能力。
+
+4. 设置指标收集。通过 `https://{your_hostname}:9090/metrics/prometheus` 收集指标进行服务监控。
+
+5. 将服务部署在云平台，例如[阿里云容器服务（ACK）](https://www.alibabacloud.com/zh/product/kubernetes)。
+
+
+## 项目文件介绍
+
+本节介绍 `AUIVoiceRoom/backend` 下目录结构和各文件用途。
+
+```
+├── Dockerfile
+├── Dockerfile_Dev
+├── HELP.md
+├── README.md
+├── README_zh.md
+├── docker-compose.yaml
+├── init-mongo.js
+├── mvn_settings.xml
+├── mvnw
+├── mvnw.cmd
+├── pom.xml
+└── src
+    ├── main
+    │         ├── java
+    │         │         └── io
+    │         │             └── agora
+    │         │                 └── uikit
+    │         │                     ├── Application.java
+    │         │                     ├── bean
+    │         │                     │         ├── domain                                        // 领域对象
+    │         │                     │         ├── dto                                           // 数据传输对象
+    │         │                     │         ├── entity                                        // 实体对象
+    │         │                     │         ├── enums                                         // 枚举
+    │         │                     │         ├── exception                                     // 异常
+    │         │                     │         ├── process                                       // 业务逻辑
+    │         │                     │         ├── req                                           // 请求对象
+    │         │                     │         └── valid                                         // 参数校验
+    │         │                     ├── config
+    │         │                     │         ├── EmServiceConfig.java                          // 环信 IM 配置
+    │         │                     │         ├── GlobalExceptionHandler.java                   // 全局异常处理
+    │         │                     │         ├── RedisConfig.java                              // Redis 配置
+    │         │                     │         ├── RtcChannelAPIClient.java                      // RTC 频道 API 客户端
+    │         │                     │         └── WebMvcConfig.java                             // Web MVC 配置
+    │         │                     ├── controller
+    │         │                     │         ├── ApplicationController.java                    // 申请控制器
+    │         │                     │         ├── ChatRoomController.java                       // 聊天室控制器
+    │         │                     │         ├── ChorusController.java                         // 合唱控制器
+    │         │                     │         ├── GiftController.java                           // 礼物控制器
+    │         │                     │         ├── HealthController.java                         // 健康检查控制器
+    │         │                     │         ├── InvitationController.java                     // 邀请控制器
+    │         │                     │         ├── MicSeatController.java                        // 麦位控制器
+    │         │                     │         ├── NcsController.java                            // 消息通知服务（NCS）控制器
+    │         │                     │         ├── RoomController.java                           // 房间控制器
+    │         │                     │         ├── SongController.java                           // 歌曲控制器
+    │         │                     │         ├── TokenController.java                          // Token 控制器
+    │         │                     │         └── UserController.java                           // 用户控制器
+    │         │                     ├── interceptor                                             // 拦截器
+    │         │                     │         ├── PrometheusMetricInterceptor.java              // 指标拦截器
+    │         │                     │         └── TraceIdInterceptor.java                       // 链路追踪拦截器
+    │         │                     ├── metric                                                  // 指标
+    │         │                     │         └── PrometheusMetric.java
+    │         │                     ├── repository                                              // 数据库操作
+    │         │                     │         └── RoomListRepository.java
+    │         │                     ├── service
+    │         │                     │         ├── IApplicationService.java                      // 申请服务
+    │         │                     │         ├── IChatRoomService.java                         // 聊天室服务
+    │         │                     │         ├── IChorusService.java                           // 合唱服务
+    │         │                     │         ├── IGiftService.java                             // 礼物服务
+    │         │                     │         ├── IIMService.java                               // IM 服务
+    │         │                     │         ├── IInvitationService.java                       // 邀请服务
+    │         │                     │         ├── IMicSeatService.java                          // 麦位服务
+    │         │                     │         ├── INcsService.java                              // 消息通知服务（NCS）服务
+    │         │                     │         ├── IProcessService.java                          // 申请、邀请业务处理服务
+    │         │                     │         ├── IRoomService.java                             // 房间服务
+    │         │                     │         ├── IRtcChannelAPIService.java                    // RTC 频道管理服务
+    │         │                     │         ├── IRtcChannelService.java                       // RTC 频道服务
+    │         │                     │         ├── IService.java
+    │         │                     │         ├── ISongService.java                             // 歌曲服务
+    │         │                     │         ├── ITokenService.java                            // Token 服务
+    │         │                     │         ├── IUserService.java                             // 用户服务
+    │         │                     │         └── impl
+    │         │                     │             ├── ApplicationServiceImpl.java
+    │         │                     │             ├── ChatRoomServiceImpl.java
+    │         │                     │             ├── ChorusServiceImpl.java
+    │         │                     │             ├── GiftServiceImpl.java
+    │         │                     │             ├── IMServiceImpl.java
+    │         │                     │             ├── InvitationServiceImpl.java
+    │         │                     │             ├── MicSeatServiceImpl.java
+    │         │                     │             ├── NcsServiceImpl.java
+    │         │                     │             ├── ProcessServiceImpl.java
+    │         │                     │             ├── RoomServiceImpl.java
+    │         │                     │             ├── RtcChannelServiceImpl.java
+    │         │                     │             ├── SongServiceImpl.java
+    │         │                     │             ├── TokenServiceImpl.java
+    │         │                     │             └── UserServiceImpl.java
+    │         │                     ├── task                                    // 定时任务
+    │         │                     │         └── RoomListTask.java             // 房间列表定时任务
+    │         │                     └── utils
+    │         │                         ├── HmacShaUtil.java                    // HmacSha1 加密工具
+    │         │                         ├── RedisUtil.java                      // Redis 工具
+    │         │                         ├── RtmUtil.java                        // RTM 工具
+    │         │                         └── TokenUtil.java                      // Token 工具
+    │         └── resources
+    │             ├── application.yml                                           // 默认配置文件
+    │             ├── lib                                                       // RTM SDK 文件
+    │             │         ├── agora-rtm-sdk.jar
+    │             │         ├── libagora-fdkaac.so
+    │             │         ├── libagora-ffmpeg.so
+    │             │         ├── libagora-soundtouch.so
+    │             │         ├── libagora_rtc_sdk.so
+    │             │         └── libagora_rtm_sdk.so
+    │             └── logback-spring.xml                                        // 日志配置
+    └── test                                                                    // 单元测试
+```
\ No newline at end of file
diff --git a/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_ios.md b/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_ios.md
new file mode 100644
index 00000000000..d138cce1e64
--- /dev/null
+++ b/markdown/chatroom/AUIVoiceRoom/uivoice_run_github_project_ios.md
@@ -0,0 +1,66 @@
+本文介绍如何快速跑通 [AUIVoiceRoom/iOS](https://github.com/AgoraIO-Community/AUIVoiceRoom/tree/main/iOS) 示例项目，体验在线语聊房。
+
+如需更深入了解项目代码，请参考 [AScenesKit](https://github.com/AgoraIO-Community/AUIVoiceRoom/tree/main/iOS/AScenesKit) 和 [AUIKit](https://github.com/AgoraIO-Community/AUIKit/blob/main/iOS/README_zh.md)。
+
+## 项目技术架构
+
+![](https://web-cdn.agora.io/docs-files/1697538180703)
+
+架构图含义如下：
+
+- `AUIVoiceRoom`：代表语聊房 App。
+    - Controller：用于管理语聊 App 中房间列表页面和单个房间的详情页面。
+- `AScenesKit`：为语聊场景提供业务逻辑的组装模块。
+    - `VoiceChatUIKit`：负责统一调度 `VoiceChatRoomView` 和 `VoiceChatRoomService`，并管理房间。
+    - `VoiceChatRoomView`：语聊房的容器 View。用于管理 AUIKit 提供的 UI。
+    - `VoiceChatRoomService`：语聊房的 Service。用于管理 AUIKit 提供的 Service。
+    - ViewBinder：用于将 `VoiceChatRoomView` 和 `VoiceChatRoomService` 绑定。
+- `AUIKit`：基础库。
+    - UI：基础 UI 组件。
+    - Service：上麦、聊天、送礼物等业务能力。
+
+
+## 前提条件
+
+- [Git](https://git-scm.com/downloads)
+- [CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started)
+- [Xcode](https://apps.apple.com/cn/app/xcode/id497799835?mt=12) 13.0 及以上
+- iOS 设备，版本 13.0 及以上
+- 有效的苹果开发者账号
+- 有效的声网[开发者账号](https://docs.agora.io/cn/Agora%20Platform/sign_in_and_sign_up)
+
+<div class="alert note">声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。</div>
+
+## 克隆仓库
+
+1. 在根目录下运行以下命令克隆 `AUIVoiceRoom` 仓库到本地：
+
+    ```shell
+    git clone git@github.com:AgoraIO-Community/AUIVoiceRoom.git
+    ```
+
+2. 在 `AUIVoiceRoom/iOS/AUIVoiceRoom` 目录下运行 `pod update`，然后等待依赖库安装完成。
+
+## 配置示例项目
+
+1. 参考[使用语聊后端服务](//TODO)进行部署。
+
+2. 在 `AUIVoiceRoom/iOS/AUIVoiceRoom/AUIVoiceRoom/KeyCenter.swift` 文件中设置你的后端服务主机地址：
+
+    ```swift
+    static var HostUrl: String = <#Your Host Url#>
+    ```
+
+    如果你暂无意部署后端服务，可以使用 `KeyCenter.swift` 里默认的地址。默认地址仅用于测试体验，请你不要商用。
+
+## 编译并运行示例项目
+
+1. 连接上 iOS 设备，点击 `AUIVoiceRoom.xcworkspace` 文件以通过 Xcode 打开项目，并在 **iOS Device** 选项中勾选上你的 iOS 设备。
+
+2. 在项目 **TARGETS** 下的 **Signing & Capabilities** 界面勾选 **Automatically manage signing**，配置你的苹果开发者账号和 **Bundle Identifier**。Bundle ID 用于在设备上唯一标识应用程序。在开发应用时，你需要设置 Bundle ID。
+
+3. 点击 <img src="https://web-cdn.agora.io/docs-files/1639710560035" width="25" style="display: inline;"/> 开始编译。
+
+4. 编译成功后，你的 iOS 设备上会出现语聊应用。在 iOS 系统设置中将该应用设为信任开发者后你才能打开应用。
+
+5. 打开应用，即可进行体验。房主可以创建语聊房；观众可以加入语聊房。
\ No newline at end of file
diff --git "a/markdown/chatroom/Android\346\227\266\345\272\217\345\233\276.wsd" "b/markdown/chatroom/Android\346\227\266\345\272\217\345\233\276.wsd"
new file mode 100644
index 00000000000..6a451603513
--- /dev/null
+++ "b/markdown/chatroom/Android\346\227\266\345\272\217\345\233\276.wsd"
@@ -0,0 +1,40 @@
+@startuml
+autonumber
+participant "App" as a
+participant "声网云服务\n（Service）" as b #White
+participant "声网 IM SDK" as c
+participant "声网 RTC SDK" as d
+== 获取房间列表 ==
+a -> b: 获取房间列表 \ngetRoomList
+b -->> a: 显示房间列表
+== 登录 IM 系统 ==
+a -> c: ChatClient.getInstance().loginWithToken()
+c -->> a: 登录成功
+== 初始化 AgoraRtcEngineKit ==
+a -> d: RtcEngine.create()
+d -->> a: 初始化成功
+== 创建并进入房间 ==
+a -> b: 创建房间 \ncreateRoom
+b -->> a: 创建房间成功
+a -> b: 加入房间 \njoinRoom
+b -->> a: 加入房间成功
+a -> c: 加入聊天室 \njoinChatroom
+a -> d: 加入频道 \njoinChannel
+c -->> a: 加入聊天室成功
+d -->> a: 加入频道成功
+== 麦位管理 ==
+...
+== 离开语聊房 ==
+a -> b: 离开房间 \nleaveRoom
+a -> d: 离开频道 \nleaveChannel
+a -> c: 离开聊天室 \nleaveChatroom
+a -> c: 销毁聊天室 \nasyncDestroyChatRoom
+a -> d: 销毁 RtcEngine \ndestroy
+b -->> a: 离开房间成功
+d -->> a: 离开频道成功
+c -->> a: 离开聊天室成功
+c -->> a: 销毁聊天室成功
+@enduml
+
+
+
diff --git a/markdown/chatroom/chatroom_faq.md b/markdown/chatroom/chatroom_faq.md
new file mode 100644
index 00000000000..c926a1c43c8
--- /dev/null
+++ b/markdown/chatroom/chatroom_faq.md
@@ -0,0 +1,84 @@
+本文总结使用声动语聊方案时可能遇到的常见问题和解决方法。
+
+## 禁止人声但不禁止背景音乐
+
+### 问题
+
+如何实现某用户调用 [`startAudioMixing`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_startaudiomixing2) 播放背景音乐时，不想让频道内其他人听到自己说话的声音，只想让别人听到自己播放的背景音乐？
+
+### 解决方法
+
+该用户可以调用 [`adjustRecordingSignalVolume`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_adjustrecordingsignalvolume) 将音量设置为 0。
+
+## 禁止人声和背景音乐
+
+### 问题
+
+如何实现某用户调用 [`startAudioMixing`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_startaudiomixing2) 播放背景音乐时，不想让自己说话的声音和背景音乐被频道内其他人听到？
+
+### 解决方法
+
+该用户可以调用 [`muteLocalAudioStream`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_stream_management.html#api_irtcengine_mutelocalaudiostream) 取消发布本地音频流。
+
+## 不听说话者声音
+
+### 问题
+
+如何实现某用户在语聊房间内，想知道谁在说话，但不想听到说话者的声音？
+
+### 解决方法
+
+该用户可以调用 [`adjustUserPlaybackSignalVolume`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_adjustuserplaybacksignalvolume) 设置某个说话者的播放音量为 0，或者调用 [`adjustPlaybackSignalVolume`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_adjustplaybacksignalvolume) 设置频道内所有人的播放音量为 0。
+
+
+## 处理第三方应用音频
+
+### 问题
+
+- 如何实现集成声网 SDK 后，该应用与第三方应用的音频可以同时播放？
+- 如何实现集成声网 SDK 后，使用该应用时会打断第三方应用的音频播放？
+
+### 解决方法
+
+你可以在加入频道前设置如下私有参数：
+
+```cpp
+// 与第三方应用的音频可以同时播放
+setParameters(“{\"che.audio.mix_with_others\": true}”)
+```
+
+```cpp
+// 打断第三方应用的音频播放
+setParameters("{\"che.audio.mix_with_others\":false}")
+```
+
+## 处理第三方播放器音频
+
+### 问题
+
+如果你使用声网 SDK 和第三方播放器集成语聊房应用，那么可能出现用户进入声网 RTC 频道后会自动打断第三方播放器的音视频播放现象，比如使第三方播放器播放卡顿或者不断被打断。如何避免第三方播放器音频被打断？
+
+### 解决方法
+
+你可以在加入频道前设置如下私有参数：
+
+```cpp
+// 防止音频被打断
+setParameters("{\"che.audio.keep.audiosession\":true}");
+```
+
+## 断网重连导致鬼麦
+
+### 问题
+
+当用户使用声动语聊方案时，如果网络突然中断，你的业务服务器会将该用户从正常的用户列表中移除。但是，如果网络恢复，声网会自动进行断线重连，使该用户可以再次加入原来的语聊房间，此时你的业务服务器无法管理该用户，会导致出现“鬼麦”现象。如何避免断网重连导致的“鬼麦”现象？
+
+### 解决方法
+
+如下步骤可以避免断网重连导致的“鬼麦”现象：
+
+1. 通过声网服务让业务服务器将失联用户标记为已离线：
+    - 可以使用声网即时通讯（IM）SDK 判断用户失联的时间。比如，当用户失联超过 30 秒时，业务服务器会将该用户标记为已离线。
+    - 可以使用声网消息通知服务。当用户快断线时，该服务会提前 20 秒告知用户即将离线。此时业务服务器可以做已离线标记。
+
+2. 当用户的网络再次连接时，业务服务器会与之同步该用户的状态。如果业务服务器标记该用户为已离线，该就可以调用 [`leaveChannel`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_core_method.html#api_irtcengine_leavechannel) 让该用户离开原来的频道。从而，避免“鬼麦”现象。
\ No newline at end of file
diff --git a/markdown/chatroom/chatroom_integration_android.md b/markdown/chatroom/chatroom_integration_android.md
new file mode 100644
index 00000000000..f7b993f76a6
--- /dev/null
+++ b/markdown/chatroom/chatroom_integration_android.md
@@ -0,0 +1,336 @@
+本文介绍如何实现语聊房。
+
+## 示例项目
+
+声网在 [agora-ent-scenarios](https://github.com/AgoraIO-Usecase/agora-ent-scenarios) 仓库中提供[语聊房（普通版）](https://github.com/AgoraIO-Usecase/agora-ent-scenarios/tree/v3.1.0-voice-Android/Android/scenes/voice)源代码供你参考。
+
+## 业务流程图
+
+本节展示语聊房中常见的业务流程。
+
+### 进出房间
+
+下图展示创建、进入、退出房间的流程。
+
+![](https://web-cdn.agora.io/docs-files/1690957909911)
+
+### 房主邀请听众上麦
+
+下图展示房主邀请听众上麦的流程。在这个流程中，房主发起上麦邀请，如果听众接受邀请，房主会收到通知。听众上麦并修改麦位，然后发布自己的音频流。
+
+![](https://web-cdn.agora.io/docs-files/1690957919691)
+
+### 听众申请上麦
+
+下图展示听众向房主申请上麦的流程。在这个流程中，听众主动发起上麦申请，如果房主接受申请，房主修改麦位信息以让听众上麦。听众收到上麦消息后，发布自己的音频流。
+
+![](https://web-cdn.agora.io/docs-files/1690957930139)
+
+## 准备开发环境
+
+### 前提条件
+
+- [Android Studio](https://developer.android.com/studio/) 3.5 及以上。
+- Android 手机，版本 Android 5.0（API Level 21）及以上。
+- 可以访问互联网的计算机。确保你的网络环境没有部署防火墙，否则无法正常使用声网服务。
+- 参考[开始使用声网平台](https://docportal.shengwang.cn/cn/Agora%20Platform/get_appid_token?platform=All%20Platforms)创建声网开发者账号和声网项目。
+
+### 创建项目
+
+秀场直播用到声网 RTC SDK 和即时通讯（IM）SDK。本节介绍如何在 Android Studio 创建项目并集成这两个 SDK：
+
+1. 如需创建新项目，在 **Android Studio** 里，依次选择 **Phone and Tablet > Empty Activity**，创建 [Android 项目](https://developer.android.com/studio/projects/create-project)。
+
+   <div class="alert note">创建项目后，<b>Android Studio</b> 会自动开始同步 gradle，稍等片刻至同步成功后再进行下一步操作。</div>
+
+2. 使用 Maven Central 将声网 RTC SDK 和 IM SDK 集成到你的项目中。
+
+   a. 在 `/Gradle Scripts/build.gradle(Project: <projectname>)` 文件中添加如下代码，添加 Maven Central 依赖：
+
+   ```java
+    buildscript {
+        repositories {
+            ...
+            mavenCentral()
+        }
+        ...
+   }
+
+     allprojects {
+        repositories {
+            ...
+            mavenCentral()
+        }
+   }
+   ```
+
+    <div class="alert note">如果你的 Android 项目设置了 <a href="https://docs.gradle.org/current/userguide/declaring_repositories.html#sub:centralized-repository-declaration">dependencyResolutionManagement</a>，添加 Maven Central 依赖的方式可能存在差异。</div>
+
+   b. 在 `/Gradle Scripts/build.gradle(Module: <projectname>.app)` 文件中添加如下代码，将声网 RTC SDK 和 IM SDK 集成到你的 Android 项目中：
+
+   ```java
+   ...
+    dependencies {
+        ...
+        // x.y.z，请填写具体的 RTC SDK 版本号，如：4.0.0 或 4.1.0-1
+        // 通过互动直播产品发版说明获取最新版本号
+        implementation 'io.agora.rtc:full-sdk:x.y.z'
+        // x.y.z，请填写具体的 IM SDK 版本号，如：1.1.0。
+        // 通过即时通讯产品发版说明获取最新版本号
+        implementation 'io.agora.rtc:chat-sdk:x.y.z'
+     }
+   ```
+
+3. 添加网络及设备权限。
+
+   在 `/app/Manifests/AndroidManifest.xml` 文件中，在 `</application>` 后面添加如下权限：
+
+   ```xml
+    <uses-permission android:name="android.permission.INTERNET"/>
+    <uses-permission android:name="android.permission.CAMERA"/>
+    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
+    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
+    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
+    <uses-permission android:name="android.permission.BLUETOOTH"/>
+    <!-- 对于 Android 12.0 及以上且集成 v4.1.0 以下声网 RTC SDK 的设备，还需要添加以下权限 -->
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
+    <!-- 对于 Android 12.0 及以上设备，还需要添加以下权限 -->
+    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
+    <uses-permission android:name="android.permission.BLUETOOTH_SCAN"/>
+   ```
+
+4. 在 `/Gradle Scripts/proguard-rules.pro` 文件中添加如下行，以防止声网 SDK 的代码被混淆：
+
+   ```java
+   -keep class io.agora.**{*;}
+   -dontwarn javax.**
+   -dontwarn com.google.devtools.build.android.**
+   ```
+
+## 实现语聊房
+
+如下[时序图](#api-时序图)展示了如何登录即时通讯系统、获取房间列表、创建房间、进入房间、加入 RTC 频道、麦位管理、退出房间、离开 RTC 频道。声网云服务（Service）实现了房间列表的存储和房间生命周期的管理，声网即时通讯（IM）SDK 实现房间内的信令通信，声网 RTC SDK 承担实时音频的业务。本节会详细介绍如何调用声网云服务（`voiceServiceProtocol`）、IM SDK API、RTC SDK API 完成这些逻辑。
+
+<div class="alert note">声网云服务为内部自研服务，暂不对外提供。你可以调用声网云服务的 API 用于测试，但是对于正式环境，声网建议你参考文档自行实现相似的一套服务。如需协助，请<a href="https://docs.agora.io/cn/Agora%20Platform/ticket?platform=All%20Platforms">提交工单</a>。</div>
+
+
+### 1. 获取房间列表
+
+调用声网云服务中 `voiceServiceProtocol` 类的 `fetchRoomList` 方法获取房间列表。获取到房间列表后刷新 UI 并将房间列表展示在界面上。
+
+```kotlin
+voiceServiceProtocol.fetchRoomList(page, completion = { error, result ->
+    ...
+})
+```
+
+### 2. 登录即时通讯系统
+
+参考如下步骤登录即时通讯（IM）系统：
+
+1. 根据[前提条件](#前提条件)在声网控制台创建声网项目后，参考[开启和配置即时通讯服务](https://docs-preprod.agora.io/cn/agora-chat/enable_agora_chat?platform=All%20Platforms)，在声网控制台为你的声网项目开启并配置即时通讯服务。
+2. 参考[即时通讯集成概述](https://docs-preprod.agora.io/cn/agora-chat/integration_overview_android?platform=Android#用户登录)，获取登录即时通讯系统所需的用户名（ID）和 Token。
+3. 调用声网即时通讯（IM）SDK 中 `ChatClient` 类的 [`loginWithToken`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_java/v1.1.0/classio_1_1agora_1_1chat_1_1_chat_client.html#ac2b19ffdcd879b5f239baacbaa09423b) 方法并传入即时通讯服务的用户名和 Token 以登录即时通讯系统。
+
+
+```kotlin
+public void login(String uid,String token,CallBack callBack){
+    ChatClient.getInstance().loginWithToken(uid, token, new CallBack() {
+        @Override
+        public void onSuccess() {
+            ThreadManager.getInstance().runOnMainThread(new Runnable() {
+                @Override
+                public void run() {
+                    callBack.onSuccess();
+                }
+            });
+            LogTools.d("ChatroomConfigManager","Login success");
+        }
+
+        @Override
+        public void onError(int code, String msg) {
+            ThreadManager.getInstance().runOnMainThread(new Runnable() {
+                @Override
+                public void run() {
+                    callBack.onError(code,msg);
+                }
+            });
+            LogTools.e("ChatroomConfigManager", "Login onError code:" + code + " desc: " + msg);
+        }
+    });
+}
+```
+
+### 3. 初始化 RtcEngine
+
+参考如下步骤初始化 RtcEngine：
+
+1. 根据[前提条件](#前提条件)在声网控制台创建声网项目后，复制界面的 App ID。
+2. 调用声网 RTC SDK 中的 [`create`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_core_method.html#api_irtcengine_initialize) 方法创建并初始化 `RtcEngine`。
+
+```kotlin
+// 初始化配置
+val config = RtcEngineConfig()
+// 设置 App ID
+config.mAppId = "YourAppId"
+// 创建 RtcEngine 实例
+val rtcEngine = RtcEngineEx.create(config) as RtcEngineEx
+```
+
+### 4. 创建并进入房间
+
+1. 调用 `voiceServiceProtocol` 对象中的 `createRoom` 方法创建一个房间。
+
+    ```kotlin
+    val voiceCreateRoomModel = VoiceCreateRoomModel(
+        roomName = roomName,
+        soundEffect = soundEffect,
+        isPrivate = !TextUtils.isEmpty(password),
+        password = password ?: "",
+        roomType = roomType
+    )
+    voiceServiceProtocol.createRoom(voiceCreateRoomModel, completion = { error, result ->
+        when (error) {
+            VoiceServiceProtocol.ERR_OK -> {
+                callBack.onSuccess(createLiveData(result))
+            }
+            VoiceServiceProtocol.ERR_ROOM_NAME_INCORRECT -> {
+                callBack.onError(error, "")
+            }
+            else -> {
+                callBack.onError(error, "")
+            }
+        }
+    })
+    ```
+
+2. 调用 `voiceServiceProtocol` 对象的 `joinRoom` 方法进入房间。
+
+    ```kotlin
+    voiceServiceProtocol.joinRoom(roomId, completion = { error, result ->
+        when (error) {
+            VoiceServiceProtocol.ERR_OK -> {
+                callBack.onSuccess(createLiveData(result))
+            }
+            VoiceServiceProtocol.ERR_ROOM_UNAVAILABLE -> {
+                callBack.onError(error, "room is not existent")
+            }
+            else -> {
+                callBack.onError(error, "")
+            }
+        }
+    })
+    ```
+
+3. 语聊房里需要有消息聊天和语音聊天，因此你还需进行如下操作：
+
+    - 调用声网 IM SDK 中 `joinChatRoom` 实现房间内的消息互动。方法中的参数含义和支持取值请参考 [`joinChatRoom`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_java/v1.1.0/classio_1_1agora_1_1chat_1_1_chat_room_manager.html#a895dbd6d0217ba08bcf2dbb6cf441591)。
+
+        ```kotlin
+        // 实现房间内的消息互动
+        public void joinRoom(String chatroomId, ValueCallBack<ChatRoom> callBack){
+            ChatClient.getInstance().chatroomManager()
+                    .joinChatRoom(chatroomId, new ValueCallBack<ChatRoom>() {
+                        @Override
+                        public void onSuccess(ChatRoom value) {
+                            ThreadManager.getInstance().runOnMainThreadDelay(new Runnable() {
+                                @Override
+                                public void run() {
+                                    callBack.onSuccess(value);
+                                }
+                            },200);
+                        }
+
+                        @Override
+                        public void onError(int error, String errorMsg) {
+                            ThreadManager.getInstance().runOnMainThread(new Runnable() {
+                                @Override
+                                public void run() {
+                                    callBack.onError(error,errorMsg);
+                                }
+                            });
+                        }
+                    });
+        }
+        ```
+
+    - 调用声网 RTC SDK 中 `RtcEngine` 类的 `joinChannel` 加入 RTC 频道以实现房间内的实时音频通话。方法中的参数含义和支持取值请参考 [`joinChannel`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_core_method.html#api_irtcengine_joinchannel)。在这一步里需要填写声网 RTC Token。你可以参考[开始使用声网平台](https://docs.agora.io/cn/Agora%20Platform/get_appid_token?platform=All%20Platforms)从声网控制台获得临时用途的声网 RTC Token。你也可以参考[使用 Token 鉴权](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/token_server_android_ng?platform=Android)获取正式用途的声网 RTC Token。临时 Token 的有效期为 24 小时，建议你仅在测试用途下使用。
+    你还可以调用 [`setChannelProfile`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_core_method.html#api_irtcengine_setchannelprofile)、[`setAudioProfile`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_setaudioprofile2)、[`setAudioScenario`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_setaudioscenario)、[`setParameters`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_network.html#api_irtcengine_setparameters) 来为不同业务场景（语聊社交、KTV、游戏陪玩、专业音频直播场景）设置语聊房的最佳音效。
+
+        ```kotlin
+        // 实现房间内的语音互动
+        rtcEngine?.apply {
+            when (soundEffect) {
+                // 在线 K 歌房和泛娱乐社交场景下推荐设置
+                ConfigConstants.SoundSelection.Social_Chat,
+                ConfigConstants.SoundSelection.Karaoke -> {
+                    // 设置频道属性为直播
+                    setChannelProfile(Constants.CHANNEL_PROFILE_LIVE_BROADCASTING)
+                    // 设置 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 96 Kbps
+                    setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_HIGH_QUALITY)
+                    // 设置为高音质场景
+                    setAudioScenario(Constants.AUDIO_SCENARIO_GAME_STREAMING)
+                }
+                // 1 对 1 游戏陪玩通话场景下推荐
+                ConfigConstants.SoundSelection.Gaming_Buddy -> {
+                    // 设置频道属性为通信
+                    setChannelProfile(Constants.CHANNEL_PROFILE_COMMUNICATION)
+                }
+                else -> {
+                    // 专业音频直播场景下推荐设置
+                    // 设置频道属性为直播
+                    setChannelProfile(Constants.CHANNEL_PROFILE_LIVE_BROADCASTING)
+                    // 指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 128 Kbps
+                    setAudioProfile(Constants.AUDIO_PROFILE_MUSIC_HIGH_QUALITY)
+                    // 设置为高音质场景
+                    setAudioScenario(Constants.AUDIO_SCENARIO_GAME_STREAMING)
+                    // 设置私有参数以获得好的实时音频互动体验
+                    setParameters("{\"che.audio.custom_payload_type\":73}")
+                    setParameters("{\"che.audio.custom_bitrate\":128000}")
+                    setParameters("{\"che.audio.input_channels\":2}")
+                }
+            }
+        }
+        // 加入 RTC 频道
+        // 此处的 Token 为声网 RTC Token
+        val status = rtcEngine?.joinChannel(VoiceBuddyFactory.get().getVoiceBuddy().rtcToken(), channelId, "", rtcUid)
+        ```
+
+### 5. 麦位管理
+
+具体步骤详见[麦位管理](./chatroom_mic_seat_android)。
+
+### 6. 退出房间
+
+1. 调用 `voiceServiceProtocol` 对象的 `leaveRoom` 方法离开房间。
+
+    ```kotlin
+    voiceServiceProtocol.leaveRoom(roomId, isRoomOwnerLeave, completion = { error, result ->
+        ...
+    })
+    ```
+
+
+2. 调用 `RtcEngine` 类的 [`leaveChannel`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_core_method.html#api_irtcengine_leavechannel) 方法离开 RTC 频道。
+
+    ```kotlin
+    rtcEngine?.leaveChannel()
+    ```
+
+3. 调用 [`leaveChatRoom`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_java/v1.1.0/classio_1_1agora_1_1chat_1_1_chat_room_manager.html#a4f2c430782206971480c73a49311b1437) 离开聊天室，调用 [`asyncDestroyChatRoom`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_java/v1.1.0/classio_1_1agora_1_1chat_1_1_chat_room_manager.html?transId=194274c0-bee4-11ed-b167-a39cc89dc96e#a0d50d2e34d9992fc3f8ea1c82e2db1a) 销毁聊天室。调用 [`destroy`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_core_method.html#api_irtcengine_release) 销毁 RTC 引擎。
+
+    ```kotlin
+    ChatroomIMManager.getInstance().leaveChatRoom(roomKitBean.chatroomId)
+    ChatroomIMManager.getInstance().asyncDestroyChatRoom(roomKitBean.chatroomId, object :
+        CallBack {
+        override fun onSuccess() {}
+        override fun onError(code: Int, error: String?) {}
+    })
+    RtcEngineEx.destroy()
+    rtcEngine = null
+    ```
+
+### API 时序图
+
+![](https://web-cdn.agora.io/docs-files/1691399288269)
\ No newline at end of file
diff --git a/markdown/chatroom/chatroom_integration_ios.md b/markdown/chatroom/chatroom_integration_ios.md
new file mode 100644
index 00000000000..8efff9dc3a6
--- /dev/null
+++ b/markdown/chatroom/chatroom_integration_ios.md
@@ -0,0 +1,274 @@
+本文介绍如何实现语聊房。
+
+## 示例项目
+
+声网在 [agora-ent-scenarios](https://github.com/AgoraIO-Usecase/agora-ent-scenarios) 仓库中提供[语聊房（普通版）](https://github.com/AgoraIO-Usecase/agora-ent-scenarios/tree/v3.1.0-voice-iOS/iOS/AgoraEntScenarios/Scenes/VoiceChatRoom)源代码供你参考。
+
+
+## 业务流程图
+
+本节展示语聊房中常见的业务流程。
+
+### 进出房间
+
+下图展示创建、进入、退出房间的流程。
+
+![](https://web-cdn.agora.io/docs-files/1690957909911)
+
+### 房主邀请听众上麦
+
+下图展示房主邀请听众上麦的流程。在这个流程中，房主发起上麦邀请，如果听众接受邀请，房主会收到通知。听众上麦并修改麦位，然后发布自己的音频流。
+
+![](https://web-cdn.agora.io/docs-files/1690957919691)
+
+### 听众申请上麦
+
+下图展示听众向房主申请上麦的流程。在这个流程中，听众主动发起上麦申请，如果房主接受申请，房主修改麦位信息以让听众上麦。听众收到上麦消息后，发布自己的音频流。
+
+![](https://web-cdn.agora.io/docs-files/1690957930139)
+
+## 准备开发环境
+
+### 前提条件
+
+- [Xcode](https://apps.apple.com/cn/app/xcode/id497799835?mt=12) 13.0 及以上。
+- iOS 设备，版本 13.0 及以上。
+- 有效的苹果开发者账号。
+- 可以访问互联网的计算机。确保你的网络环境没有部署防火墙，否则无法正常使用声网服务。
+- 参考[开始使用声网平台](https://docportal.shengwang.cn/cn/Agora%20Platform/get_appid_token?platform=All%20Platforms)创建声网开发者账号和声网项目。
+
+### 创建项目
+
+语聊房用到声网 RTC SDK 和即时通讯（IM）SDK。本节介绍如何在 Xcode 创建项目并集成这两个 SDK：
+
+1. [创建一个新的项目](https://help.apple.com/xcode/mac/current/#/dev07db0e578)，**Application** 选择 **App**，**Interface** 选择 **Storyboard**，**Language** 选择 **Swift**。
+
+    <div class="alert note">如果你没有添加过开发团队信息，会看到 <b>Add account…</b> 按钮。点击该按钮并按照屏幕提示登入 Apple ID，点击 <b>Next</b>，完成后即可选择你的 Apple 账户作为开发团队。</div>
+
+2. 为你的项目设置[自动签名](https://help.apple.com/xcode/mac/current/#/dev23aab79b4)。
+
+3. 设置部署你的 app 的[目标设备](https://help.apple.com/xcode/mac/current/#/deve69552ee5)。
+
+4. 添加项目的设备权限。在项目导航栏中打开 `info.plist` 文件，编辑[属性列表](https://help.apple.com/xcode/mac/current/#/dev3f399a2a6)，添加以下属性：
+
+    | key                                    | type   | value                                                        |
+    | -------------------------------------- | ------ | ------------------------------------------------------------ |
+    | Privacy - Microphone Usage Description | String | 使用麦克风的目的，例如 for a live interactive streaming |
+    | Privacy - Camera Usage Description       | String | 使用摄像头的目的，例如 for a live interactive streaming |
+
+    <div class="alert note"><ul><li>如果你的项目中需要添加第三方插件或库（例如第三方摄像头），且该插件或库的签名与项目的签名不一致，你还需勾选 <b>Hardened Runtime</b> > <b>Runtime Exceptions</b> 中的 <b>Disable Library Validation</b>。</li><li>更多注意事项，可以参考 <a href="https://developer.apple.com/documentation/xcode/preparing_your_app_for_distribution">Preparing Your App for Distribution</a >。</li></ul></div>
+
+5. 将声网 RTC 和即时通讯 SDK 集成到你的项目。开始前请确保你已安装 CocoaPods，如尚未安装 CocoaPods，参考 [Getting Started with CocoaPods](https://guides.cocoapods.org/using/getting-started.html#getting-started) 安装说明。
+
+    1. 在终端里进入项目根目录，并运行 `pod init` 命令。项目文件夹下会生成一个 `Podfile` 文本文件。
+    2. 打开 `Podfile` 文件，修改文件为如下内容。注意将 `Your App` 替换为你的 Target 名称。
+
+        ```shell
+        platform :ios, '11.0'
+        target 'Your App' do
+        # 集成 RTC SDK
+        # x.y.z 请填写具体的 SDK 版本号，如 4.0.1 或 4.0.0.4。
+        # 可通过互动直播发版说明获取最新版本号。
+        pod 'AgoraRtcEngine_iOS', 'x.y.z'
+        # 集成即时通讯 SDK
+        pod 'Agora_Chat_iOS'
+        end
+        ```
+
+6. 在终端内运行 <code>pod install</code> 命令安装 SDK。成功安装后，Terminal 中会显示 <code>Pod installation complete!</code>。
+
+## 实现语聊房
+
+如下[时序图](#api-时序图)展示了如何登录即时通讯系统、获取房间列表、创建房间、进入房间、加入 RTC 频道、麦位管理、退出房间、离开 RTC 频道。声网云服务（Service）实现了房间列表的存储和房间生命周期的管理，声网即时通讯（IM）SDK 实现房间内的信令通信，声网 RTC SDK 承担实时音频的业务。本节会详细介绍如何调用声网云服务（`ChatRoomServiceProtocol`）、IM SDK API、RTC SDK API 完成这些逻辑。
+
+<div class="alert note">声网云服务为内部自研服务，暂不对外提供。你可以调用声网云服务的 API 用于测试，但是对于正式环境，声网建议你参考文档自行实现相似的一套服务。如需协助，请<a href="https://docs.agora.io/cn/Agora%20Platform/ticket?platform=All%20Platforms">提交工单</a>。</div>
+
+
+### 1. 获取房间列表
+
+调用声网云服务中 `ChatRoomServiceImp` 类的 `fetchRoomList` 方法获取房间列表。获取到房间列表后刷新 UI 并将房间列表展示在界面上。
+
+```swift
+ChatRoomServiceImp.getSharedInstance().fetchRoomList(page: 0) { error, rooms in
+    self.roomList.refreshControl?.endRefreshing()
+    if error == nil {
+        guard let rooms = rooms else {return}
+        let roomsEntity: VRRoomsEntity = VRRoomsEntity()
+        roomsEntity.rooms = rooms
+        roomsEntity.total = rooms.count
+        self.fillDataSource(rooms: roomsEntity)
+        self.roomList.reloadData()
+        self.empty.isHidden = (rooms.count > 0)
+    } else {
+        self.view.makeToast("\(error?.localizedDescription ?? "")")
+    }
+}
+```
+
+### 2. 登录即时通讯系统
+
+参考如下步骤登录即时通讯（IM）系统：
+
+1. 根据[前提条件](#前提条件)在声网控制台创建声网项目后，参考[开启和配置即时通讯服务](https://docs-preprod.agora.io/cn/agora-chat/enable_agora_chat?platform=All%20Platforms)，在声网控制台为你的声网项目开启并配置即时通讯服务。
+2. 参考[即时通讯集成概述](https://docs-preprod.agora.io/cn/agora-chat/integration_overview_ios?platform=iOS#用户登录)，获取登录即时通讯系统所需的用户名（ID）和 Token。
+3. 调用声网即时通讯（IM）SDK 中 `AgoraChatClient` 类的 [`loginWithUsername:token:completion:`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_oc/v1.1.0/interface_agora_chat_client.html#ad1f4dbc685867ed236fcb57c2d29c2b0) 方法并传入即时通讯服务的用户名和 Token 以登录即时通讯系统。
+
+
+```swift
+@objc public func loginIM(userName: String, token: String, completion: @escaping (String, AgoraChatError?) -> Void) {
+    if AgoraChatClient.shared().isLoggedIn {
+        completion(AgoraChatClient.shared().currentUsername ?? "", nil)
+    } else {
+        // 登录即时通讯系统
+        // 此处的 Token 为声网 Chat Token
+        // 不要和声网 RTC Token 混淆
+        AgoraChatClient.shared().login(withUsername: userName, token: token, completion: completion)
+    }
+}
+```
+
+### 3. 初始化 AgoraRtcEngineKit
+
+参考如下步骤初始化 AgoraRtcEngineKit：
+
+1. 根据[前提条件](#前提条件)在声网控制台创建声网项目后，复制界面的 App ID。
+2. 调用声网 RTC SDK 中的 [`sharedEngineWithAppId`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_create) 方法初始化 `AgoraRtcEngineKit`。
+
+```swift
+let rtcKit: AgoraRtcEngineKit = AgoraRtcEngineKit.sharedEngine(withAppId: KeyCenter.AppId, delegate: nil)
+```
+### 4. 创建并进入房间
+
+1. 调用 `ChatRoomServiceImp` 类中的 `createRoom` 方法创建一个房间。
+
+    ```swift
+    ChatRoomServiceImp.getSharedInstance().createRoom(room: entity) { error, room in
+        SVProgressHUD.dismiss()
+        self.view.window?.isUserInteractionEnabled = true
+        if let room = room,error == nil {
+            self.entryRoom(room: room)
+        } else {
+            SVProgressHUD.showError(withStatus: "Create failed!".localized())
+        }
+    }
+    ```
+
+2. 调用 `ChatRoomServiceImp` 类的 `joinRoom` 方法进入房间。
+
+    ```swift
+    // 显示加载提示
+    SVProgressHUD.show(withStatus: "Loading".localized())
+    // 生成声网 RTC Token
+    // 不要和声网 Chat Token 搞混淆
+    NetworkManager.shared.generateToken(channelName: room.channel_id ?? "", uid: VLUserCenter.user.id, tokenType: .token007, type: .rtc) { token in
+        VLUserCenter.user.agoraRTCToken = token ?? ""
+        // 进入房间
+        ChatRoomServiceImp.getSharedInstance().joinRoom(room.room_id ?? "") { error, room_entity in
+            SVProgressHUD.dismiss()
+            if VLUserCenter.user.chat_uid.isEmpty || VLUserCenter.user.im_token.isEmpty || self.initialError != nil {
+                SVProgressHUD.showError(withStatus: "Fetch IMconfig failed!")
+                return
+            }
+            self.mapUser(user: VLUserCenter.user)
+            let info: VRRoomInfo = VRRoomInfo()
+            info.room = room
+            info.mic_info = nil
+            self.isDestory = false
+            let vc = VoiceRoomViewController(info: info)
+            self.navigationController?.pushViewController(vc, animated: true)
+            self.normal.roomList.isUserInteractionEnabled = true
+        }
+    }
+    ```
+
+3. 语聊房里需要有消息聊天和语音聊天，因此你还需进行如下操作：
+
+    - 调用声网 IM SDK 中 `joinChatRoom` 实现房间内的消息互动。方法中的参数含义和支持取值请参考 [`joinChatRoom`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_oc/v1.1.0/protocol_i_agora_chatroom_manager-p.html#ad8d19bd36e60c8af8d04c1f8b4daa2f0)。
+
+        ```swift
+        // 实现房间内的消息互动
+        @objc func joinedChatRoom(roomId: String, completion: @escaping ((AgoraChatroom?, AgoraChatError?) -> Void)) {
+            AgoraChatClient.shared().roomManager?.joinChatroom(roomId, completion: { room, error in
+                if error == nil, let id = room?.chatroomId {
+                    self.currentRoomId = id
+                }
+                completion(room, error)
+            })
+        }
+        ```
+
+    - 调用声网 RTC SDK 中 `AgoraRtcEngineKit` 类的 `joinChannelByToken` 加入 RTC 频道以实现房间内的实时音频通话。方法中的参数含义和支持取值请参考 [`joinChannelByToken`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_joinchannel)。在这一步里需要填写声网 RTC Token。你可以参考[开始使用声网平台](https://docs.agora.io/cn/Agora%20Platform/get_appid_token?platform=All%20Platforms)从声网控制台获得临时用途的声网 RTC Token。你也可以参考[使用 Token 鉴权](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/token_server_ios_ng?platform=iOS)获取正式用途的声网 RTC Token。临时 Token 的有效期为 24 小时，建议你仅在测试用途下使用。
+    你还可以调用 [`setChannelProfile`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_setchannelprofile)、[`setAudioProfile`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_audio_process.html#api_irtcengine_setaudioprofile2)、[`setAudioScenario`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_audio_process.html#api_irtcengine_setaudioscenario)、[`setParameters`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_network.html#api_irtcengine_setparameters) 来为不同业务场景（语聊社交、KTV、游戏陪玩、专业音频直播场景）设置语聊房的最佳音效。
+
+        ```swift
+        // 实现房间内的语音互动
+        rtcKit.delegate = self
+        rtcKit.enableAudioVolumeIndication(200, smooth: 3, reportVad: true)
+        self .setParametersWithMD()
+        // 在线 K 歌房和泛娱乐社交场景下推荐设置
+        if type == .ktv || type == .social {
+            // 设置频道属性为直播
+            rtcKit.setChannelProfile(.liveBroadcasting)
+            // 设置 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 96 Kbps
+            rtcKit.setAudioProfile(.musicHighQuality)
+            // 设置为高音质场景
+            rtcKit.setAudioScenario(.gameStreaming)
+        } else if type == .game {
+            // 1 对 1 游戏陪玩通话场景下推荐
+            // 设置频道属性为通信
+            rtcKit.setChannelProfile(.communication)
+        } else if type == .anchor {
+            // 专业音频直播场景下推荐设置
+            // 设置频道属性为直播
+            rtcKit.setChannelProfile(.liveBroadcasting)
+            // 指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 128 Kbps
+            rtcKit.setAudioProfile(.musicHighQualityStereo)
+            // 设置为高音质场景
+            rtcKit.setAudioScenario(.gameStreaming)
+            // 设置私有参数以获得好的实时音频互动体验
+            rtcKit.setParameters("{\"che.audio.custom_payload_type\":73}")
+            rtcKit.setParameters("{\"che.audio.custom_bitrate\":128000}")
+            rtcKit.setParameters("{\"che.audio.input_channels\":2}")
+        }
+        setAINS(with: .mid)
+        rtcKit.setParameters("{\"che.audio.start_debug_recording\":\"all\"}")
+        rtcKit.setEnableSpeakerphone(true)
+        rtcKit.setDefaultAudioRouteToSpeakerphone(true)
+        // 加入 RTC 频道
+        // 此处的 Token 为声网 RTC Token
+        let code: Int32 = rtcKit.joinChannel(byToken: token, channelId: channelName, info: nil, uid: UInt(rtcUid ?? 0))
+        ```
+
+### 5. 麦位管理
+
+具体步骤详见[麦位管理](./chatroom_mic_seat_ios)。
+
+### 6. 退出房间
+
+1. 调用 `ChatRoomServiceImp` 类的 `leaveRoom` 方法离开房间。
+
+    ```swift
+    ChatRoomServiceImp.getSharedInstance().leaveRoom(self.roomInfo?.room?.room_id ?? "") { _, _ in
+    }
+    ```
+
+
+2. 调用 `AgoraRtcEngineKit` 类的 [`leaveChannel`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_leavechannel) 方法离开 RTC 频道。
+
+    ```swift
+    rtcKit.leaveChannel(nil)
+    ```
+
+3. 调用 [`leaveChatroom:completion:`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_oc/v1.1.0/protocol_i_agora_chatroom_manager-p.html#ae9b671ece1a36ad8ac26375d91755467) 离开聊天室，调用 [`destroyChatroom:`](https://docs-preprod.agora.io/cn/agora-chat/API%20Reference/im_oc/v1.1.0/protocol_i_agora_chatroom_manager-p.html#a1e3a6bacf44a96ff37b34d2068c84386) 销毁聊天室。调用 [`destroy`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_release) 销毁 RTC 引擎。
+
+    ```swift
+    AgoraChatClient.shared().roomManager?.leaveChatroom(currentRoomId, completion: { error in
+    })
+    AgoraChatClient.shared().roomManager?.destroyChatroom(currentRoomId)
+    AgoraRtcEngineKit.destroy()
+    rtcKit.delegate = nil
+    ```
+
+### API 时序图
+
+![](https://web-cdn.agora.io/docs-files/1690957961923)
\ No newline at end of file
diff --git a/markdown/chatroom/chatroom_mic_seat_android.md b/markdown/chatroom/chatroom_mic_seat_android.md
new file mode 100644
index 00000000000..be2a6d3cd4d
--- /dev/null
+++ b/markdown/chatroom/chatroom_mic_seat_android.md
@@ -0,0 +1,271 @@
+本文介绍如何在语聊房中进行麦位管理麦位管理包含如下操作：
+
+- 上麦：听众与房主连麦，连麦听众可以发言，与房主语音互动。
+- 下麦：连麦听众下麦后成为普通听众，无法发言也无法与房主语音互动。
+- 静音：房主不允许某个连麦听众发言。
+- 锁麦：房主不允许任何用户占据该麦位。
+- 换麦：连麦听众从一个麦位更换到另一个麦位。
+
+![](https://web-cdn.agora.io/docs-files/1689239633856)
+
+## 示例项目
+
+声网在 [agora-ent-scenarios](https://github.com/AgoraIO-Usecase/agora-ent-scenarios) 仓库中提供[语聊房（普通版）](https://github.com/AgoraIO-Usecase/agora-ent-scenarios/tree/v3.1.0-voice-Android/Android/scenes/voice)源代码供你参考。
+
+## 前提条件
+
+### 实现基础功能
+
+实现该进阶功能前，请确保你已实现基础的语聊房功能，例如登录即时通讯系统、获取房间列表、创建房间、加入房间。详见[基础功能](https://docs.agora.io/cn/chatroom/chatroom_integration_android?platform=All%20Platforms)。
+
+### 注册回调
+
+进行麦位管理前，你需要通过声网云服务中 `voiceServiceProtocol` 类的 `subscribeEvent` 方法注册回调事件，监听房间内的回调事件。
+
+```kotlin
+voiceServiceProtocol.subscribeEvent(object : VoiceRoomSubscribeDelegate{
+    ...
+})
+```
+
+## 上麦
+
+本节介绍如何让听众上麦并在麦位上发送音频流。上麦的方式分为房主邀请或听众主动申请。
+
+### 房主邀请上麦
+
+![](https://web-cdn.agora.io/docs-files/1690957941173)
+
+1. 房主调用 `voiceServiceProtocol` 对象的 `startMicSeatInvitation` 方法，开始邀请听众上麦。
+
+    ```kotlin
+    // 邀请上麦
+    voiceServiceProtocol.startMicSeatInvitation(chatUid, micIndex, completion = { error, result ->
+        ...
+    })
+    ```
+
+2. 房间内其他所有用户都通过 `subscribeEvent` 注册的 `onReceiveSeatInvitation` 回调获取房主邀请上麦的通知。
+
+    ```kotlin
+    // 接收到邀请通知
+    fun onReceiveSeatInvitation(message: ChatMessageData) {}
+    ```
+
+3. 收到房主上麦邀请的听众会看到邀请弹窗，听众可以选择是否接受邀请：
+
+    - 调用 `voiceServiceProtocol` 对象的 `acceptMicSeatInvitation` 方法接受邀请。
+    - 调用 `voiceServiceProtocol` 对象的 `refuseInvite` 方法拒绝邀请。
+
+    ```kotlin
+    // 接受邀请
+    voiceServiceProtocol.acceptMicSeatInvitation(micIndex, completion = { error, result ->
+        ...
+    })
+    ```
+
+    ```kotlin
+    // 拒绝邀请
+    fun refuseInvite(completion: (error: Int, result: Boolean) -> Unit) {
+        ...
+    }
+    ```
+
+4. 如果听众接受上麦邀请，那么你需要让房内其他用户都收到麦位更新的通知。
+
+    ```kotlin
+    // 麦位更新
+    fun onSeatUpdated(roomId: String, attributeMap: Map<String, String>, fromId: String) {}
+    ```
+
+    <div class="alert note">房主邀请多个听众上麦时，如果多个听众同时点击接受上麦邀请，那么可能出现听众 A 刚上麦就被后面上麦的用户 B 踢下麦位。因此，为了避免多个听众同时主动修改麦位时造成互踢的冲突，声网推荐你在集成逻辑中控制上麦由房主决定，而不是听众决定。</div>
+
+### 听众申请上麦
+
+![](https://web-cdn.agora.io/docs-files/1690957949791)
+
+1. 听众调用 `voiceServiceProtocol` 对象的 `startMicSeatApply` 方法向房主发送申请上麦的请求。
+
+    ```kotlin
+    // 申请上麦
+    voiceServiceProtocol.startMicSeatApply(micIndex, completion = { error, result ->
+        ...
+    })
+    ```
+
+2. （可选）如果听众希望取消上麦申请，可以调用 `voiceServiceProtocol` 对象的 `cancelMicSeatApply` 方法。
+
+    ```kotlin
+    // 听众取消自己的上麦申请
+    voiceServiceProtocol.cancelMicSeatApply(chatroomId, chatUid, completion = { error, result ->
+        ...
+    })
+    ```
+
+3. 房主通过 `subscribeEvent` 注册的 `onReceiveSeatRequest` 回调获取听众申请上麦的信息更新，从而刷新上麦申请列表。
+
+    ```kotlin
+    // 房主收到申请上麦信息
+    fun onReceiveSeatRequest( message: ChatMessageData) {}
+    ```
+
+4. 房主调用 `voiceServiceProtocol` 对象的 `acceptMicSeatApply` 方法，以同意某个听众的上麦申请。
+
+    ```kotlin
+    // 房主同意听众上麦申请
+    voiceServiceProtocol.acceptMicSeatApply(micIndex, chatUid, completion = { error, result ->
+        ...
+    })
+    ```
+
+5. 如果房主同意某个听众的上麦申请，那么你需要让房内其他用户都收到麦位更新的通知。
+
+    ```kotlin
+    // 收到同意申请上麦
+    fun onSeatUpdated(roomId: String, attributeMap: Map<String, String>, fromId: String) {}
+    ```
+
+### 切换用户角色
+
+不管是房主邀请，还是听众主动申请，在听众成为连麦听众后，你需要调用声网 RTC SDK 中 [`setClientRole`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_core_method.html#api_irtcengine_setclientrole) 方法将其角色从听众（`AUDIENCE`）切换成主播（`BROADCASTER`），以让连麦听众拥有发送音频流的权限。
+
+```kotlin
+rtcEngine?.setClientRole(Constants.CLIENT_ROLE_BROADCASTER)
+```
+
+## 下麦
+
+本节介绍如何让连麦听众下麦并在下麦后无法发送音频流。下麦的方式分为连麦听众主动下麦和被踢下麦。
+
+### 主动下麦
+
+连麦听众调用 `voiceServiceProtocol` 对象的 `leaveMic` 方法可以主动下麦。
+
+```kotlin
+// 主动下麦
+voiceServiceProtocol.leaveMic(micIndex, completion = { error, result ->
+    ...
+})
+```
+
+### 被踢下麦
+
+房主调用 `voiceServiceProtocol` 对象的 `kickOff` 方法可以将连麦听众踢下麦。
+
+```kotlin
+// 踢连麦听众下麦
+voiceServiceProtocol.kickOff(micIndex, completion = { error, result ->
+    ...
+})
+```
+
+### 麦位更新回调
+
+不管是连麦听众主动下麦还是被踢下麦，在连麦听众成为普通听众后，你需要让房内其他用户都收到麦位更新的通知。
+
+```kotlin
+fun onSeatUpdated(roomId: String, attributeMap: Map<String, String>, fromId: String) {}
+```
+
+### 切换用户角色
+
+不管是连麦听众主动下麦还是被踢下麦，在连麦听众成为普通听众后，你需要调用声网 RTC SDK 中 [`setClientRole`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_setclientrole) 方法将其角色从主播（`BROADCASTER`）切换成听众（`AUDIENCE`），以让其失去发送音频流的权限。
+
+```kotlin
+rtcEngine?.setClientRole(Constants.CLIENT_ROLE_AUDIENCE)
+```
+
+## 设置是否静音
+
+听众上麦后，你可以设置麦位是否静音，以达到禁言的目的。将麦位静音意味着不允许该连麦听众发言；将麦位取消静音意味着恢复该连麦听众发言的权限。
+
+### 麦位静音
+
+你可以通过 `voiceServiceProtocol` 对象的 `forbidMic` 方法将某个麦位标记为静音。
+
+```kotlin
+// 禁言指定麦位
+voiceServiceProtocol.forbidMic(micIndex, completion = { error, result ->
+    ...
+})
+```
+
+### 麦位取消静麦
+
+你可以通过 `voiceServiceProtocol` 对象的 `unForbidMic` 方法将某个麦位标记为取消静音。
+
+```kotlin
+// 取消禁言指定麦位
+voiceServiceProtocol.unForbidMic(micIndex, completion = { error, result ->
+    ...
+})
+```
+
+### 麦位更新回调
+
+将麦位静音或取消静音后，你需要让房内其他用户收到麦位更新的通知。
+
+```kotlin
+fun onSeatUpdated(roomId: String, attributeMap: Map<String, String>, fromId: String) {}
+```
+
+### 停止或恢复发送音频流
+
+标记麦位静音或取消静音后，通过声网 RTC SDK 中 [`muteLocalAudioStream`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_stream_management.html#api_irtcengine_mutelocalaudiostream) 方法停止发送或恢复发送麦位上的连麦听众的音频流，以达到静音或取消静音的效果。
+
+```kotlin
+// 参数 mute 为 true 代表静音
+// 参数 mute 为 false 代表取消静音
+rtcEngine?.muteLocalAudioStream(true)
+```
+
+## 设置是否锁麦
+
+锁麦意味着不允许任何用户占据该麦位。将某个麦位锁住后，用户无法占据该麦位。将某个麦位解锁后，麦位恢复空闲状态，用户可以占据该麦位。
+
+### 锁麦
+
+你可以调用 `voiceServiceProtocol` 对象的 `lockMic` 方法将某个麦位锁住。
+
+```kotlin
+// 锁麦
+voiceServiceProtocol.lockMic(micIndex, completion = { error, result ->
+    ...
+})
+```
+
+### 取消锁麦
+
+你可以调用 `voiceServiceProtocol` 对象的 `unLockMic` 方法将某个麦位解锁。
+
+
+```kotlin
+// 取消锁麦
+voiceServiceProtocol.unLockMic(micIndex, completion = { error, result ->
+    ...
+})
+```
+
+### 麦位更新回调
+
+将麦位锁住或解锁后，你需要让房内其他用户收到麦位更新的通知。
+
+```kotlin
+fun onSeatUpdated(roomId: String, attributeMap: Map<String, String>, fromId: String) {}
+```
+
+## 换麦
+
+1. 换麦指将把连麦听众从当前麦位更换到另一个空闲麦位。你可以调用 `voiceServiceProtocol` 对象的 `changeMic` 方法更换麦位。
+
+    ```kotlin
+    voiceServiceProtocol.changeMic(oldIndex, newIndex, completion = { error, result ->
+        ...
+    })
+    ```
+
+2. 如果换麦成功，那么此时你需要让房内其他用户收到麦位更新的通知。
+
+    ```kotlin
+    fun onSeatUpdated(roomId: String, attributeMap: Map<String, String>, fromId: String) {}
+    ```
\ No newline at end of file
diff --git a/markdown/chatroom/chatroom_mic_seat_ios.md b/markdown/chatroom/chatroom_mic_seat_ios.md
new file mode 100644
index 00000000000..4d979c8fd34
--- /dev/null
+++ b/markdown/chatroom/chatroom_mic_seat_ios.md
@@ -0,0 +1,390 @@
+本文介绍如何在语聊房中进行麦位管理麦位管理包含如下操作：
+
+- 上麦：听众与房主连麦，连麦听众可以发言，与房主语音互动。
+- 下麦：连麦听众下麦后成为普通听众，无法发言也无法与房主语音互动。
+- 静音：房主不允许某个连麦听众发言。
+- 锁麦：房主不允许任何用户占据该麦位。
+- 换麦：连麦听众从一个麦位更换到另一个麦位。
+
+![](https://web-cdn.agora.io/docs-files/1689239633856)
+
+## 示例项目
+
+声网在 [agora-ent-scenarios](https://github.com/AgoraIO-Usecase/agora-ent-scenarios) 仓库中提供[语聊房（普通版）](https://github.com/AgoraIO-Usecase/agora-ent-scenarios/tree/v3.1.0-voice-iOS/iOS/AgoraEntScenarios/Scenes/VoiceChatRoom)源代码供你参考。
+
+## 前提条件
+
+### 实现基础功能
+
+实现该进阶功能前，请确保你已实现基础的语聊房功能，例如登录即时通讯系统、获取房间列表、创建房间、加入房间。详见[基础功能](https://docs.agora.io/cn/chatroom/chatroom_integration_ios?platform=All%20Platforms)。
+
+### 注册回调
+
+进行麦位管理前，你需要通过声网云服务中 `ChatRoomServiceImp` 类的 `subscribeEvent` 方法注册回调事件，监听房间内的回调事件。
+
+```swift
+ChatRoomServiceImp.getSharedInstance().subscribeEvent(with: self)
+```
+
+## 上麦
+
+本节介绍如何让听众上麦并在麦位上发送音频流。上麦的方式分为房主邀请或听众主动申请。
+
+### 房主邀请上麦
+
+![](https://web-cdn.agora.io/docs-files/1690957941173)
+
+1. 房主调用 `ChatRoomServiceImp` 类的 `startMicSeatInvitation` 方法，开始邀请听众上麦。
+
+    ```swift
+    // 邀请上麦
+    private func inviteUser(user: VRUser?) {
+        SVProgressHUD.show()
+        let chat_uid: String = user?.chat_uid ?? ""
+        ChatRoomServiceImp.getSharedInstance().startMicSeatInvitation(chatUid: chat_uid, index: idx < 0 ? nil:idx) { error, flag in
+            SVProgressHUD.dismiss()
+            self.view.makeToast(flag == true ? "Invitation sent!".localized() : "Invited failed!".localized())
+        }
+    }
+    ```
+
+2. 房间内其他所有用户都通过 `subscribeEvent` 注册的 `onReceiveSeatInvitation` 回调获取房主邀请上麦的通知。
+
+    ```swift
+    // 接收到邀请通知
+    func onReceiveSeatInvitation(roomId: String, user: VRUser) {
+        self.showInviteMicAlert(index: user.mic_index)
+    }
+    ```
+
+3. 收到房主上麦邀请的听众会看到邀请弹窗，听众可以选择是否接受邀请：
+
+    - 调用 `ChatRoomServiceImp` 类的 `acceptMicSeatInvitation` 方法接受邀请。
+    - 调用 `ChatRoomServiceImp` 类的 `refuseInvite` 方法拒绝邀请。
+
+    ```swift
+    // 接受邀请
+    func agreeInvite(index: Int?) {
+        var idx: Int?
+        if index != -1, index != 0 {
+            idx = index
+        }
+        ChatRoomServiceImp.getSharedInstance().acceptMicSeatInvitation(index: idx,completion: { error, mic in
+            if error == nil,let mic = mic {
+                self.rtcView.updateUser(mic)
+                self.local_index = mic.mic_index
+                self.rtckit.setClientRole(role: .owner)
+                self.chatBar.refresh(event: .handsUp, state: .disable, asCreator: self.isOwner)
+                self.chatBar.refresh(event: .mic, state: .unSelected, asCreator: self.isOwner)
+                self.rtckit.muteLocalAudioStream(mute: mic.status != 0)
+                self.checkEnterSeatAudioAuthorized()
+            } else {
+                self.view.makeToast("\(error?.localizedDescription ?? "")",point: self.toastPoint, title: nil, image: nil, completion: nil)
+            }
+        })
+    }
+    ```
+
+    ```swift
+    // 拒绝邀请
+    func refuse() {
+        ChatRoomServiceImp.getSharedInstance().refuseInvite(chat_uid: self.roomInfo?.room?.owner?.chat_uid ?? "") { _, _ in
+        }
+    }
+    ```
+
+4. 如果听众接受上麦邀请，那么你需要让房内其他用户都收到麦位更新的通知。
+
+    ```swift
+    // 麦位更新
+    func onSeatUpdated(roomId: String, mics: [VRRoomMic], from fromId: String) {
+        self.updateMic(mics, fromId: fromId)
+    }
+    ```
+
+    <div class="alert note">房主邀请多个听众上麦时，如果多个听众同时点击接受上麦邀请，那么可能出现听众 A 刚上麦就被后面上麦的用户 B 踢下麦位。因此，为了避免多个听众同时主动修改麦位时造成互踢的冲突，声网推荐你在集成逻辑中控制上麦由房主决定，而不是听众决定。</div>
+
+### 听众申请上麦
+
+![](https://web-cdn.agora.io/docs-files/1690957949791)
+
+1. 听众调用 `ChatRoomServiceImp` 类的 `startMicSeatApply` 方法向房主发送申请上麦的请求。
+
+    ```swift
+    // 申请上麦
+    func requestSpeak(index: Int?) {
+        ChatRoomServiceImp.getSharedInstance().startMicSeatApply(index: index) { error, flag in
+            if error == nil {
+                if flag {
+                    self.chatBar.refresh(event: .handsUp, state: .selected, asCreator: false)
+                    self.view.makeToast("Apply success!".localized(), point: self.toastPoint, title: nil, image: nil, completion: nil)
+                } else {
+                    self.view.makeToast("Apply failed!".localized(), point: self.toastPoint, title: nil, image: nil, completion: nil)
+                }
+            } else {
+            }
+        }
+    }
+    ```
+
+2. （可选）如果听众希望取消上麦申请，可以调用 `ChatRoomServiceImp` 类的 `cancelMicSeatApply` 方法。
+
+    ```swift
+    // 听众取消自己的上麦申请
+    func cancelRequestSpeak(index: Int?) {
+        ChatRoomServiceImp.getSharedInstance().cancelMicSeatApply(chat_uid: self.roomInfo?.room?.owner?.chat_uid ?? "") { error, flag in
+            if error == nil {
+                self.view.makeToast("Cancel apply success!".localized(), point: self.toastPoint, title: nil, image: nil, completion: nil)
+                self.chatBar.refresh(event: .handsUp, state: .unSelected, asCreator: false)
+            } else {
+                self.view.makeToast("Cancel apply failed!".localized(), point: self.toastPoint, title: nil, image: nil, completion: nil)
+            }
+        }
+    }
+    ```
+
+3. 房主通过 `subscribeEvent` 注册的 `onReceiveSeatRequest` 回调获取听众申请上麦的信息更新，从而刷新上麦申请列表。
+
+    ```swift
+    // 房主收到申请上麦信息
+    func onReceiveSeatRequest(roomId: String, applicant: VoiceRoomApply) {
+        self.chatBar.refresh(event: .handsUp, state: .unSelected, asCreator: true)
+    }
+    ```
+
+4. 房主调用 `ChatRoomServiceImp` 类的 `acceptMicSeatApply` 方法，以同意某个听众的上麦申请。
+
+    ```swift
+    // 房主同意听众上麦申请
+    private func agreeUserApply(user: VoiceRoomApply?) {
+        SVProgressHUD.show()
+        guard let user1 = user?.member else { return }
+        ChatRoomServiceImp.getSharedInstance().acceptMicSeatApply(chatUid: user1.chat_uid ?? "", completion: { error,mic  in
+            SVProgressHUD.dismiss()
+            if self.agreeApply != nil,let mic = mic {
+                self.agreeApply!(mic)
+            }
+            self.tableView.reloadData()
+            let warningMessage = (error == nil ? "Agree success!".localized():"Agree failed!".localized())
+            self.view.makeToast(warningMessage)
+        })
+    }
+    ```
+
+5. 如果房主同意某个听众的上麦申请，那么你需要让房内其他用户都收到麦位更新的通知。
+
+    ```swift
+    // 收到同意申请上麦
+    func onSeatUpdated(roomId: String, mics: [VRRoomMic], from fromId: String) {
+        self.updateMic(mics, fromId: fromId)
+    }
+    ```
+
+### 切换用户角色
+
+不管是房主邀请，还是听众主动申请，在听众成为连麦听众后，你需要调用声网 RTC SDK 中 [`setClientRole`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_setclientrole) 方法将其角色从听众（`audience`）切换成主播（`broadcaster`），以让连麦听众拥有发送音频流的权限。
+
+```swift
+rtcKit.setClientRole(.broadcaster)
+```
+
+## 下麦
+
+本节介绍如何让连麦听众下麦并在下麦后无法发送音频流。下麦的方式分为连麦听众主动下麦和被踢下麦。
+
+### 主动下麦
+
+连麦听众调用 `ChatRoomServiceImp` 类的 `leaveMic` 方法可以主动下麦。
+
+```swift
+// 主动下麦
+func leaveMic(with index: Int) {
+    chatBar.refresh(event: .mic, state: .selected, asCreator: false)
+    ChatRoomServiceImp.getSharedInstance().leaveMic(mic_index: index) { error, mic in
+        if error == nil,let mic = mic {
+            self.rtcView.updateUser(mic)
+            self.rtckit.setClientRole(role: .audience)
+            self.local_index = nil
+            self.chatBar.refresh(event: .handsUp, state: .unSelected, asCreator: self.isOwner)
+            self.chatBar.refresh(event: .mic, state: .selected, asCreator: self.isOwner)
+        }
+    }
+}
+```
+
+### 被踢下麦
+
+房主调用 `ChatRoomServiceImp` 类的 `kickoff` 方法可以将连麦听众踢下麦。
+
+```swift
+// 踢连麦听众下麦
+func kickoff(with index: Int) {
+    ChatRoomServiceImp.getSharedInstance().kickOff(mic_index: index) { error, mic in
+        if error == nil,let mic = mic {
+            self.rtcView.updateUser(mic)
+        }
+    }
+}
+```
+
+### 麦位更新回调
+
+不管是连麦听众主动下麦还是被踢下麦，在连麦听众成为普通听众后，你需要让房内其他用户都收到麦位更新的通知。
+
+```swift
+func onSeatUpdated(roomId: String, mics: [VRRoomMic], from fromId: String) {
+    self.updateMic(mics, fromId: fromId)
+}
+```
+
+### 切换用户角色
+
+不管是连麦听众主动下麦还是被踢下麦，在连麦听众成为普通听众后，你需要调用声网 RTC SDK 中 [`setClientRole`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/ios_ng/API/toc_core_method.html#api_irtcengine_setclientrole) 方法将其角色从主播（`broadcaster`）切换成听众（`audience`），以让其失去发送音频流的权限。
+
+```swift
+rtcKit.setClientRole(.audience)
+```
+
+## 设置是否静音
+
+听众上麦后，你可以设置麦位是否静音，以达到禁言的目的。将麦位静音意味着不允许该连麦听众发言；将麦位取消静音意味着恢复该连麦听众发言的权限。
+
+### 麦位静音
+
+你可以通过 `ChatRoomServiceImp` 类的 `forbidMic` 方法将某个麦位标记为静音。
+
+```swift
+// 禁言指定麦位
+func mute(with index: Int) {
+    ChatRoomServiceImp.getSharedInstance().forbidMic(mic_index: index) { error, mic in
+        if error == nil,let mic = mic {
+            self.rtcView.updateUser(mic)
+        }
+    }
+}
+```
+
+### 麦位取消静麦
+
+你可以通过 `ChatRoomServiceImp` 类的 `unForbidMic` 方法将某个麦位标记为取消静音。
+
+```swift
+// 取消禁言指定麦位
+func unMute(with index: Int) {
+    if let user = roomInfo?.mic_info?[index] {
+        if user.status == 1 && index != 0 && isOwner { return }
+    }
+    ChatRoomServiceImp.getSharedInstance().unForbidMic(mic_index: index) { error, mic in
+        if error == nil {
+            self.chatBar.refresh(event: .handsUp, state: .unSelected, asCreator: false)
+            if let mic = mic {
+                self.rtcView.updateUser(mic)
+            }
+        }
+    }
+}
+```
+
+### 麦位更新回调
+
+将麦位静音或取消静音后，你需要让房内其他用户收到麦位更新的通知。
+
+```swift
+func onSeatUpdated(roomId: String, mics: [VRRoomMic], from fromId: String) {
+    self.updateMic(mics, fromId: fromId)
+}
+```
+
+### 停止或恢复发送音频流
+
+标记麦位静音或取消静音后，通过声网 RTC SDK 中 [`muteLocalAudioStream`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_stream_management.html#api_irtcengine_mutelocalaudiostream) 方法停止发送或恢复发送麦位上的连麦听众的音频流，以达到静音或取消静音的效果。
+
+```swift
+// 参数 mute 为 true 代表静音
+// 参数 mute 为 false 代表取消静音
+public func muteLocalAudioStream(mute: Bool) -> Int32 {
+    return rtcKit.muteLocalAudioStream(mute)
+}
+```
+
+## 设置是否锁麦
+
+锁麦意味着不允许任何用户占据该麦位。将某个麦位锁住后，用户无法占据该麦位。将某个麦位解锁后，麦位恢复空闲状态，用户可以占据该麦位。
+
+### 锁麦
+
+你可以调用 `ChatRoomServiceImp` 类的 `lockMic` 方法将某个麦位锁住。
+
+```swift
+// 锁麦
+func lock(with index: Int) {
+    ChatRoomServiceImp.getSharedInstance().lockMic(mic_index: index) { error, mic in
+        if error == nil,let mic = mic {
+            self.rtcView.updateUser(mic)
+        }
+    }
+}
+```
+
+### 取消锁麦
+
+你可以调用 `ChatRoomServiceImp` 类的 `unLockMic` 方法将某个麦位解锁。
+
+
+```swift
+// 取消锁麦
+func unLock(with index: Int) {
+    ChatRoomServiceImp.getSharedInstance().unLockMic(mic_index: index) { error, mic in
+        if error == nil,let mic = mic {
+            self.rtcView.updateUser(mic)
+        }
+    }
+}
+```
+
+### 麦位更新回调
+
+将麦位锁住或解锁后，你需要让房内其他用户收到麦位更新的通知。
+
+```swift
+func onSeatUpdated(roomId: String, mics: [VRRoomMic], from fromId: String) {
+    self.updateMic(mics, fromId: fromId)
+}
+```
+
+## 换麦
+
+1. 换麦指将把连麦听众从当前麦位更换到另一个空闲麦位。你可以调用 `ChatRoomServiceImp` 类的 `changeMic` 方法更换麦位。
+
+    ```swift
+    func changeMic(from: Int, to: Int) {
+        if let mic: VRRoomMic = roomInfo?.mic_info?[to] {
+            if mic.status == 3 || mic.status == 4 {
+                view.makeToast("Mic Closed".localized())
+                return
+            }
+        }
+
+        ChatRoomServiceImp.getSharedInstance().changeMic(old_index: from, new_index: to) { error, micMap in
+            if error == nil,let old_mic = micMap?[from],let new_mic = micMap?[to] {
+                self.local_index = to
+                self.roomInfo?.mic_info?[from] = old_mic
+                self.roomInfo?.mic_info?[to] = new_mic
+                self.rtcView.updateUser(old_mic)
+                self.rtcView.updateUser(new_mic)
+                guard let mic = ChatRoomServiceImp.getSharedInstance().mics.first(where: {
+                    VoiceRoomUserInfo.shared.user?.chat_uid ?? "" == $0.member?.chat_uid ?? ""
+                }) else { return }
+                self.micMuteManager(mic: mic)
+            }
+        }
+    }
+    ```
+
+2. 如果换麦成功，那么此时你需要让房内其他用户收到麦位更新的通知。
+
+    ```swift
+    func onSeatUpdated(roomId: String, mics: [VRRoomMic], from fromId: String) {
+        self.updateMic(mics, fromId: fromId)
+    }
+    ```
\ No newline at end of file
diff --git a/markdown/chatroom/chatroom_overview.md b/markdown/chatroom/chatroom_overview.md
new file mode 100644
index 00000000000..a3c4f648647
--- /dev/null
+++ b/markdown/chatroom/chatroom_overview.md
@@ -0,0 +1,45 @@
+语音连麦聊天在在线交友、游戏娱乐等场景下广泛应用。为了让用户获得更加沉浸式、有趣的语音聊天体验，声网推出了声动语聊解决方案。该方案搭载声网最新音频技术和最佳音效实践，提供更好的在线语音聊天室（即“语聊房”）体验。用户可以通过音频连麦互动，使用文字消息辅助聊天，并通过弹幕、礼物等方式活跃房间气氛。开发者可以使用声动语聊方案搭建符合业务需求的语聊应用，例如语音电台、K歌、游戏语音开黑房、你画我猜等游戏派对房。
+
+## 方案优势
+
+声动语聊解决方案有如下优势：
+
+|优势概述|详情|
+|-------|---------------|
+| 搭载最新音频技术，打造更沉浸式的互动玩法   | <li>声动语聊采用声网新一代音频技术智能引擎，包含空间音频、AI 降噪、AI 回声消除、变声音效等功能，使语音互动中的声音具有方位感和空间感。</li><li>语聊房可以有效屏蔽和抑制环境中的噪音和回声，打造更纯净、更沉浸的语音互动。</li>   |
+| 行业顶尖音效配置，聊得尽兴，玩得开心    |声动语聊综合声网超过万亿分钟的用户音效偏好的数据模型，汇总梳理语聊领域各类头部 app 的音效配置，并结合声网音频专家的多年沉淀与研究，提供针对各种语音场景的最佳音效配置，让用户享受行业顶尖的音效体验。    |
+| 搭积木式开发，接入成本低    | 语聊房的客户端功能以组件化形式提供，开发者可以像搭积木一样按需调用对应组件（包括弹幕组件、席位管理组件、音效组件、房间管理组件），灵活高效，大幅降低开发接入成本。   |
+
+
+## 支持功能
+
+声动语聊解决方案支持的核心功能如下：
+
+| 功能    | 描述    |
+|-----|-------------------------|
+| 多人实时语音    | 语聊房内多位用户实时连麦语聊。    |
+| 麦位管理    | 上麦、下麦、静音、锁麦、换麦。详见[麦位管理](./chatroom_mic_seat_android)。    |
+| 多种场景音效    | 房主为不同业务场景设置语聊房的最佳音效：包括语聊社交、KTV、游戏陪玩、专业音频直播的语音场景。 |
+| 用户个人音效    | 用户自定义个人音效：<li>AI 降噪（NS）：降低语聊时的噪音。<li>AI 回声消除（AEC）：消除语聊时的回声。<li>语音自动增益（AGC）：自动调整唱歌的人声音量。    |
+| 空间音效    | 使用户听到的音频具有 3D 空间立体感，让用户感觉更身临其境。用户可以调节麦位在空间中的位置，以选择更好的方位和距离来收听其他用户的发言。详见[空间音效](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/spatial_audio_android_ng?platform=Android)。    |
+| 播放背景音乐    | 房主可以播放本地音乐文件、在线音乐文件、声网内容中心的版权音乐、第三方厂商的版权音乐。详见[进阶功能](./chatroom_set_audio)。    |
+| 音量波纹提示    | 监听用户声音的音量并创造与音量高低相对应的波纹效果。详见[进阶功能](./chatroom_set_audio)。    |
+| 录制    | 通过声网[本地服务端录制](https://docportal.shengwang.cn/cn/Recording/product_recording?platform=Linux)或[云端录制](https://docportal.shengwang.cn/cn/cloud-recording/product_cloud_recording?platform=All%20Platforms)服务对语聊房进行录制。    |
+| 语音审核    |通过声网云市场丰富的插件实现语音审核，例如使用[依图](https://docportal.shengwang.cn/cn/extension_customer/quickstart_yitu_moderation_audio?platform=All%20Platforms)、[数美](https://docportal.shengwang.cn/cn/extension_customer/quickstart_shumei_moderation_audio?platform=All%20Platforms)、[图普](https://docportal.shengwang.cn/cn/extension_customer/quickstart_tupu_moderation_audio?platform=All%20Platforms)语音审核插件。     |
+| 防止炸房捣乱现象    | 预防和应对炸房捣乱现象的有效措施，帮助维护房间秩序，提高业务安全性。详见[预防和应对炸房捣乱现象最佳实践](https://docportal.shengwang.cn/cn/live-streaming-premium-legacy/prevent_stream_bombing?platform=Android)。    |
+
+
+
+## 支持平台
+
+声动语聊目前支持 Android 和 iOS 平台。
+
+## 技术架构 //TODO yf是否适用于UI方案
+
+声网使用[声网 RTC SDK](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/product_live_ng?platform=Android)、[声网即时通讯（IM）SDK](https://docs-preprod.agora.io/cn/agora-chat/agora_chat_overview?platform=All%20Platforms)、声网云服务（Service）共同搭建声动语聊场景：
+
+- 声网 RTC SDK：实现频道用户的实时音频互动。
+- 声网即时通讯（IM）SDK：实现房间内的信令通信。
+- 声网云服务（Service）：实现房间列表的存储并管理房间生命周期。
+
+![](https://web-cdn.agora.io/docs-files/1689243538283)
diff --git a/markdown/chatroom/chatroom_resource.md b/markdown/chatroom/chatroom_resource.md
new file mode 100644
index 00000000000..37c2a3fbea7
--- /dev/null
+++ b/markdown/chatroom/chatroom_resource.md
@@ -0,0 +1,12 @@
+本文介绍声动语聊解决方案所提供的可下载资源。
+
+| 资源 | 获取方式 |
+|---|---|
+| Demo 应用 | [下载](/cn/chatroom/downloads) |
+| GitHub 示例项目| <li>[Android 项目](https://github.com/AgoraIO-Usecase/agora-ent-scenarios/tree/v3.1.0-voice-Android/Android/scenes/voice)<li>[iOS 项目](https://github.com/AgoraIO-Usecase/agora-ent-scenarios/tree/v3.1.0-voice-iOS/iOS/AgoraEntScenarios/Scenes/VoiceChatRoom) |
+| RTC SDK（又称音频 SDK） | [下载](/cn/chatroom/downloads) |
+| 即时通讯 IM SDK | [下载](/cn/chatroom/downloads) |
+| UI 组件 | [GitHub 链接](https://github.com/AgoraIO-Community/AUIKitVoiceRoom) |
+
+
+资源说明：声动语聊解决方案由 RTC SDK 和 IM SDK 搭建，声网提供演示 Demo（声动互娱）、GitHub 示例项目 (`agora-ent-scenarios`)、相关文档供你参考使用。同时，你还可以参考 GitHub 社区中的 `AUIKitVoiceRoom` 仓库了解如何通过声网 UI 组件搭建语聊房。
diff --git a/markdown/chatroom/chatroom_set_audio.md b/markdown/chatroom/chatroom_set_audio.md
new file mode 100644
index 00000000000..fc5c8f63e31
--- /dev/null
+++ b/markdown/chatroom/chatroom_set_audio.md
@@ -0,0 +1,101 @@
+本文介绍语聊房解决方案中常用的进阶功能。
+
+实现进阶功能前，请确保你已实现基础的语聊房功能，例如登录即时通讯系统、获取房间列表、创建房间、加入房间。详见[基础功能](https://docs.agora.io/cn/chatroom/chatroom_integration_android?platform=All%20Platforms)。
+
+## 设置高音质
+
+高音质会给语聊房带来更好的音频体验。专业的音频直播间需要主播使用声卡进行音频采集，以获取更好的语音效果。你可以参考如下示例代码，调用声网 RTC SDK 中的 [`setAudioProfile`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_setaudioprofile2)、[`setAudioScenario`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_setaudioscenario)、[`setParameters`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_network.html#api_irtcengine_setparameters) 方法来为专业直播和普通直播设置高音质：
+
+- （专业直播）当主播使用声卡采集音频时，设置高音质：
+
+  ```kotlin
+  setAudioProfile(Constants.MUSIC_HIGH_QUALITY_STEREO)
+  setAudioScenario(Constants.AUDIO_SCENARIO_GAME_STREAMING)
+  setParameters("{\"che.audio.enable.aec\":false}")
+  setParameters("{\"che.audio.enable.ns\":false}")
+  setParameters("{\"che.audio.enable.agc\":false}")
+  setParameters("{\"che.audio.custom_payload_type\":78}")
+  setParameters("{\"che.audio.custom_bitrate\":128000}")
+  setParameters("{\"che.audio.input_channels\":2}")
+  ```
+
+  ```swift
+  rtcKit.setAudioProfile(.musicHighQualityStereo)
+  rtcKit.setAudioScenario(.gameStreaming)
+  rtcKit.setParameters("{\"che.audio.enable.aec\":false}")
+  rtcKit.setParameters("{\"che.audio.enable.ns\":false}")
+  rtcKit.setParameters("{\"che.audio.enable.agc\":false}")
+  rtcKit.setParameters("{\"che.audio.custom_payload_type\":78}")
+  rtcKit.setParameters("{\"che.audio.custom_bitrate\":128000}")
+  rtcKit.setParameters("{\"che.audio.input_channels\":2}")
+  ```
+
+
+- （普通直播）当主播未使用声卡采集音频时，设置高音质：
+
+  ```kotlin
+  setAudioProfile(Constants.MUSIC_HIGH_QUALITY_STEREO)
+  setAudioScenario(Constants.AUDIO_SCENARIO_GAME_STREAMING)
+  setParameters("{\"che.audio.custom_bitrate\":128000}")
+  setParameters("{\"che.audio.custom_payload_type\":78}")
+  ```
+
+  ```swift
+  rtcKit.setAudioProfile(.musicHighQualityStereo)
+  rtcKit.setAudioScenario(.gameStreaming)
+  rtcKit.setParameters("{\"che.audio.custom_bitrate\":128000}")
+  rtcKit.setParameters("{\"che.audio.custom_payload_type\":78}")
+  ```
+
+<div class="alert note">上述高音质设置仅适用于语聊房。如果在其他场景解决方案中需要设置高音质，可以联系<a href="/cn/Agora%20Platform/ticket?platform=All%20Platforms">声网技术支持</a>进行咨询。</div>
+
+## 播放背景音乐和音效
+
+播放背景音乐和音效可以活跃语聊房内的气氛。本节介绍如何在语聊房中播放多种来源的音乐：
+
+- 本地音乐文件或在线音乐文件。
+- 声网在 GitHub 上提供开源示例项目的版权音乐。
+- 第三方厂商提供的版权音乐。
+
+### 本地音乐文件或在线音乐文件
+
+如果主播使用的音乐文件是本地文件或在线文件，播放方式有如下两种：
+
+- 调用声网 RTC SDK 中的 [`startAudioMixing`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_startaudiomixing22) 方法播放文件。
+
+- 使用声网 RTC SDK 中[内置媒体播放器](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/media_player_android_ng?platform=Android)来播放文件。
+
+### 声网版权音乐
+
+声网和[中国音像著作权集体管理协会](https://www.cavca.org)合作提供了数十万首热门歌曲。声网支持你在语聊房和直播间播放有版权的背景音乐。你可以参考如下步骤使用声网版权音乐来给语聊房增加趣味性：
+
+1. 联系 sales@shengwang.cn 开通声网版权音乐和内容中心服务。
+
+2. 在你的业务服务器中，通过 RESTful API 向声网内容中心获取歌曲详细信息，并将信息保存在你的服务端。详见[声网内容中心 RESTful API](https://docportal.shengwang.cn/cn/online-ktv/ktv_song_rest?platform=All%20Platforms)。
+
+3. 在你的业务客户端中，增加歌曲搜索和点歌的功能。当用户点击播放某首歌曲时，你需要获得歌曲的 `SongCode`（标识音乐资源的编号），然后通过声网 RTC SDK 中的[版权音乐 API](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_drm.html) 预加载歌曲，通过声网 RTC SDK 中[内置媒体播放器](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/media_player_android_ng?platform=Android)播放歌曲。详见[客户端实现点歌](https://docportal.shengwang.cn/cn/online-ktv/ktv_integration_android?platform=Android)。
+
+4. 如果需要展示歌词，你可以通过版权音乐 API 和 `SongCode` 来获取歌词文件地址，获取后你就可以展示歌词。详见[歌词组件](https://docportal.shengwang.cn/cn/online-ktv/ktv_karaoke_view_android?platform=Android)。
+
+
+### 第三方版权音乐
+
+你还可以在语聊房中使用第三方厂商提供的版权音乐，例如[腾讯正版曲库直通车（AME）](https://cloud.tencent.com/product/ame)。参考如下步骤在语聊房中播放第三方版权音乐：
+
+1. 在你的业务客户端中，通过第三方版权音乐 SDK 实现歌曲搜索、点歌功能。当用户选中歌曲播放时，你需要使用第三方版权音乐 SDK 对音乐进行解码，但不进行播放。
+
+2. 通过第三方版权音乐 SDK 的原始音频数据 API，获取 PCM 格式的原始音频数据。
+
+3. 通过[声网音频自采集功能](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/custom_audio_src_android_ng?platform=Android)将你之前获取的原始音频数据发送给声网 RTC SDK。声网 RTC SDK 内部会自动将麦克风采集到的声音和第三方版权音乐的歌曲声混合，并发送到声网 RTC 频道中，频道内的听众都可以听到这个混音。
+
+<div class="alert note">声网建议你在自采集音频时，将<a href="https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_imediaengine_createcustomaudiotrack"><code>createCustomAudioTrack</code></a> 方法中的 <code>enableLocalPlayback</code> 字段设置为 <code>true</code>，以使第三方音频可以在本地播放。</div>
+
+
+## 增加音量波纹提示
+
+语聊房中的音量波纹提示功能可以让房间的听众看到谁正在发言。该功能的实现流程如下：
+
+1. 调用声网 RTC SDK 中的 [`enableAudioVolumeIndication`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#api_irtcengine_enableaudiovolumeindication) 方法启用音量提示功能，建议你在启用音量提示时设置音量提示时间间隔为 500 毫秒。
+
+2. 你可以从 SDK 触发的 [`onAudioVolumeIndication`](https://docportal.shengwang.cn/cn/live-streaming-premium-4.x/API%20Reference/java_ng/API/toc_audio_process.html#callback_irtcengineeventhandler_onaudiovolumeindication) 回调获得本地和远端讲话者的音量信息。建议你在 `volume` 值大于 20 时给出音量提示并在 UI 上制作音量对应的波纹效果。
+
diff --git a/markdown/chatroom/hide.md b/markdown/chatroom/hide.md
new file mode 100644
index 00000000000..7ccae296614
--- /dev/null
+++ b/markdown/chatroom/hide.md
@@ -0,0 +1,153 @@
+## CDN听众 
+
+### rtc房间内的语音流旁路推流到CDN
+
+一般，语音聊天室中的音频还可能会被旁路推流到CDN，主要使用场景有以下两种：
+
+1. 在语聊房应用中，可以通过H5链接的方式分享整个房间到微信、QQ等社交平台，其它人通过点击H5链接的方式收听整个聊天室中的内容，同时可以引导新用户下载语聊应用。
+
+2. 语音留档审核，一般语音聊天室的内容需要存储一段时间用来做审核，所以可以通过CDN流的方式让审核方做录制审核。
+
+![](https://docimg5.docs.qq.com/image/AgAACiNGFGPHrQbz9fFBZ418uV0dvsQN.png?w=1056&h=352)
+
+声网在 GitHub 上提供开源示例项目服务端旁路推流服务，可以把频道内的所有主播的声音混流成一路推流到第三方CDN，详情请参考 [声网旁路推流服务](https://docs-preprod.agora.io/cn/media-push/streaming_product?platform=All%20Platforms)。
+
+### 听众通过播放器拉CDN流播放 
+
+语音聊天室的音频经过声网旁路推流服务推流到CDN之后，听众端可以使用声网SDK中自带的播放器做CDN流播放。 
+
+示例代码(iOS)：
+
+```
+@interface MIMediaPlayer : NSObject<AgoraRtcMediaPlayerProtocol>
+
+@end
+
+@interface ViewController ()<AgoraRtcEngineDelegate,AgoraRtcMediaPlayerDelegate>
+@property (nonatomic,strong) AgoraRtcEngineKit *agoraKit;
+@property (nonatomic,strong) MIMediaPlayer *miPlayer;
+@property (weak, nonatomic) IBOutlet UIView *playerView;
+
+@end
+
+@implementation ViewController
+
+- (void)initAgoraEngine
+{
+    AgoraRtcEngineConfig *config = [[AgoraRtcEngineConfig alloc] init];
+    // 传入 App ID。
+    config.appId = @"";
+    // 设置频道场景为直播。
+    config.channelProfile = AgoraChannelProfileLiveBroadcasting;
+    // 创建并初始化 AgoraRtcEngineKit 实例。
+    self.agoraKit = [AgoraRtcEngineKit sharedEngineWithConfig:config delegate:self];
+
+    self.miPlayer = [self.agoraKit createMediaPlayerWithDelegate:self];
+}
+
+- (void)playCdnStream
+{
+    NSString *cdnPlayUrl = @"";  // CDN拉流地址
+    [self.miPlayer setView:self.playerView];
+    self.playerView.backgroundColor = [UIColor redColor];
+    [self.miPlayer open:musicPath startPos:0];
+}
+
+- (void)AgoraRtcMediaPlayer:(id<AgoraRtcMediaPlayerProtocol> _Nonnull)playerKit
+          didChangedToState:(AgoraMediaPlayerState)state
+                      error:(AgoraMediaPlayerError)error
+{
+    if (state == AgoraMediaPlayerStateOpenCompleted) {
+        [self.miPlayer play];
+    }
+}
+@end
+```
+
+示例代码(Android)：
+
+```
+public class MainActivity extends AppCompatActivity {
+
+    private RtcEngine mRtcEngine;
+    private IMediaPlayer mPlayer;
+
+	private final  IMediaPlayerObserver mMiPlayerHandler = new IMediaPlayerObserver() {
+        @Override
+        public void onPlayerStateChanged(io.agora.mediaplayer.Constants.MediaPlayerState state, io.agora.mediaplayer.Constants.MediaPlayerError error) {
+            if (state == io.agora.mediaplayer.Constants.MediaPlayerState.PLAYER_STATE_OPEN_COMPLETED){
+                mPlayer.play();
+            }
+        }
+
+        @Override
+        public void onPositionChanged(long position_ms) {}
+
+        @Override
+        public void onPlayerEvent(io.agora.mediaplayer.Constants.MediaPlayerEvent eventCode, long elapsedTime, String message) {}
+
+        @Override
+        public void onMetaData(io.agora.mediaplayer.Constants.MediaPlayerMetadataType type, byte[] data) {}
+
+        @Override
+        public void onPlayBufferUpdated(long playCachedBuffer) {}
+
+        @Override
+        public void onPreloadEvent(String src, io.agora.mediaplayer.Constants.MediaPlayerPreloadEvent event) {}
+
+        @Override
+        public void onCompleted() {}
+
+        @Override
+        public void onAgoraCDNTokenWillExpire() {}
+
+        @Override
+        public void onPlayerSrcInfoChanged(SrcInfo from, SrcInfo to) {}
+
+        @Override
+        public void onPlayerInfoUpdated(PlayerUpdatedInfo info) {}
+
+        @Override
+        public void onAudioVolumeIndication(int volume) {}
+    };
+
+
+    private void mPlayerToPlay(){
+        mPlayer.open("",0);  // 打开播放的视频，可以是在线地址，也可以是本地视频
+    }
+
+    private void initializeEngine(){
+        try {
+            mRtcEngine = RtcEngine.create(getBaseContext(),getString(R.string.agora_app_id),mRtcEventHandler);
+            // 其它rtc engine配置
+            mPlayer =  mRtcEngine.createMediaPlayer();
+            mPlayer.registerPlayerObserver(mMiPlayerHandler);
+
+            VideoCanvas videoCanvas = new VideoCanvas(mLocalView, Constants.RENDER_MODE_HIDDEN, Constants.VIDEO_MIRROR_MODE_AUTO,
+                Constants.VIDEO_SOURCE_MEDIA_PLAYER,  mPlayer.getMediaPlayerId(), 0);
+        mRtcEngine.setupLocalVideo(videoCanvas);
+        }catch (Exception e){
+            throw new RuntimeException("NEED TO check rtc sdk init fatal error\n"+ Log.getStackTraceString(e));
+        }
+    }
+}
+
+```
+
+# 竞品相关
+
+火山引擎
+
+[https://www.volcengine.com/docs/6348/117919](https://www.volcengine.com/docs/6348/117919)
+
+zego
+
+[https://doc-zh.zego.im/article/15943.html](https://doc-zh.zego.im/article/15943.html)
+
+TRTC
+
+[https://cloud.tencent.com/document/product/647/46252](https://cloud.tencent.com/document/product/647/46252)
+
+阿里
+
+[https://help.aliyun.com/document_detail/176832.htm](https://help.aliyun.com/document_detail/176832.htm)
\ No newline at end of file
diff --git "a/markdown/chatroom/\346\210\277\344\270\273\351\202\200\350\257\267.wsd" "b/markdown/chatroom/\346\210\277\344\270\273\351\202\200\350\257\267.wsd"
new file mode 100644
index 00000000000..81da618e7b2
--- /dev/null
+++ "b/markdown/chatroom/\346\210\277\344\270\273\351\202\200\350\257\267.wsd"
@@ -0,0 +1,18 @@
+@startuml
+autonumber
+participant "房主" as a
+participant "声网即时通讯（IM）SDK" as b #White
+participant "听众" as c
+a -> b: 发送上麦邀请
+b --> c: 发送上麦邀请
+c -> c: 弹出上麦邀请的弹窗
+alt #LightCyan 拒绝
+c -> b: 拒绝上麦邀请
+else #White 接受
+c -> b: 同意上麦邀请
+end
+b --> a: 设置聊天室属性，通知全员刷新房间设置
+a -> a: 刷新 UI
+b --> c: 设置聊天室属性，通知全员刷新房间设置
+c -> c: 刷新 UI
+@enduml
\ No newline at end of file
diff --git "a/markdown/chatroom/\346\227\266\345\272\217\345\233\276.wsd" "b/markdown/chatroom/\346\227\266\345\272\217\345\233\276.wsd"
new file mode 100644
index 00000000000..48c3367892c
--- /dev/null
+++ "b/markdown/chatroom/\346\227\266\345\272\217\345\233\276.wsd"
@@ -0,0 +1,38 @@
+@startuml
+autonumber
+participant "App" as a
+participant "声网云服务\n（Service）" as b #White
+participant "声网 IM SDK" as c
+participant "声网 RTC SDK" as d
+== 获取房间列表 ==
+a -> b: 获取房间列表 \ngetRoomList
+b -->> a: 显示房间列表
+== 登录 IM 系统 ==
+a -> c: AgoraChatClient.shared().login(）
+c -->> a: 登录成功
+== 初始化 AgoraRtcEngineKit ==
+a -> d: AgoraRtcEngineKit.sharedEngineWithAppId()
+d -->> a: 初始化成功
+== 创建并进入房间 ==
+a -> b: 创建房间 \ncreateRoom
+b -->> a: 创建房间成功
+a -> b: 加入房间 \njoinRoom
+b -->> a: 加入房间成功
+a -> c: 加入聊天室 \njoinChatroom
+a -> d: 加入频道 \njoinChannel
+c -->> a: 加入聊天室成功
+d -->> a: 加入频道成功
+== 麦位管理 ==
+...
+== 离开语聊房 ==
+a -> b: 离开房间 \nleaveRoom
+a -> d: 离开频道 \nleaveChannel
+a -> c: 离开聊天室 \nleaveChatroom
+a -> c: 销毁聊天室 \ndestroyChatroom
+a -> d: 销毁 AgoraRtcEngineKit \ndestroy
+b -->> a: 离开房间成功
+d -->> a: 离开频道成功
+c -->> a: 离开聊天室成功
+c -->> a: 销毁聊天室成功
+@enduml
+
diff --git "a/markdown/chatroom/\350\247\202\344\274\227\347\224\263\350\257\267.wsd" "b/markdown/chatroom/\350\247\202\344\274\227\347\224\263\350\257\267.wsd"
new file mode 100644
index 00000000000..8c3d5dfc812
--- /dev/null
+++ "b/markdown/chatroom/\350\247\202\344\274\227\347\224\263\350\257\267.wsd"
@@ -0,0 +1,14 @@
+@startuml
+autonumber
+participant "房主" as a
+participant "声网即时通讯（IM）SDK" as b #White
+participant "听众" as c
+c -> b: 发送上麦申请
+b --> a: 发送上麦申请
+a -> a: 更新上麦邀请列表
+a -> b: 同意上麦申请，更新麦位信息
+b --> c: 设置聊天室属性，通知全员刷新房间设置
+c -> c: 刷新 UI
+b --> a: 设置聊天室属性，通知全员刷新房间设置
+a -> a: 刷新 UI
+@enduml
\ No newline at end of file