AtomicXCore 概览
最后更新时间：2025-12-17 10:03:47
AtomicXCore 概览
最后更新时间： 2025-12-17 10:03:47
AtomicXCore 是面向直播、会议、语聊、通话等场景的 SDK，是一种"无 UI"集成方案。您只需专注于 UI 界面开发，即可快速构建功能完备、完全可自定义的实时互动应用。
适用场景
AtomicXCore 封装了构建多种复杂场景所需的全部业务逻辑，让您完全专注于自定义 UI 界面开发。
视频直播
应用场景
社交娱乐 | 游戏互动 | 电商购物 |
 |  |  |
核心功能
高清直播：提供稳定、高清的直播推流与拉流能力。
观众上麦连线：支持观众与主播进行音视频连麦互动。
跨房连线 / PK：支持主播与主播之间进行跨直播间连麦 PK。
聊天弹幕：实现观众与主播实时发送和接收公屏弹幕消息。
礼物与点赞互动：提供发送礼物、全屏礼物动画及点赞的能力。
快速接入
语聊房
应用场景
多人聊天 | K歌 | 跨房连线 |
 |  |  |
核心功能
高音质语音聊天：提供回声消除 (AEC)、AI 降噪等专业音效处理。
麦位管理：支持房主对麦位进行锁定、禁麦、以及观众申请上麦、主播邀请观众上麦。
跨房连线：支持房主与房主之间进行跨房间连麦互动。
聊天弹幕：实现观众与主播实时发送和接收公屏弹幕消息。
礼物与点赞互动：提供发送礼物、全屏礼物动画及点赞的能力。
快速接入
AtomicXCore 核心概念
概念 | 定义 | 示例 |
Store(状态管理器) | Store是AtomicXCore场景化业务模块（例如通话、直播、弹幕）的逻辑与状态管理者。 | • CallListStore: 通话管理器 • LiveListStore: 直播列表管理器 • BarrageStore: 弹幕管理器 |
State(状态数据) | Store 中存储的数据快照，通常是一个 struct，UI 通过订阅 State 的变化来刷新。 | • CallParticipantState: 通话参与者状态 • LiveSeatState: 直播间麦位状态 |
Action(业务方法) | Store 对外提供的业务操作方法，调用 Action 是改变 State 的唯一途径。 | • likeStore.sendLike(): 直播点赞• barrageStore.sendTextMessage(): 发送弹幕• coGuestStore.applyForSeat(): 申请连线 |
Event(事件通知) | Store 发布的一次性回调通知，用于处理异步事件，通常用于触发 UI 动画或提示。 | • GiftEvent.onReceiveGift: 收到礼物事件 • GuestEvent.onHostInvitationReceived: 收到主播上麦邀请事件 |
AtomicXCore 工作原理
AtomicXCore 将每一项业务功能都抽象为一个
Store（状态管理器），您只需掌握以下核心步骤：
1. 获取 Store (状态管理器)
Store 是特定业务模块（例如弹幕、礼物、通话）的逻辑与状态的唯一管理者，所有的操作都应通过 Store 进行。2. 监听 State (状态)
State 是 Store 某个时刻的数据快照，您的 UI 应该只监听 State 的变化并刷新，不要手动修改 State。3. 调用 Action (方法)
Action (方法) 是唯一可以改变 State 的途径。当用户执行操作（例如点击点赞按钮）时，应该调用 Store 提供的 Action 方法。Store 在接收到 Action 后，会在内部处理业务逻辑（可能涉及网络请求），并在成功后自动更新其 State。上一步的 State 订阅者会自动收到通知并刷新 UI。4. 监听 Event (事件)
Event (事件) 与 State 不同。State 是“当前是什么”（例如点赞总数），而 Event 是“刚刚发生了什么”（例如“收到了一个礼物”）。Event 通常用于触发一次性 UI 效果，例如播放动画、弹出提示等。文档反馈