LiveListStore
Introduction
LiveListStore provides a complete set of live room management APIs, including creating live, joining live, leaving live, ending live and other functions.
Through this class, you can manage the lifecycle of live rooms.
Important:
Use the LiveListStore.shared singleton object to get the LiveListStore instance.
Note:
Live state updates are delivered through the liveState publisher. Subscribe to it to receive real-time updates of live data.
Features
Live List：Get and manage live room list
Live Creation：Create new live rooms
Live Joining：Join existing live rooms
Live Management：Update live info, end live and other operations
Event Listening：Listen for live ended, kicked out and other events
Subscribable Data
LiveListState fields are described below:
API List
Function | Description |
Singleton object. | |
Live list event callbacks. | |
Live list event callbacks. | |
Get live list. | |
Get live info. | |
Create live. | |
Join live. | |
Leave live. | |
End live. | |
Update live info. | |
Query metadata. | |
Update metadata. |
Getting Instance
LiveListStore.shared
Singleton object
Observing State and Events
addLiveListListener
Add live list event listener
abstract fun addLiveListListener(listener: LiveListListener)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
listener | Required | Listener. |
removeLiveListListener
Remove live list event listener
abstract fun removeLiveListListener(listener: LiveListListener)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
listener | Required | Listener. |
Live List
fetchLiveList
Get live list
abstract fun fetchLiveList(cursor: String?,count: Int,completion: CompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
cursor | String? | Required | Cursor. |
count | Int | Required | Count. |
completion | Required | Completion callback. |
fetchLiveInfo
Get live info
abstract fun fetchLiveInfo(liveID: String,completion: LiveInfoCompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
liveID | String | Required | Live room ID. |
completion | Required | Completion callback. |
Live Operations
createLive
Create live
abstract fun createLive(liveInfo: LiveInfo,completion: LiveInfoCompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
liveInfo | Required | Live info. | |
completion | Required | Completion callback. |
joinLive
Join live
abstract fun joinLive(liveID: String?,completion: LiveInfoCompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
liveID | String? | Required | Live ID. |
completion | Required | Completion callback. |
leaveLive
Leave live
abstract fun leaveLive(completion: CompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
completion | Required | Completion callback. |
endLive
End live
abstract fun endLive(completion: StopLiveCompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
completion | Required | Completion callback. |
updateLiveInfo
Update live info
abstract fun updateLiveInfo(liveInfo: LiveInfo,modifyFlagList: List<LiveInfo.ModifyFlag>,completion: CompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
liveInfo | Required | Live info. | |
modifyFlag | List<LiveInfo.ModifyFlag> | Required | Modify flag. |
completion | Required | Completion callback. |
Metadata Operations
queryMetaData
Query metadata
abstract fun queryMetaData(keys: List<String>,completion: MetaDataCompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
keys | List<String> | Required | Key list. |
completion | Required | Completion callback. |
updateLiveMetaData
Update live metadata
abstract fun updateLiveMetaData(metaData: HashMap<String, String>,completion: CompletionHandler?)
Version
Supported since version 3.5.
Parameters
Parameter | Type | Required | Description |
metaData | HashMap<String, String> | Required | Metadata. |
completion | Required | Completion callback. |
Data Structures
TakeSeatMode
Take seat mode.
Enum Value | Description |
FREE | Free to take seat. |
APPLY | Apply to take seat. |
SeatLayoutTemplate
Seat layout template for simplifying seat configuration when creating a live room.
Enum Value | Description |
VideoDynamicGrid9Seats | Portrait dynamic 9-grid layout for video live streaming. |
VideoDynamicFloat7Seats | Portrait dynamic 1v6 floating layout for video live streaming. |
VideoFixedGrid9Seats | Portrait static 9-grid layout for video live streaming. |
VideoFixedFloat7Seats | Portrait static 1v6 floating layout for video live streaming. |
VideoLandscape4Seats | Landscape 4-seat layout for video live streaming. |
Karaoke | Audio KTV layout for karaoke scenes with configurable seat count. |
AudioSalon | Audio salon layout for voice chat scenes with configurable seat count. |
LiveEndedReason
Live ended reason.
Enum Value | Description |
ENDED_BY_HOST | Ended by host. |
ENDED_BY_SERVER | Ended by server. |
LiveKickedOutReason
Kicked out of live room reason.
Enum Value | Description |
BY_ADMIN | Kicked out by admin. |
BY_LOGGED_ON_OTHER_DEVICE | Logged on other device. |
BY_SERVER | Kicked out by server. |
FOR_NETWORK_DISCONNECTED | Network disconnected. |
FOR_JOIN_ROOM_STATUS_INVALID_DURING_OFFLINE | Join room status invalid during offline. |
FOR_COUNT_OF_JOINED_ROOMS_EXCEED_LIMIT | Count of joined rooms exceed limit. |
LiveInfo
Live information
Property | Type | Description |
liveID | String | Live ID. |
liveName | String | Live name. |
notice | String | Live notice. |
isMessageDisable | Boolean | Whether message is disabled. |
isPublicVisible | Boolean | Whether publicly visible. |
isSeatEnabled | Boolean | Whether seat is enabled. |
keepOwnerOnSeat | Boolean | Whether to keep owner on seat. |
maxSeatCount | Int | Maximum seat count. |
seatMode | Take seat mode. | |
seatTemplate | Seat layout template for simplifying seat configuration. | |
seatLayoutTemplateID | Int | Seat layout template ID. |
coverURL | String | Cover URL. |
backgroundURL | String | Background URL. |
categoryList | List<Int> | Category list. |
activityStatus | Int | Activity status. |
liveOwner | Live owner info. | |
createTime | Long | Create time. |
totalViewerCount | Int | Total viewer count. |
isGiftEnabled | Boolean | Whether gift is enabled. |
metaData | Map<String, String> | Metadata. |
LiveListState
Live list state
LiveListListener
Live list events
Methods
onLiveEnded: Live ended event.
open fun onLiveEnded(liveID: String, reason: LiveEndedReason, message: String) {}
Parameter | Type | Description |
liveID | String | Live ID. |
reason | Ended reason. | |
message | String | Message. |
onKickedOutOfLive: Kicked out of live room event.
open fun onKickedOutOfLive(liveID: String, reason: LiveKickedOutReason, message: String) {}
Parameter | Type | Description |
liveID | String | Live ID. |
reason | Kicked out reason. | |
message | String | Message. |
LiveInfoCompletionHandler
Live info completion callback interface.
Methods
onSuccess: Success callback.
fun onSuccess(liveInfo: LiveInfo)
Parameter | Type | Description |
liveInfo | Live info. |
onFailure: Failure callback.
fun onFailure(code: Int, desc: String)
Parameter | Type | Description |
code | Int | Error code. |
desc | String | Error description. |
StopLiveCompletionHandler
Stop live completion callback interface.
Methods
onSuccess: Success callback.
fun onSuccess(statisticsData: TUILiveListManager.LiveStatisticsData)
Parameter | Type | Description |
statisticsData | TUILiveListManager.LiveStatisticsData | Live statistics data. |
onFailure: Failure callback.
fun onFailure(code: Int, desc: String)
Parameter | Type | Description |
code | Int | Error code. |
desc | String | Error description. |
MetaDataCompletionHandler
Metadata completion callback interface.
Methods
onSuccess: Success callback.
fun onSuccess(metaData: HashMap<String, String>)
Parameter | Type | Description |
metaData | HashMap<String, String> | Metadata. |
onFailure: Failure callback.
fun onFailure(code: Int, desc: String)
Parameter | Type | Description |
code | Int | Error code. |
desc | String | Error description. |
