即时通信 IM TUILiveKit 搭建直播间

一、接入方式选择

TUILiveKit 提供多种接入方式，以满足你不同程度的定制需求，具体如下：

二、直播间各功能开发指引

本章将提供直播间常见功能的开发指引，帮助你更快地找到对应功能的说明文档。

·基础使用：开播及观看。

·直播互动：弹幕消息、送礼点赞、单房间连麦、跨房连线 / PK。

·成员管理：用户等级/身份、禁言与封禁/踢人、在线观众列表、在线人数。

·直播间管理：直播间列表、直播间审核、直播管理系统、直播间公告、直播统计。

·场景指引：电商场景、直播间弹幕抽奖、红包秒杀/福袋。

三、开播及观看

四、弹幕消息

TUILiveKit 内默认支持弹幕消息的发送与展示，不同接入方式的开发指引见：

TUILiveKit 预置的弹幕消息 UI 展示如下：

六、送礼点赞

TUILiveKit 内提供全链路的送礼解决方案，不同接入方式的开发指引见：

注意：说明：

注意：仅 TUILiveKit 体验版及大规模直播版支持送礼点赞功能，详细参见 功能与计费说明。

TUILiveKit 提供常见的礼物相关能力和 UI 效果如下：

七、单房间连麦

TUILiveKit 预置单房间连麦功能，根据接入方式的不同，功能的灵活度有所不同，详细参见下表：

注意：说明：

注意：仅 TUILiveKit 多人连麦版及大规模直播版支持单房间连麦，详细参见 功能与计费说明。

八、跨房连线/PK

TUILiveKit 预置跨房连线/ PK 功能，根据接入方式的不同，功能的灵活度有所不同，详细参见下表：

注意：说明：

注意：仅 TUILiveKit 多人连麦版及大规模直播版支持跨房连线/PK，详细参见 功能与计费说明。

九、用户等级/身份标识

用户等级与身份标识功能是直播互动场景中的重要组成部分，用于区分不同用户角色、特权等级和身份状态，从而实现差异化的界面展示、交互权限和功能访问控制。TUILiveKit 默认不提供基础的身份标识框架，但你可以参见以下方式进行实现：

十、实现用户等级/身份

在你的业务后台，根据你需要的用户等级/身份相关逻辑，自行维护并存储与每个用户 UserID 相对应的等级/身份。

十一、展示用户等级/身份

在实现 弹幕消息 时，发送消息接口选择 sendMessage 接口，其中 message.data 设置为你从你的业务后台获取到的需要展示的等级/身份信息。使用 onRecvNewMessage 收到消息时，解析 data 为你的等级/身份信息，之后自行在弹幕上进行渲染。具体收发消息代码展示如下：

JavaSwift// 发送消息V2TIMMessage v2TIMMessage = V2TIMManager.getMessageManager().createTextMessage("text");String jsonString = "{\\"level\\":\\"25\\",\\"identity\\":\\"normal\\"}"; // 在这里写入从你业务后台获取到的等级/身份信息v2TIMMessage.setCloudCustomData(jsonString);V2TIMManager.getMessageManager().sendMessage(v2TIMMessage, null, roomId, V2TIMMessage.V2TIM_PRIORITY_LOW, true, null, new V2TIMSendCallback<V2TIMMessage>() { // …});// 接收消息AdvancedMsgListener listener = new AdvancedMsgListener();V2TIMManager.getMessageManager().addAdvancedMsgListener(listener);private class AdvancedMsgListener extends V2TIMAdvancedMsgListener { @Override public void onRecvNewMessage(V2TIMMessage msg) { Gson gson = new Gson(); Type type = new TypeToken<HashMap<String, Object>>() {}.getType(); // 在这里解析自定义数据后渲染到弹幕上 HashMap<String, Object> customData = gson.fromJson(msg.getCloudCustomData(), type); }}import ImSDK_Plus// 发送消息let v2TimMessage = imManager.createTextMessage(text: "text")let jsonString = "{\\"level\\":\\"25\\",\\"identity\\":\\"normal\\"}" // 在这里写入从你业务后台获取到的等级/身份信息let data = jsonString.data(using: .utf8)v2TimMessage?.cloudCustomData = dataV2TIMManager.sharedInstance().sendMessage(message: v2TimMessage, receiver: nil, groupID: roomId, priority: .PRIORITY_LOW, onlineUserOnly: true, offlinePushInfo: nil, progress: nil) {} fail: { code, message in}// 接收消息V2TIMManager.sharedInstance().addAdvancedMsgListener(listener: self)extension YourClass: V2TIMAdvancedMsgListener { func onRecvNewMessage(msg: V2TIMMessage) { if let jsonObject = try? JSONSerialization.jsonObject(with: msg.cloudCustomData ?? Data(), options: []), let dict = jsonObject as? [String: Any] { // 在这里解析自定义数据后渲染到弹幕上 } }}

十二、直播间禁言与封禁/踢人

出于管理要求，部分直播间会需要将指定成员禁言或踢出直播间。

TUILiveKit 预置直播间禁言与封禁/踢人，根据接入方式的不同，功能的灵活度有所不同，详细参见下表：

十三、在线观众列表

TUILiveKit 预置在线观众列表功能，可用于展示直播间实时人数及直播间中的在线观众列表。根据接入方式的不同，功能的灵活度有所不同，详细参见下表：

十四、在线人数

TUILiveKit 预置展示直播间实时在线人数功能。根据接入方式的不同，功能的灵活度有所不同，详细参见下表：

十五、直播间列表

TUILiveKit 预置直播间列表功能，可用于展示所有直播间。

根据接入方式的不同，功能的灵活度有所不同，详细参见下表：

TUILiveKit 预置的直播间列表效果如下：

注意：说明：

注意：仅 TUILiveKit 大规模直播版支持直播列表中的直播预览及瀑布流能力，详细参见 功能与计费说明。

十六、直播间审核

在直播场景中，用户很可能会发送不合适的内容，特别是与敏感事件/人物相关、黄色不良内容等令人反感的内容，不仅严重损害了用户们的身心健康，更很有可能违法并导致业务被监管部门查封。目前 TUILiveKit 可通过云端审核服务实现敏感内容过滤，可针对不安全、不适宜的内容进行自动识别、处理，为你的产品体验和业务安全保驾护航。

使用 TUILiveKit 时可直接参见 直播审核（TUILiveKit）实现对直播音视频流、弹幕和用户信息的审核。

十七、直播管理系统

为方便你实时管理和监控你的直播间，TUILiveKit 提供了直播管理系统，提供直播监控、直播间管理、礼物配置、直播间控制台等完整的直播运营管理能力。

具体可参见 直播管理系统（Vue）和 直播管理系统（React）。

十八、直播间公告

直播间公告是每个直播间必备的内容，用户进入直播间可以看到该直播间的基本信息。同时，直播间公告也需要更改后实时通知给直播间的成员。

Live 房间信息支持 Notice 字段作为房间公告，设置或更新后会通过通知房间内用户。

十九、直播统计

TUILiveKit 支持直播统计功能， 包含 累计观看次数、点赞总数、送礼总数、送礼总个数、送礼总金额 等字段，你可以参见以下方式进行接入。

20、电商场景

商品管理模块是电商直播场景特有的，一般包含商品列表管理、商品弹窗管理、商品链接跳转与支付等。TUILiveKit 不直接提供商品管理功能，以下是商品管理的基础流程和使用建议：

21、商品列表/购物车

商品列表管理是商品管理的基础功能，主要包括商品的添加、删除、修改和查询等功能。通常会在后台数据库中存储商品的各种信息，例如商品名称、描述、价格、库存、图片等。在前端，你可以通过你的 API 接口获取这些信息，并以列表的形式展示给用户。

22、商品弹窗管理

在直播带货过程中，伴随着主播对商品的讲解与上架，通常需要在观众端弹出对应的商品信息，以便提示观众浏览和购买。商品信息弹窗可以通过向直播间内发送 IM 自定义消息 的方式实现，直播间观众收到自定义消息后进行解析和展示。你也可以通过你的业务侧自行实现自定义消息的收发。

如你需要在 UI 上展示商品弹窗，可参考以下方法：

23、商品跳转与支付

直播间内的观众完成商品挑选后，需要通过点击商品链接，跳转到具体的电商店铺进行订单的确认及支付。这里的电商店铺可以是平台内店铺，或是集成的第三方平台店铺。待用户支付完成后，还需要获取支付结果，以便更新商品的销售状态和库存信息等。

注意：说明：

注意：上述商品管理模块仅供参考，实际应用中你需要结合业务需求自行设计并部署

24、直播间弹幕抽奖

直播间弹幕抽奖是指用户发送特定内容的 弹幕消息 参与直播间抽奖。实现思路为业务后台群内发言消息后回调请求获取弹幕消息内容，符合特定内容的消息发送者将加入奖池，否则不做处理。回调使用见 群内发言之后回调。

25、红包秒杀/福袋

红包秒杀和福袋是电商直播中常见的营销互动功能，能有效提升用户参与度和购买转化率。TUILiveKit 不直接提供此功能，但你可基于其 IM 通信能力，结合你的业务后台来实现。

26、活动创建与通知

主播端向业务后台请求创建红包/福袋活动。业务后台创建活动成功后，通过 REST API 向直播间发送一条通知，通知所有观众活动开始。

27、用户参与逻辑

观众端收到活动通知后，展示参与入口。用户点击后，向你的业务后台发起参与请求。业务后台负责验证用户资格、记录参与信息，并可以实时更新参与人数。

28、抽奖与结果公布

到达预设的开奖时间，业务后台执行抽奖逻辑。抽奖完成后，业务后台再次通过 REST API 将中奖结果广播到直播间。

29、奖励发放

业务后台根据中奖结果，向用户的账户发放相应的奖励（例如优惠券、积分、余额等）。这一步通常与你的账户或营销系统对接。

30、关键技术点

·自定义消息：整个功能的核心是定义和收发不同类型的自定义消息，用于同步活动状态（例如“活动开始”、“结果公布”）。客户端需要根据消息类型来展示不同的 UI 效果。

·业务后台：所有活动管理、用户参与、抽奖和发奖的逻辑都由你的业务后台处理，确保流程的安全和可靠。

注意：说明：

注意：上述红包/福袋模块仅供参考，实际应用中你需要结合业务需求自行设计并部署。