@tencentcloud/sdk-mcp 1.6.8 → 1.7.1

package/resource/knowledge/chat/preset/ios-uikit/integration.md

@@ -1165,3 +1165,4 @@ end
 ##### 表情包的使用
 
 为了尊重版权，IM Demo/TUIKit 工程中默认不包含大表情元素切图。正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的**小黄脸表情包版权归腾讯云所有**，可有偿授权使用，如需获得授权，您可以通过升级至 [IM 企业版套餐](https://buy.cloud.tencent.com/avc) 免费使用该表情包。
+

package/resource/knowledge/chat/preset/react/features/conversation-preview.md

@@ -91,3 +91,4 @@ const App = () => {
 ```
 
 `ConversationListPreview` 定制后效果如下：
+

package/resource/knowledge/chat/preset/react/features/message-input.md

@@ -13,7 +13,8 @@ MessageInput 是一个功能完整的消息输入组件，提供了文本编辑
 |className|string|undefined|根容器自定义 CSS 类名|
 |style|React.CSSProperties|undefined|根容器自定义内联样式|
 |attachmentPickerMode|'collapsed' \| 'expanded'|'collapsed'|附件选择器显示模式|
-|actions|MessageInputActions|['EmojiPicker', 'AttachmentPicker']|工具栏操作按钮配置|
+|actions|MessageInputActions|['EmojiPicker', 'FilePicker']|工具栏操作按钮配置|
+|setOfflinePushInfo|(payload: SendMessagePayload) => OfflinePushInfo \| undefined|undefined|发送消息时修改携带的离线推送参数|
 |slots|MessageInputSlots|undefined|插槽配置对象|
 |TextEditor|JSX.Element|undefined|自定义文本编辑器组件|
 |EmojiPicker|JSX.Element|undefined|自定义表情选择器组件|
@@ -73,8 +74,8 @@ attachmentPickerMode 用于设置附件选择器的显示模式，默认值为 `
    >
    > 默认的 AttachmentPicker 意为附件选择器，包括文件选择、图片选择和视频选择。
    >
-   > 1. 当 attachmentPickerModel 为 "collapsed" 时，点击附件选择器会弹出一个 popup 菜单展示文件选择、图片选择、视频选择。
-   > 2. 当 attachmentPickerModel 为 "expanded" 时，附件选择器会默认展开，平铺展示文件选择、图片选择、视频选择。
+   > 1. 当 attachmentPickerMode 为 "collapsed" 时，点击附件选择器会弹出一个 popup 菜单展示文件选择、图片选择、视频选择。
+   > 2. 当 attachmentPickerMode 为 "expanded" 时，附件选择器会默认展开，平铺展示文件选择、图片选择、视频选择。
 
 ### actions
 
@@ -186,6 +187,63 @@ function CustomerServiceChat() {
 }
 ```
 
+### setOfflinePushInfo
+
+参数类型：`(payload: SendMessagePayload) => OfflinePushInfo | undefined`
+
+setOfflinePushInfo 用于在发送前根据当前的消息内容设置自定义的离线推送参数。
+``` typescript
+type SendMessagePayload = {
+    type: 'textMessage';
+    text: string;
+} | {
+    type: 'customMessage';
+    customData: string;
+    description?: string;
+    extensionInfo?: string;
+} | {
+    type: 'imageMessage';
+    file: File | HTMLInputElement;
+    width?: number;
+    height?: number;
+} | {
+    type: 'audioMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+} | {
+    type: 'videoMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+    snapshotFile?: File | HTMLInputElement;
+    snapshotWidth?: number;
+    snapshotHeight?: number;
+} | {
+    type: 'fileMessage';
+    file: File | HTMLInputElement;
+} | {
+    type: 'locationMessage';
+    description: string;
+    longitude: number;
+    latitude: number;
+} | {
+    type: 'faceMessage';
+    index: number;
+    data: string;
+};
+
+interface OfflinePushInfo {
+    title: string;
+    description: string;
+    extensionInfo: {
+      disablePush: boolean;
+      disableVoipPush: boolean;
+      extension: string;
+      androidInfo: Record<string, any>;
+      apnsInfo: Record<string, any>;
+    };
+}
+```
+
 ### slots
 
 参数类型: `MessageInputSlots`

package/resource/knowledge/chat/preset/react/features/message-list.md

@@ -10,6 +10,7 @@ MessageList 是一个功能强大的聊天消息列表组件，提供了完整
 | messageActionList | IMessageAction[] | ['copy', 'recall', 'quote', 'forward', 'delete'] | 自定义消息操作列表，例如复制、撤回、删除等。 |
 | messageAggregationTime | number | 300 (5分钟) | 消息聚合时间间隔（秒），相同发送者在此时间内的连续消息会被聚合显示。 |
 | filter | (message: MessageInfo) => boolean | undefined | 消息过滤函数，用于控制哪些消息需要显示。 |
+| showSelfAvatar | boolean | false | 自己发出的消息是否展示头像。 |
 | className | string | undefined | 自定义 CSS 类名。 |
 | style | React.CSSProperties | undefined | 自定义内联样式。 |
 | Message | React.ComponentType | Message | 自定义消息组件。 |
@@ -175,6 +176,12 @@ function ChatApp() {
 }
 ```
 
+### showSelfAvatar
+
+参数类型: `boolean`
+
+为了更好的利用屏幕效率，自己发送的消息默认不展示头像，默认值为 `false`。
+
 ### className
 
 参数类型: `string`

package/resource/knowledge/chat/preset/vue/features/message-input.md

@@ -10,6 +10,7 @@ MessageInput 是一个功能完整的消息输入组件，专为 Vue3 应用设
 |disabled|boolean|false|是否禁用输入组件|
 |placeholder|string|''|输入框占位符文本|
 |actions|MessageInputActions|['EmojiPicker', 'ImagePicker', 'FilePicker', 'VideoPicker']|工具栏操作按钮配置|
+|setOfflinePushInfo|(payload: SendMessagePayload) => OfflinePushInfo \| undefined|undefined|发送消息时修改携带的离线推送参数|
 
 ## Slots 配置
 
@@ -35,11 +36,6 @@ MessageInput 是一个功能完整的消息输入组件，专为 Vue3 应用设
 
 - 详细说明：disabled 用于设置是否禁用整个输入组件，包括文本输入和所有操作按钮，默认值为 `false`。
 
-### hideSendButton
-- 类型：`boolean`
-
-- 详细说明：hideSendButton 用于设置是否隐藏发送按钮，适用于需要自定义发送触发方式的场景，默认值为 `false`。
-
 ### placeholder
 - 类型：`string`
 
@@ -357,6 +353,63 @@ const CustomEmojiPicker = defineComponent({
 
 示例效果：
 
+### setOfflinePushInfo
+
+参数类型：`(payload: SendMessagePayload) => OfflinePushInfo | undefined`
+
+setOfflinePushInfo 用于在发送前根据当前的消息内容设置自定义的离线推送参数。
+``` typescript
+type SendMessagePayload = {
+    type: 'textMessage';
+    text: string;
+} | {
+    type: 'customMessage';
+    customData: string;
+    description?: string;
+    extensionInfo?: string;
+} | {
+    type: 'imageMessage';
+    file: File | HTMLInputElement;
+    width?: number;
+    height?: number;
+} | {
+    type: 'audioMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+} | {
+    type: 'videoMessage';
+    file: File | HTMLInputElement;
+    duration: number;
+    snapshotFile?: File | HTMLInputElement;
+    snapshotWidth?: number;
+    snapshotHeight?: number;
+} | {
+    type: 'fileMessage';
+    file: File | HTMLInputElement;
+} | {
+    type: 'locationMessage';
+    description: string;
+    longitude: number;
+    latitude: number;
+} | {
+    type: 'faceMessage';
+    index: number;
+    data: string;
+};
+
+interface OfflinePushInfo {
+    title: string;
+    description: string;
+    extensionInfo: {
+      disablePush: boolean;
+      disableVoipPush: boolean;
+      extension: string;
+      androidInfo: Record<string, any>;
+      apnsInfo: Record<string, any>;
+    };
+}
+```
+
 ## Slots 详解
 - 类型：`MessageInputSlots`
 

package/resource/knowledge/chat/preset/vue/features/message-list.md

@@ -50,6 +50,7 @@ import { UIKitProvider, Chat, MessageList, MessageInput } from '@tencentcloud/ch
 |messageActionList|MessageAction[]|undefined|自定义消息操作列表，例如撤回、删除等。|
 |messageAggregationTime|number|300 (秒)|消息聚合的时间间隔（秒），在此时间内发送的同一发送者的消息会被聚合。设置为 0 可禁用消息聚合。|
 |filter|(message: MessageInfo) => boolean|undefined|自定义消息过滤函数，用于控制哪些消息应该显示。|
+|showSelfAvatar|boolean|false|自己发出的消息是否展示头像。|
 |enableReadReceipt|boolean|false|是否启用消息已读回执功能。|
 |Message|Component|undefined|自定义消息组件，用于渲染单条消息。|
 |MessageTimeDivider|Component|undefined|自定义消息时间分割线组件。|
@@ -228,6 +229,12 @@ const customMessageFilter = (message: MessageInfo): boolean => {
 </script>
 ```
 
+### showSelfAvatar
+
+参数类型: `boolean`
+
+为了更好的利用屏幕效率，自己发送的消息默认不展示头像，默认值为 `false`。
+
 ### Message
 - 类型：Component | undefined
 

package/resource/knowledge/chat/urls/product.md

@@ -24,18 +24,18 @@
 | 单聊消息权限控制与配置 | `https://cloud.tencent.com/document/product/269/3662` |
 | 群组消息管理（App 管理员发送消息/群消息发送控制/消息优先级与频率控制
 ） | `https://cloud.tencent.com/document/product/269/3663` |
-| 不同类型群组基础能力操作差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组加群方式差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组成员管理能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组群组限制差异 | `https://cloud.tencent.com/document/product/269/1502` |
-| 不同类型群组消息能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组基础能力操作差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组加群方式差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组成员管理能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组限制差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组消息能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
 | 群组/群成员/群消息导入 | `https://cloud.tencent.com/document/product/269/1502` |
 | 群组自动回收能力 | `https://cloud.tencent.com/document/product/269/1502` |
 | 自定义群组ID(话题 ID) | `https://cloud.tencent.com/document/product/269/1502` |
 | 群组自定义字段 | `https://cloud.tencent.com/document/product/269/1502` |
 | 云端审核能力介绍 | `https://cloud.tencent.com/document/product/269/83795` |
 
-### 使用限制
+## 使用限制
 
 | 子问题 | 目标文档 |
 |--------|---------|
@@ -46,7 +46,7 @@
 | 关系链管理限制（添加与删除好友限制/好友分组限制/黑名单限制/批量好友接口上限等） | `https://cloud.tencent.com/document/product/269/32429` |
 | 群组管理限制（群主转让/群成员禁言/群封禁人数限制/群计数器限制/群自定义字段数等） | `https://cloud.tencent.com/document/product/269/32429` |
 
-## 出海解决方案
+## 海外解决方案
 
 | 子问题 | 目标文档 |
 |--------|---------|
@@ -54,7 +54,7 @@
 | 海外节点全球加速 | `https://cloud.tencent.com/document/product/269/86463` |
 | 海外数据安全合规 | `https://cloud.tencent.com/document/product/269/86464` |
 
-## 场景解决方案
+## 内网代理实现方案
 
 | 子问题 | 目标文档 |
 |--------|---------|

package/resource/knowledge/chat/urls/restapi.md

@@ -1,10 +1,10 @@
 # 服务端 REST API — 官方文档 URL 映射
 
-### 通用技术
+## 通用技术
 
 | 子问题 | 目标文档 |
 |--------|---------|
-| UserSig 生成方法（登录鉴权） | `https://cloud.tencent.com/document/product/269/32688` |
+| UserSig 生成方法 | `https://cloud.tencent.com/document/product/269/32688` |
 | 服务端消息格式 | `https://cloud.tencent.com/document/product/269/2720` |
 
 ## 消息相关 REST API
@@ -19,8 +19,8 @@
 | 发送 C2C 流式消息 | `https://cloud.tencent.com/document/product/269/128596` |
 | 发送群流式消息 | `https://cloud.tencent.com/document/product/269/128597` |
 | 直播群广播消息 | `https://cloud.tencent.com/document/product/269/77402` |
-| 导入群消息 | `https://cloud.tencent.com/document/product/269/1635` |
 | 导入单聊消息 | `https://cloud.tencent.com/document/product/269/2568` |
+| 导入群消息 | `https://cloud.tencent.com/document/product/269/1635` |
 | 公众号用户发送广播消息 | `https://cloud.tencent.com/document/product/269/102298` |
 
 ### 历史消息

package/resource/knowledge/chat/urls/sdk/android.md

@@ -1,20 +1,20 @@
 # Android — SDK 官方文档 URL 映射
 
-## A — SDK 集成和初始化（Android）
+## SDK 集成和初始化（Android）
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | Android SDK 集成 | `https://cloud.tencent.com/document/product/269/75283` |
 | Android SDK 初始化 | `https://cloud.tencent.com/document/product/269/75291` |
 
-## B — 登录
+## 登录与鉴权
 
 | 子问题 | 目标文档 |
 |--------|---------|
-| 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75294` |
-| 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75294` |
+| 登录（`login`） | `https://cloud.tencent.com/document/product/269/75294` |
+| 登出（`logout`） | `https://cloud.tencent.com/document/product/269/75294` |
 
-## C — SDK API 使用
+## SDK API 使用
 
 | 子问题 | 目标文档 |
 |--------|---------|

package/resource/knowledge/chat/urls/sdk/flutter.md

@@ -1,20 +1,20 @@
 # Flutter — SDK 官方文档 URL 映射
 
-## A — SDK 集成和初始化（Flutter）
+## SDK 集成和初始化（Flutter）
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | Flutter SDK 集成 | `https://cloud.tencent.com/document/product/269/75286` |
 | Flutter SDK 初始化 | `https://cloud.tencent.com/document/product/269/75293` |
 
-## B — 多端登录配置与 UserSig 鉴权
+## 登录与鉴权
 
 | 子问题 | 目标文档 |
 |--------|---------|
-| 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75296` |
-| 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75296` |
+| 登录（`login`） | `https://cloud.tencent.com/document/product/269/75296` |
+| 登出（`logout`） | `https://cloud.tencent.com/document/product/269/75296` |
 
-## C — SDK API 使用
+## SDK API 使用
 
 | 子问题 | 目标文档 |
 |--------|---------|

package/resource/knowledge/chat/urls/sdk/ios.md

@@ -1,20 +1,20 @@
 # iOS — SDK 官方文档 URL 映射
 
-## A — SDK 集成和初始化（iOS）
+## SDK 集成和初始化（iOS）
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | iOS SDK 集成 | `https://cloud.tencent.com/document/product/269/75284` |
 | iOS SDK 初始化 | `https://cloud.tencent.com/document/product/269/75291` |
 
-## B — 登录
+## 登录与鉴权
 
 | 子问题 | 目标文档 |
 |--------|---------|
-| 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75294` |
-| 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75294` |
+| 登录（`login`） | `https://cloud.tencent.com/document/product/269/75294` |
+| 登出（`logout`） | `https://cloud.tencent.com/document/product/269/75294` |
 
-## C — SDK API 使用
+## SDK API 使用
 
 | 子问题 | 目标文档 |
 |--------|---------|

package/resource/knowledge/chat/urls/sdk/web.md

@@ -1,29 +1,29 @@
 # Web — SDK 官方文档 URL 映射
 
-## A — SDK 集成和初始化（Web & 小程序）
+## SDK 集成和初始化（Web & 小程序）
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | Web 端集成和初始化（V4） | `https://cloud.tencent.com/document/product/269/75285` |
 | 小程序端集成和初始化（V4） | `https://cloud.tencent.com/document/product/269/117335` |
 
-## B — 登录
+## 登录与鉴权
 
 | 子问题 | 目标文档 |
 |--------|---------|
-| 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75295` |
-| 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75295` |
+| 登录（`login`） | `https://cloud.tencent.com/document/product/269/75295` |
+| 登出（`logout`） | `https://cloud.tencent.com/document/product/269/75295` |
 
-## C — SDK API 使用
+## SDK API 使用
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | SDK 消息类型介绍 | `https://cloud.tencent.com/document/product/269/75314` |
-| IM 消息 Payload 结构（Message payload） | `https://web.sdk.qcloud.com/im/doc/v3/zh-cn/Message.html` |
+| 消息结构与 Payload 字段（Message payload） | `https://web.sdk.qcloud.com/im/doc/v3/zh-cn/Message.html` |
 | 文本消息（createTextMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
 | 群 @ 消息（createTextAtMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
 | 图片消息（createImageMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
-| 语音消息（createVoiceMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
+| 语音消息（createAudioMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
 | 视频消息（createVideoMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
 | 文件消息（createFileMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
 | 自定义消息（createCustomMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75316` |
@@ -76,7 +76,7 @@
 | 云端搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/114760` |
 | 云端搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/114763` |
 
-## D — 版本升级指南
+## 版本升级指南
 
 | 子问题 | 目标文档 |
 |--------|---------|

package/resource/knowledge/chat/urls/webhook.md

@@ -1,49 +1,43 @@
 # 服务端回调（Webhook）— 官方文档 URL 映射
 
-## 回调概览
-
-| 子问题 | 目标文档 |
-|--------|---------|
-| 第三方回调概览 / 配置方法 / 规范 | `https://cloud.tencent.com/document/product/269/1522` |
-
-## 在线状态相关回调
+## 在线状态回调
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | 用户状态变更回调 | `https://cloud.tencent.com/document/product/269/2570` |
 | 更新用户资料后回调 | `https://cloud.tencent.com/document/product/269/76489` |
 
-## 资料关系链相关回调
+## 资料关系链回调
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | 添加好友之前回调 | `https://cloud.tencent.com/document/product/269/61698` |
-| 添加好友回应之前回调 | `https://cloud.tencent.com/document/product/269/61699` |
+| 添加好友请求回应之前回调 | `https://cloud.tencent.com/document/product/269/61699` |
 | 添加好友之后回调 | `https://cloud.tencent.com/document/product/269/1657` |
 | 删除好友之后回调 | `https://cloud.tencent.com/document/product/269/1659` |
 | 添加黑名单之后回调 | `https://cloud.tencent.com/document/product/269/1660` |
 | 删除黑名单之后回调 | `https://cloud.tencent.com/document/product/269/1661` |
 
-## 关注与粉丝相关回调
+## 关注与粉丝回调
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | 关注用户之后回调 | `https://cloud.tencent.com/document/product/269/118915` |
 | 取关用户之后回调 | `https://cloud.tencent.com/document/product/269/118916` |
 
-## 单聊消息相关回调
+## 单聊消息回调
 
 | 子问题 | 目标文档 |
 |--------|---------|
 | 设置单聊消息扩展回调 | `https://cloud.tencent.com/document/product/269/126475` |
-| 发单聊消息之前回调 | `https://cloud.tencent.com/document/product/269/1632` |
-| 发单聊消息之后回调 | `https://cloud.tencent.com/document/product/269/2716` |
+| 单聊消息发送之前回调 | `https://cloud.tencent.com/document/product/269/1632` |
+| 单聊消息发送之后回调 | `https://cloud.tencent.com/document/product/269/2716` |
 | 单聊消息已读上报后回调 | `https://cloud.tencent.com/document/product/269/61696` |
 | 单聊消息撤回后回调 | `https://cloud.tencent.com/document/product/269/61697` |
 | 单聊单条消息已读回执之后回调 | `https://cloud.tencent.com/document/product/269/128223` |
 | 单聊消息编辑之后回调 | `https://cloud.tencent.com/document/product/269/128224` |
 
-## 群组系统相关回调
+## 群组系统回调
 
 | 子问题 | 目标文档 |
 |--------|---------|
@@ -54,14 +48,14 @@
 | 拉人入群之前回调 | `https://cloud.tencent.com/document/product/269/1666` |
 | 新成员入群之后回调 | `https://cloud.tencent.com/document/product/269/1667` |
 | 群成员离开之后回调 | `https://cloud.tencent.com/document/product/269/1668` |
-| 群内发言之前回调 | `https://cloud.tencent.com/document/product/269/1619` |
-| 群内发言之后回调 | `https://cloud.tencent.com/document/product/269/2661` |
+| 群消息发送之前回调 | `https://cloud.tencent.com/document/product/269/1619` |
+| 群消息发送之后回调 | `https://cloud.tencent.com/document/product/269/2661` |
 | 群组满员之后回调 | `https://cloud.tencent.com/document/product/269/1669` |
 | 群组解散之后回调 | `https://cloud.tencent.com/document/product/269/1670` |
 | 群组资料变动之后回调 | `https://cloud.tencent.com/document/product/269/2930` |
 | 撤回群消息之后回调 | `https://cloud.tencent.com/document/product/269/73141` |
 | 直播群成员在线状态回调 | `https://cloud.tencent.com/document/product/269/76156` |
-| 发送群聊消息异常回调 | `https://cloud.tencent.com/document/product/269/78619` |
+| 群消息发送异常回调 | `https://cloud.tencent.com/document/product/269/78619` |
 | 创建话题之前回调 | `https://cloud.tencent.com/document/product/269/78206` |
 | 创建话题之后回调 | `https://cloud.tencent.com/document/product/269/78207` |
 | 解散话题之后回调 | `https://cloud.tencent.com/document/product/269/78208` |

package/resource/knowledge/livekit/best-practice/android/voice-room-anchor-start.md

@@ -0,0 +1,124 @@
+---
+title: 语聊房房主创建房间并开播推流（Android）
+product: live
+frameworks: [android]
+scope: platform_specific
+tags: [语聊房, 房主, 开播, 推流, createLive, openLocalMicrophone, muteMicrophone, unmuteMicrophone, LiveListStore, AudioSalon, keepOwnerOnSeat, seatMode, TakeSeatMode, Android]
+version_range: ">=2.0.0"
+---
+
+# 语聊房房主创建房间并开播推流（Android）
+
+## 1. 核心结论
+
+- 语聊房开播流程：构造 `LiveInfo`（含 `liveID`、`seatTemplate`、`keepOwnerOnSeat`、`seatMode`），调用 `createLive` 创建房间；成功后调用 `openLocalMicrophone` 采集音频并发布推流，房间内用户即可听到主播声音。
+- `liveID` 必填，直播间的唯一标识符。
+- `keepOwnerOnSeat` 设为 `true` 时主播进房后自动上麦（上麦是推流的前提，只有上麦的用户才能在房间内推音频流）。
+- `seatTemplate` 设为语聊房模板 `SeatLayoutTemplate.AudioSalon(n)`，n 为套餐支持的最大麦位数或小于该值的麦位数。
+- `seatMode` 设置上麦模式（如 `TakeSeatMode.APPLY` 申请上麦）。
+- `muteMicrophone` 暂停发布本机音频流；`unmuteMicrophone` 恢复发布本机音频流。
+
+## 2. 字段语义对照
+
+| 字段/能力 | 作用 | 说明 |
+|---|---|---|
+| `LiveInfo` | 房间信息 | 包含 `liveID`、`liveName`、`seatTemplate`、`keepOwnerOnSeat`、`seatMode` 等参数 |
+| `liveID` | 房间 ID | `createLive` 必填参数 |
+| `liveName` | 房间名称 | 创建房间的展示名称 |
+| `seatTemplate` | 麦位布局模板 | 语聊房使用 `SeatLayoutTemplate.AudioSalon(seatCount = n)`，n ≤ 套餐最大麦位数 |
+| `keepOwnerOnSeat` | 房主自动上麦 | 设为 `true`，主播进房后自动上麦 |
+| `seatMode` | 上麦模式 | 如 `TakeSeatMode.APPLY` 申请上麦 |
+| `createLive(liveInfo, callback)` | 创建房间（开播） | 传入 `LiveInfo` 和 `LiveInfoCompletionHandler` 回调 |
+| `openLocalMicrophone` | 采集音频并发布 | 打开本地麦克风，发布音频流到房间 |
+| `muteMicrophone` | 暂停发布音频 | 已打开麦克风时，暂停发布本地音频流 |
+| `unmuteMicrophone` | 恢复发布音频 | 已打开麦克风时，恢复发布本地音频流 |
+
+## 3. 机制/时序
+
+构造 `LiveInfo`（`liveID` 必填，`seatTemplate=AudioSalon(n)`，`keepOwnerOnSeat=true`，`seatMode` 按需设置） -> 调用 `createLive` 创建房间 -> `onSuccess` 回调触发，房主默认自动上麦 -> 调用 `openLocalMicrophone` 采集并发布音频 -> 房间内用户听到主播声音。
+
+上麦是推流的前提：`keepOwnerOnSeat=true` 保证房主上麦后才能推音频流。`muteMicrophone` / `unmuteMicrophone` 用于推流过程中的暂停/恢复。
+
+## 4. 标准用法
+
+1. 构造 `LiveInfo`：设置 `liveID`、`seatTemplate`、`keepOwnerOnSeat`、`seatMode`。
+2. 实现 `LiveInfoCompletionHandler`，调用 `createLive` 发起开播。
+3. `onSuccess` 回调后，调用 `openLocalMicrophone` 采集音频并发布推流。
+4. 需要暂停/恢复推流时调用 `muteMicrophone` / `unmuteMicrophone`。
+
+```kotlin
+import android.util.Log
+import androidx.appcompat.app.AppCompatActivity
+import io.trtc.tuikit.atomicxcore.api.live.LiveInfo
+import io.trtc.tuikit.atomicxcore.api.live.LiveInfoCompletionHandler
+import io.trtc.tuikit.atomicxcore.api.live.TakeSeatMode
+
+class YourAnchorActivity : AppCompatActivity() {
+    // ... 其他代码 ...
+
+    private fun startLive() {
+        val liveInfo = LiveInfo().apply {
+            // 1. 设置房间基础信息
+            liveID = this@YourAnchorActivity.liveID
+            liveName = "test 语聊房"
+
+            // 2. 设置语聊房麦位模板，seatCount 传入所需麦位数（≤ 套餐最大麦位数）
+            seatTemplate = SeatLayoutTemplate.AudioSalon(seatCount = 9)
+
+            // 3. 主播开播后自动上麦（上麦后才能推音频流）
+            keepOwnerOnSeat = true
+
+            // 4. 设置上麦模式（例如申请上麦）
+            seatMode = TakeSeatMode.APPLY
+        }
+
+        // 5. 调用 createLive 创建房间（开播）
+        liveListStore.createLive(liveInfo, object : LiveInfoCompletionHandler {
+            override fun onFailure(code: Int, desc: String) {
+                Log.e("Live", "Response startLive onError: $desc")
+            }
+
+            override fun onSuccess(liveInfo: LiveInfo) {
+                Log.d("Live", "Response startLive onSuccess")
+                // 6. 房主创建成功后默认自动上麦，此时调用 openLocalMicrophone 采集并发布音频
+                liveSeatStore.openLocalMicrophone(null)
+            }
+        })
+    }
+}
+```
+
+## 5. 结果判定
+
+- `onSuccess` 回调触发：房间创建成功，房主默认自动上麦。
+- `openLocalMicrophone` 后：房间内用户能听到主播声音。
+- `muteMicrophone` 后：本机音频暂停发布；`unmuteMicrophone` 后恢复。
+- `keepOwnerOnSeat` 未设 `true`：主播未自动上麦，无法推流。
+- `onFailure(code, desc)` 回调触发：开播失败，`code` 为错误码，`desc` 为错误描述。
+
+## 6. 常见误区
+
+- 误区 1：跳过 `createLive` 直接调用 `openLocalMicrophone`（未创建房间无法推流）。
+- 误区 2：`keepOwnerOnSeat` 未设 `true`，主播未上麦，推流不生效。
+- 误区 3：`seatTemplate` 未设置或 `seatCount` 超过套餐最大麦位数。
+- 误区 4：混淆 `muteMicrophone`（暂停发布音频流）与关闭麦克风（停止采集）。
+- 误区 5：`liveID` 重复使用（必须全局唯一，否则创建失败）。
+- 误区 6：混淆 `onSuccess` 和 `onFailure` 回调（两个分支都需防御性处理）。
+
+## 7. 问题定义（检索辅助，极简）
+
+Android 语聊房房主需要按正确顺序创建房间并开播推流，了解 `createLive`、`openLocalMicrophone`、`muteMicrophone`、`unmuteMicrophone` 的调用时机与参数含义。
+
+## 8. 同义问法覆盖（检索召回，极简）
+
+- Android 语聊房房主怎么开播？
+- Android `createLive` 和 `openLocalMicrophone` 的调用顺序是什么？
+- Android 主播怎么上麦推流？
+- `keepOwnerOnSeat` 参数有什么作用？
+- `seatTemplate` 怎么设置语聊房 `AudioSalon` 模板？
+- Android `muteMicrophone` 和 `unmuteMicrophone` 区别是什么？
+- 语聊房创建房间后如何推音频流？
+
+## 9. 参考来源（可选）
+
+- LiveKit Android 文档：`https://cloud.tencent.com/document/product/647/124968`