소식 및 공지 사항

제품 업데이트

Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가

TRTC 월간 구독 패키지 출시 관련 안내

제품 소개

제품 개요

기본 개념

제품 기능

제품 장점

응용 시나리오

성능 데이터

구매 가이드

Billing Overview

무료 시간 안내

Monthly subscription

Pay-as-you-go

TRTC Overdue and Suspension Policy

과금 FAQ

Refund Instructions

신규 사용자 가이드

Demo 체험

Call

개요(TUICallKit)

Activate the Service

Run Demo

빠른 통합(TUICallKit)

오프라인 푸시

Conversational Chat

온클라우드 녹화(TUICallKit)

AI Noise Reduction

UI 사용자 정의

Calls integration to Chat

Additional Features

No UI Integration

Server APIs

Client APIs

Solution

ErrorCode

릴리스 노트

FAQs

라이브 스트리밍

Billing of Video Live Component

Overview

Activating the Service (TUILiveKit)

Demo 실행

No UI Integration

UI Customization

Live Broadcast Monitoring

Video Live Streaming

Voice Chat Room

Advanced Features

Client APIs

Server APIs

Error Codes

Release Notes

FAQs

RTC Engine

Activate Service

SDK 다운로드

API 코드 예시

Usage Guidelines

API 클라이언트 API

고급 기능

RTC RESTFUL API

History

Introduction

API Category

Room Management APIs

Stream mixing and relay APIs

On-cloud recording APIs

Data Monitoring APIs

Pull stream Relay Related interface

Web Record APIs

AI Service APIs

Cloud Slicing APIs

Cloud Moderation APIs

Making API Requests

Call Quality Monitoring APIs

Usage Statistics APIs

Data Types

Appendix

Error Codes

콘솔 가이드

애플리케이션 관리

사용량 통계

모니터링 대시보드

개발 보조

Solution

Real-Time Chorus

FAQs

과금 개요

기능 관련

UserSig 관련

방화벽 제한 처리

설치 패키지 용량 축소 관련 질문

Andriod 및 iOS 관련

Web 관련

Flutter 관련

Electron 관련

TRTCCalling Web 관련

멀티미디어 품질 관련

기타 질문

Protocols and Policies

컴플라이언스 인증

보안 백서

정보 보안에 관한 참고 사항

Service Level Agreement

Apple Privacy Policy: PrivacyInfo.xcprivacy

TRTC 정책

개인 정보 보호 정책

데이터 처리 및 보안 계약

용어집

BarrageStore

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2026-03-05 17:06:12

Introduction
BarrageStore provides a complete set of barrage management APIs, including sending text barrages, sending custom barrages, and adding local tip messages.
Through this class, you can implement barrage interaction functionality in live rooms.
Important: 
Use the create(liveID:) factory method to create a BarrageStore instance, which requires a valid live room ID.
Note: 
Barrage state updates are delivered through the state publisher. Subscribe to it to receive real-time updates of barrage data in the room.
Features
Text Barrage：Supports sending plain text barrage messages
Custom Barrage：Supports sending custom format barrages (such as barrages with special effects)
Local Tips：Supports adding tip messages visible only locally
Subscribable Data
BarrageState fields are described below:
Property
Type
Description
messageList
[Barrage]
Barrage message list of the current room, supports real-time updates and can be subscribed to.
API List
Function
Description
create
Create barrage management instance.
sendTextMessage
Send text barrage.
sendCustomMessage
Send custom barrage.
appendLocalTip
Add local tip message.
Creating Instance
create
Barrage management core class for handling barrage related business logic in live rooms/voice chat rooms.
public static func create(liveID: String) -> BarrageStore {
    let store: BarrageStoreImpl = StoreFactory.shared.getStore(liveId: liveID)
    return store
}
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
liveID
String
Required
Live room ID.
Sending Barrage
sendTextMessage
Send text type barrage.
public func sendTextMessage(text: String,
                            extensionInfo: [String: String]?,
                            completion: CompletionClosure?) {
    fatalError("\\(#function) must be overridden by subclass")
}
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
text
String
Required
Text barrage content.
extensionInfo
[String: String]?
Required
Extension information, can contain custom fields (such as specifying barrage color, font size, etc.).
completion
CompletionClosure?
Required
Completion callback (success/failure status).
sendCustomMessage
Send custom type barrage.
public func sendCustomMessage(businessID: String,
                              data: String,
                              completion: CompletionClosure?) {
    fatalError("\\(#function) must be overridden by subclass")
}
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
businessID
String
Required
Business identifier ID, used to distinguish custom barrages from different business scenarios.
data
String
Required
Custom data content, usually JSON format string, used to pass business custom data.
completion
CompletionClosure?
Required
Completion callback (success/failure status).
Local Messages
appendLocalTip
Add local tip message (add tip or operation feedback message locally, visible only to the current client).
public func appendLocalTip(message: Barrage) {
    fatalError("\\(#function) must be overridden by subclass")
}
Version
Supported since version 3.5.
Notes
Note: 
This message is only displayed locally and will not be sent to other users through the network.
Parameters
Parameter
Type
Required
Description
message
Barrage
Required
Local barrage message (such as system tips, operation feedback, etc., visible only to the current user).
Data Structures
BarrageType
Barrage type enumeration, used to distinguish different barrage message types.
Enum Value
Value
Description
text
0
Text type barrage, contains plain text content.
custom
1
Custom type barrage, supports business custom data format (such as barrages with special effects, interactive messages, etc.).
Barrage
Barrage data model, containing complete attribute information of a single barrage.
Property
Type
Description
liveID
String
Unique identifier ID of the live room/voice chat room the barrage belongs to.
sender
LiveUserInfo
User information of the barrage sender (such as user ID, nickname, avatar, etc.).
sequence
Int
Unique sequence ID of the barrage message, used for message sorting and deduplication.
timestampInSecond
TimeInterval
Barrage sending timestamp (unit: seconds), used to display sending time order.
messageType
BarrageType
Barrage message type (text or custom).
textContent
String
Message content of text type barrage, i.e., the text content of the barrage.
extensionInfo
[String: String]?
Barrage extension information, customizable fields (such as display style, priority, etc.). Valid when messageType is TEXT.
businessID
String
Business identifier ID of custom type barrage, used to distinguish custom barrages from different business scenarios.
data
String
Specific data content of custom type barrage (usually JSON format string), valid when messageType is CUSTOM.
BarrageState
Barrage state, managing the barrage data state of the current room.
Property
Type
Description
messageList
[Barrage]
Barrage message list of the current room, supports real-time updates and can be subscribed to.

도움말 및 지원

문제 해결에 도움이 되었나요?

더 자세한 내용은 문의하기 또는 티겟 제출 을 통해 문의할 수 있습니다.

피드백

tencent cloud

Tencent Real-Time Communication

BarrageStore

Introduction

Features

Subscribable Data

API List

Creating Instance

create

Sending Barrage

sendTextMessage

sendCustomMessage

Local Messages

appendLocalTip

Data Structures

BarrageType

Barrage

BarrageState

도움말 및 지원

Property	Type	Description
messageList	[Barrage]	Barrage message list of the current room, supports real-time updates and can be subscribed to.

Function	Description
create	Create barrage management instance.
sendTextMessage	Send text barrage.
sendCustomMessage	Send custom barrage.
appendLocalTip	Add local tip message.

Parameter	Type	Required	Description
liveID	String	Required	Live room ID.

Enum Value	Value	Description
text	0	Text type barrage, contains plain text content.
custom	1	Custom type barrage, supports business custom data format (such as barrages with special effects, interactive messages, etc.).