帮你快速理解、总结文档立即下载

LikeStore

最近更新时间:2026-10-23 14:57:32
本文档已由 AI 辅助审校
我的收藏

简介

LikeStore 提供了一套完整的点赞管理 API,包括发送点赞、监听点赞事件和获取点赞状态。通过该类,可以在直播间内实现点赞互动功能。
重要:
使用 create(liveID:) 工厂方法创建 LikeStore 实例,需要传入有效的直播间 ID。
说明:
点赞状态更新通过 state 发布者传递。订阅它以接收房间内点赞数据的实时更新。

功能特性

点赞发送:支持向当前房间发送点赞。
点赞状态:获取当前房间的累计点赞数。
事件监听:监听点赞接收事件。

可订阅数据

LikeState 的字段描述如下:
属性名
类型
描述
totalLikeCount
UInt
当前直播间/语音聊天房的累计总点赞数,支持实时更新并可被订阅监听。

API 列表

函数名
描述
创建点赞管理实例。
点赞事件发布者。
发送点赞。

创建实例

create

创建点赞管理实例。
public static func create(liveID: String) -> LikeStore {
let store: LikeStoreImpl = StoreFactory.shared.getStore(roomID: liveID)
return store
}
版本信息
从3.5版本开始支持。
参数说明
参数名
类型
描述
liveID
String
直播间 ID。

观察状态和事件

likeEventPublisher

点赞事件发布者。

点赞操作

sendLike

向当前房间发送点赞。所有订阅了点赞事件的用户都能收到此点赞通知。
public func sendLike(count: UInt = 1, completion: CompletionClosure?) {
fatalError("\\(#function) must be overridden by subclass")
}
版本信息
从3.5版本开始支持。
参数说明
参数名
类型
描述
count
UInt
点赞数量,默认为1。
completion
完成回调(成功/失败状态)。

数据结构

LikeState

点赞状态,用于展示和订阅直播间/语音聊天房的点赞信息。
属性
类型
说明
totalLikeCount
UInt
当前直播间/语音聊天房的累计总点赞数,支持实时更新并可被订阅监听。

LikeListener

点赞事件,用于接收直播间/语音聊天房内的点赞动态。
此监听器用于接收直播间/语音聊天房内的点赞动态。
方法
onReceiveLikesMessage: 收到新点赞消息的事件回调。当直播间/语音聊天房内有其他观众发送点赞时,会触发该事件并返回相关信息。
case onReceiveLikesMessage(liveID: String, totalLikesReceived: UInt, sender: LiveUserInfo)
参数名
类型
说明
liveID
String
直播间 ID。
totalLikesReceived
UInt
本次收到的新点赞数。
sender
点赞发送者信息。