@tencentcloud/sdk-mcp 1.3.8 → 1.4.0

package/resource/doc/livekit/core-sdk/live/ios/api-reference/LoginStore.md

@@ -0,0 +1,173 @@
+## 简介
+
+**LoginStore** 提供了一套完整的登录管理 API，包括用户登录、登出、设置个人信息等功能。
+通过该类，可以管理用户的登录状态和用户资料。
+
+> **重要：**
+>
+
+> 使用 **shared** 单例对象访问 **LoginStore** 实例。
+>
+
+> **说明：**
+>
+
+> 登录状态更新通过 **state** 发布者传递。订阅它以接收登录状态的实时更新。
+>
+
+## 功能特性
+- **用户登录**：支持使用 SDK 应用 ID、用户 ID 和用户签名进行登录。
+
+- **用户登出**：支持用户登出操作。
+
+- **个人信息设置**：支持设置用户昵称、头像、性别等个人资料。
+
+## 可订阅数据
+
+**LoginState** 的字段描述如下：
+| **属性名** | **类型** | **描述** |
+| --- | --- | --- |
+| loginStatus | LoginStatus | 登录状态。 |
+| loginUserInfo | UserProfile? | 登录用户信息。 |
+
+## API 列表
+| **函数名** | **描述** |
+| --- | --- |
+| shared | 单例对象。 |
+| loginEventPublisher | 登录事件发布者。 |
+| login | 登录。 |
+| logout | 登出。 |
+| setSelfInfo | 设置个人信息。 |
+
+### 获取实例
+
+#### shared
+
+单例对象
+``` swift
+public static let shared: LoginStore = LoginStoreImpl()
+```
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+### 观察事件
+
+#### loginEventPublisher
+
+登录事件发布者
+
+### 登录操作
+
+#### login
+
+登录
+``` swift
+public func login(sdkAppID: Int32, userID: String, userSig: String, completion: CompletionClosure?) {}
+```
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**参数说明**
+| **参数名** | **类型** | **是否必填** | **描述** |
+| --- | --- | --- | --- |
+| sdkAppID | Int32 | 必填 | SDK 应用 ID。 |
+| userID | String | 必填 | 用户 ID。 |
+| userSig | String | 必填 | 用户签名。 |
+| completion | CompletionClosure? | 必填 | 完成回调。 |
+
+#### logout
+
+登出
+``` swift
+public func logout(completion: CompletionClosure?) {}
+```
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**参数说明**
+| **参数名** | **类型** | **是否必填** | **描述** |
+| --- | --- | --- | --- |
+| completion | CompletionClosure? | 必填 | 完成回调。 |
+
+#### setSelfInfo
+
+设置个人信息
+``` swift
+public func setSelfInfo(userProfile: UserProfile, completion: CompletionClosure?) {}
+```
+
+**版本信息**
+
+从 3.5 版本开始支持。
+
+**参数说明**
+| **参数名** | **类型** | **是否必填** | **描述** |
+| --- | --- | --- | --- |
+| userProfile | UserProfile | 必填 | 用户资料。 |
+| completion | CompletionClosure? | 必填 | 完成回调。 |
+
+## 数据结构
+
+### LoginStatus
+
+登录状态。
+| **枚举值** | **说明** |
+| --- | --- |
+| unlogin | 未登录。 |
+| logined | 已登录。 |
+
+### AllowType
+
+好友验证方式。
+| **枚举值** | **值** | **说明** |
+| --- | --- | --- |
+| allowAny | 0 | 允许任何人。 |
+| needConfirm | 1 | 需要验证。 |
+| denyAny | 2 | 拒绝任何人。 |
+
+### Gender
+
+性别。
+| **枚举值** | **值** | **说明** |
+| --- | --- | --- |
+| unknown | 0 | 未知。 |
+| male | 1 | 男性。 |
+| female | 2 | 女性。 |
+
+### LoginEvent
+
+登录事件。
+| **枚举值** | **说明** |
+| --- | --- |
+| kickedOffline | 当前用户被踢下线。 |
+| loginExpired | 登录票据过期。 |
+
+### UserProfile
+
+用户资料。
+| **属性** | **类型** | **说明** |
+| --- | --- | --- |
+| userID | String | 用户 ID。 |
+| nickname | String? | 昵称。 |
+| avatarURL | String? | 头像URL。 |
+| selfSignature | String? | 个性签名。 |
+| gender | Gender? | 性别。 |
+| role | UInt32? | 角色。 |
+| level | UInt32? | 等级。 |
+| birthday | UInt32? | 生日。 |
+| allowType | AllowType? | 好友验证方式。 |
+| customInfo | [String:Data]? | 自定义信息。 |
+
+### LoginState
+
+登录状态。
+| **属性** | **类型** | **说明** |
+| --- | --- | --- |
+| loginStatus | LoginStatus | 登录状态。 |
+| loginUserInfo | UserProfile? | 登录用户信息。 |

package/resource/doc/livekit/{live → core-sdk/live}/ios/live-audience-list.md

@@ -1,8 +1,5 @@
 `LiveAudienceStore` 是 `AtomicXCore` 中专门负责管理直播间观众信息的模块。通过 `LiveAudienceStore`，您可以为您的直播应用构建一套完整的观众列表及管理系统。
 
-![](https://write-document-release-1258344699.cos.ap-guangzhou.tencentcos.cn/100027182498/96da98a0ab3711f09b75525400bf7822.png)
-
-
 ## 核心功能
 - **实时观众列表**：获取并展示当前在直播间内的所有观众信息。
 
@@ -14,72 +11,35 @@
 
 - **房间管理**：主播或管理员可以将任意普通观众请出（踢出）直播间。
 
-
 ## 核心概念
 
 在开始集成之前，我们先通过下表了解一下 LiveAudienceStore 相关的几个核心概念：
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >**核心概念**</td>
-
-<td rowspan="1" colSpan="1" >**类型**</td>
-
-<td rowspan="1" colSpan="1" >**核心职责与描述**</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveUserInfo`</td>
-
-<td rowspan="1" colSpan="1" >struct</td>
-
-<td rowspan="1" colSpan="1" >代表一个观众（用户）的基础信息模型。它包含了用户的唯一标识 (`userID`)、昵称 (`userName`) 和头像地址 (`avatarURL`)。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveAudienceState`</td>
-
-<td rowspan="1" colSpan="1" >struct</td>
-
-<td rowspan="1" colSpan="1" >代表观众模块的当前状态。其核心属性 `audienceList` 是一个 `[LiveUserInfo] `数组，存储了观众列表的快照；`audienceCount` 则代表当前观众总数。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveAudienceEvent`</td>
-
-<td rowspan="1" colSpan="1" >enum</td>
-
-<td rowspan="1" colSpan="1" >代表观众动态的实时事件。分为 `.onAudienceJoined`（观众加入） 和 `.onAudienceLeft`（观众离开）两种，用于实现对观众列表的增量更新。</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >`LiveAudienceStore`</td>
-
-<td rowspan="1" colSpan="1" >class</td>
-
-<td rowspan="1" colSpan="1" >这是与观众列表功能交互的核心管理类。通过它，您可以获取观众列表快照、执行管理操作，并通过订阅其 `liveAudienceEventPublisher` 来接收实时动态。</td>
-</tr>
-</table>
-
+| **核心概念** | **类型** | **核心职责与描述** |
+| --- | --- | --- |
+| `LiveUserInfo` | struct | 代表一个观众（用户）的基础信息模型。它包含了用户的唯一标识 (`userID`)、昵称 (`userName`) 和头像地址 (`avatarURL`)。 |
+| `LiveAudienceState` | struct | 代表观众模块的当前状态。其核心属性 `audienceList` 是一个 `[LiveUserInfo] `数组，存储了观众列表的快照；`audienceCount` 则代表当前观众总数。 |
+| `LiveAudienceEvent` | enum | 代表观众动态的实时事件。分为 `.onAudienceJoined`（观众加入） 和 `.onAudienceLeft`（观众离开）两种，用于实现对观众列表的增量更新。 |
+| `LiveAudienceStore` | class | 这是与观众列表功能交互的核心管理类。通过它，您可以获取观众列表快照、执行管理操作，并通过订阅其 `liveAudienceEventPublisher` 来接收实时动态。 |
 
 ## 实现步骤
 
 ### 步骤1：组件集成
 
-请参考 [开始直播](https://write.woa.com/document/191126382767431680) 集成 **AtomicXCore**，完成接入。
+请参考 开始直播 集成 **AtomicXCore**，完成接入。
 
 ### 步骤2：初始化并获取观众列表
 
 获取一个与当前直播间 liveId 绑定的 `LiveAudienceStore` 实例，并主动拉取一次当前的观众列表，用于首次展示。
 ``` swift
 import Foundation
-import AtomicXCore 
-import Combine     
+import AtomicXCore
+import Combine
 
 class AudienceManager {
     private let liveId: String
     private let audienceStore: LiveAudienceStore
     private var cancellables = Set<AnyCancellable>()
-    
+
     // 对外暴露【全量】观众列表的发布者，方便UI层订阅
     let audienceListPublisher = CurrentValueSubject<[LiveUserInfo], Never>([])
     // 对外暴露观众总数的发布者
@@ -89,11 +49,11 @@ class AudienceManager {
         self.liveId = liveId
         // 1. 通过 liveId 获取 LiveAudienceStore 的实例
         self.audienceStore = LiveAudienceStore.create(liveID: liveId)
-        
+
         // 2. 订阅状态和事件
         subscribeToAudienceState()
         subscribeToAudienceEvents()
-        
+
         // 3. 主动拉取首屏数据
         fetchInitialAudienceList()
     }
@@ -110,7 +70,7 @@ class AudienceManager {
             }
         }
     }
-    
+
     // ... 后续代码
 }
 ```
@@ -140,9 +100,9 @@ extension AudienceManager {
             .receive(on: DispatchQueue.main)
             .sink { [weak self] event in
                 guard let self = self else { return }
-                
+
                 var currentList = self.audienceListPublisher.value
-                
+
                 switch event {
                 case .onAudienceJoined(let newAudience):
                     print("观众 \(newAudience.userName) 加入了直播间")
@@ -151,7 +111,7 @@ extension AudienceManager {
                         currentList.append(newAudience)
                         self.audienceListPublisher.send(currentList)
                     }
-                    
+
                 case .onAudienceLeft(let departedAudience):
                     print("观众 \(departedAudience.userName) 离开了直播间")
                     // 增量更新：从当前列表中移除离开的观众
@@ -223,7 +183,7 @@ extension AudienceManager {
 我们通过订阅 `LiveAudienceStore` 的观众加入事件（`LiveAudienceEvent.onAudienceJoined`）来获取新观众加入的实时通知。一旦事件触发，我们便提取出新观众的昵称信息，然后立即调用 `BarrageStore` 的本地插入接口 `appendLocalTip`。
 ``` swift
 import Foundation
-import AtomicXCore 
+import AtomicXCore
 import Combine
 
 class LiveRoomManager {
@@ -260,7 +220,7 @@ class LiveRoomManager {
 
                 // 5. 创建一条本地提示消息
                 var welcomeTip = Barrage()
-                welcomeTip.messageType = .text 
+                welcomeTip.messageType = .text
                 welcomeTip.textContent = "欢迎 \(newAudience.userName) 进入直播间！"
 
                 // 6. 调用 BarrageStore 的接口将其插入弹幕列表
@@ -274,40 +234,11 @@ class LiveRoomManager {
 ## API 文档
 
 关于 [LiveAudienceStore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore) 及其相关类的所有公开接口、属性和方法的详细信息，请参阅随 [AtomicXCore](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore) 框架的官方 API 文档。本文档使用到的相关 Store 如下：
-<table>
-<tr>
-<td rowspan="1" colSpan="1" >Store/Component</td>
-
-<td rowspan="1" colSpan="1" >功能描述</td>
-
-<td rowspan="1" colSpan="1" >API 文档</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveCoreView</td>
-
-<td rowspan="1" colSpan="1" >直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >LiveAudienceStore</td>
-
-<td rowspan="1" colSpan="1" >观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore)</td>
-</tr>
-
-<tr>
-<td rowspan="1" colSpan="1" >BarrageStore</td>
-
-<td rowspan="1" colSpan="1" >弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。</td>
-
-<td rowspan="1" colSpan="1" >[API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore)</td>
-</tr>
-</table>
-
+| Store/Component | 功能描述 | API 文档 |
+| --- | --- | --- |
+| LiveCoreView | 直播视频流展示与交互的核心视图组件：负责视频流渲染和视图挂件处理，支持主播直播、观众连麦、主播连线等场景。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/livecoreview) |
+| LiveAudienceStore | 观众管理：获取实时观众列表（ID / 名称 / 头像），统计观众数量，监听观众进出事件。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/liveaudiencestore) |
+| BarrageStore | 弹幕功能：发送文本 / 自定义弹幕，维护弹幕列表，实时监听弹幕状态。 | [API 文档](https://tencent-rtc.github.io/TUIKit_iOS/documentation/atomicxcore/barragestore) |
 
 ## 常见问题
 
@@ -326,10 +257,6 @@ class LiveRoomManager {
 
   - **关键点：**在“弹幕风暴”或礼物刷屏等消息流量极高的场景下，如果房间内的消息速率超过了 40条/秒 的阈值，为了保证核心消息（例如弹幕）的送达，**人数变更的消息可能会被频控策略丢弃**。
 
-
       **这对开发者意味着什么？**
 
-
       `audienceCount` 是一个非常接近实时的**高精度估算值**，但在极端高并发场景下，它可能存在短暂的延迟或数据丢失。因此，我们建议您将其用于 **UI 展示**，而不应作为计费、统计等需要绝对精准场景的唯一依据。
-
-