文档中心>直播 SDK

集成指引

最近更新时间:2025-11-21 14:15:34

我的收藏
AtomicXCore 是一个面向直播、会议、语聊、通话等场景的场景化 SDK,为您提供“无 UI”集成方案,对 UI 开发提供了友好的支持。您只需专注于 UI 界面开发,即可高效地构建功能完备、可完全自定义的实时互动应用。

适用场景

AtomicXCore 提供了构建多种复杂场景所需的全部业务逻辑,您只需 100% 专注于自定义 UI 界面。

视频直播

应用场景
社交娱乐
游戏互动
电商购物









核心功能
高清直播:提供稳定、高清的直播推流与观看能力。
观众上麦连线:支持观众与主播进行音视频连麦互动。
跨房连线 / PK:支持主播与主播之间进行跨直播间连麦 PK。
聊天弹幕:实现观众与主播实时发送和接收公屏弹幕消息。
礼物与点赞互动:提供发送礼物、全屏礼物动画及点赞的能力。
快速接入
Android
iOS

语聊房

应用场景
多人聊天
K歌
跨房连线




核心功能
高音质语音聊天:提供回声消除 (AEC)、AI 降噪等专业音效处理。
麦位管理:支持房主对麦位进行锁定、禁麦、以及观众申请上麦、主播邀请观众上麦。
跨房连线:支持房主与房主之间进行跨房间连麦互动。
聊天弹幕:实现观众与主播实时发送和接收公屏弹幕消息。
礼物与点赞互动:提供发送礼物、全屏礼物动画及点赞的能力。

视频通话

应用场景
1v1 通话
远程医疗
在线客服









核心功能
1v1 与群组通话:提供 1v1 和多人的音视频通话能力。
通话中邀请与加入:支持在通话过程中邀请他人,或中途加入通话。
离线推送:App 未启动时,仍能收到音视频通话的推送通知。
AI 降噪:智能过滤背景噪声,在嘈杂环境中保持通话清晰。
虚拟背景:支持模糊背景或替换为图片背景,保护用户隐私。

在线会议

应用场景
音视频会议
企业协同
教育培训



核心功能
预定会议:支持预定会议、并将预定会议显示在会议列表,提供丰富日程功能。
会议控制:可以对所有成员进行管控,全体静音/禁视频、移出房间、转交主持人、邀请成员开启音视频参与发言等、仅房主/管理员可屏幕共享(全体禁止屏幕共享)。
云端录制:支持用户在视频会议、在线教育、直播互动等场景中进行录制,满足对重要内容进行存档、审核等多样化需求。
会中呼叫:用户在会议进行过程中,可以随时呼叫其他用户加入当前会议,无需提前预定或安排。
会前提醒:当您成功预定会议后,SDK将在会议开始前10分钟向参会成员推送会前提醒消息,您也可以自定义会前提醒时间。

AtomicXCore 核心概念

理解以下核心概念,将帮助您快速上手 AtomicXCore:
概念
定义
示例
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 (状态)

StateStore 某个时刻的数据快照。您的 UI 应该只监听 State 的变化并刷新,绝不应手动修改 State

3. 调用 Action (方法)

Action (方法) 是您唯一可以改变 State 的途径。当用户执行操作(例如点击点赞按钮)时,您应该调用 Store 提供的 Action 方法。Store 在接收到 Action 后,会在内部处理业务逻辑(可能涉及网络请求),并在成功后自动更新其 State。上一步的 State 订阅者会自动收到通知并刷新 UI。

4. 监听 Event (事件)

Event (事件) 与 State 不同。State 是“当前是什么”(例如点赞总数),而 Event 是“刚刚发生了什么”(例如“收到了一个礼物”)。
Event 通常用于触发一次性 UI 效果,例如播放动画、弹出提示等。

集成方案对比

如果 AtomicXCore 提供的标准业务 Store 无法满足您的特定需求,您可以参考以下对比,考虑更底层的 SDK:
对比维度
封装层次
业务逻辑层
房间管理层
音视频传输层
核心能力
封装直播、通话、语聊、会议的标准业务逻辑。
提供专业的房间管理、成员管理、麦位管理和权限控制。
提供基础的音视频采集、编码、传输和渲染能力。
需要自行实现
• UI 界面
• UI 界面
• 业务逻辑 (例如弹幕、礼物、点赞等)
• UI 界面
• 业务逻辑
• 房间管理
• 信令同步
推荐场景
需要完全自定义 UI,并希望快速上线标准直播、通话、语聊、会议等场景。
需要深度定制房间逻辑(例如自定义麦位逻辑),或自行实现特定业务。
已有完整业务框架(包含自定义房间管理和信令系统)的团队。
开发复杂度
低 (仅需实现 UI)
中 (需实现 UI 和业务逻辑)
高 (需实现 UI、业务、房间及信令)

TRTC SDK 快速接入

RoomEngine SDK 快速接入

Android
iOS