动态与公告

产品动态

产品近期公告

关于 TRTC Live 正式上线的公告

关于TRTC Conference 正式版上线的公告

Conference 商业化版本即将推出

关于多人音视频 Conference 开启内测公告

关于音视频通话 Call 正式版上线的公告

关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告

关于 TRTC 应用订阅套餐服务上线的相关说明

产品简介

产品概述

基本概念

产品功能

产品优势

应用场景

性能数据

购买指南

计费概述

免费时长说明

月订阅

现收现付

TRTC 逾期与暂停政策

常见问题解答

退款说明

新手指引

Demo 体验

视频通话 SDK

组件介绍

开通服务

跑通 Demo

快速接入

离线唤醒

会话聊天

云端录制

AI 降噪

界面定制

Chat 集成通话能力

更多特性

无 UI 集成

服务端 API

客户端 API

解决方案

错误码表

发布日志

常见问题

视频会议 SDK

组件介绍（TUIRoomKit）

开通服务（TUIRoomKit）

跑通 Demo（TUIRoomKit）

快速接入（TUIRoomKit）

屏幕共享（TUIRoomKit）

预定会议（TUIRoomKit）

会中呼叫（TUIRoomKit）

界面定制（TUIRoomKit）

虚拟背景（TUIRoomKit）

会议控制（TUIRoomKit）

云端录制（TUIRoomKit）

AI 降噪（TUIRoomKit）

会中聊天（TUIRoomKit）

机器人推流（TUIRoomKit）

更多特性（TUIRoomKit）

客户端 API（TUIRoomKit）

服务端 API（TUIRoomKit）

常见问题（TUIRoomKit）

错误码 (TUIRoomKit)

SDK更新日志（TUIRoomKit）

直播与语聊 SDK

Live 视频直播计费说明

组件介绍

开通服务（TUILiveKit）

跑通 Demo

无 UI 集成

UI 自定义

直播监播

视频直播

语聊房

高级功能

客户端 API

服务端 API

错误码

发布日志

常见问题

RTC Engine

开通服务

SDK 下载

API-Example

接入指引

API-参考手册

高级功能

AI 集成

概述

MCP 配置

Skills 配置

集成指南

常见问题

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

控制台指南

应用管理

套餐包管理

用量统计

监控仪表盘

开发辅助

解决方案

实时合唱

常见问题

迁移指南

计费相关

功能相关

UserSig 相关

应对防火墙限制相关

缩减安装包体积相关

Andriod 与 iOS 相关

Web 端相关

Flutter 相关

Electron 相关

TRTCCalling Web 相关

音视频质量相关

其他问题

旧版文档

RTC RoomEngine SDK（旧）

集成 TUIRoom (Web)

集成 TUIRoom (Android)

集成 TUIRoom (iOS)

集成 TUIRoom (Flutter)

集成 TUIRoom (Electron)

TUIRoom API 查询

实现云端录制与回放（旧）

监控仪表盘计费（旧）

协议与策略

安全合规认证

安全白皮书

信息安全说明

服务等级协议

苹果隐私策略：PrivacyInfo.xcprivacy

TRTC 政策

隐私协议

数据处理和安全协议

词汇表

TUILiveGiftManager

PDF

聚焦模式

字号

最后更新时间： 2025-07-18 14:51:19

Copyright (c) 2025 Tencent. All rights reserved.
Module:   TUILiveGiftManager @ TUIKitEngine
Function: 直播 礼物 相关接口
﻿
TUILiveGiftManager
TUILiveGiftObserver
函数列表
描述
onGiftCountChanged:totalGiftsSent:totalGiftCoins:totalUniqueGiftSenders:
收到礼物数量变化的通知
onReceiveGiftMessage:giftInfo:giftCount:sender:
收到礼物消息的通知
onReceiveLikesMessage:totalLikesReceived:sender:
收到点赞消息的通知
TUILiveGiftManager
函数列表
描述
addObserver:
添加事件回调
removeObserver:
移除事件回调
getGiftList:onSuccess:onError:
请求获取礼物列表。
sendGift:giftId:count:onSuccess:onError:
发送礼物
sendLike:count:onSuccess:onError:
发送点赞
getGiftCountByAnchor:onSuccess:onError:
房主获取礼物数量
getLikesCount:onSuccess:onError:
获取点赞数量
结构体类型
函数列表
描述
TUIGiftInfo
Gift 礼物信息
TUIGiftCategory
Gift 分类信息
onGiftCountChanged:totalGiftsSent:totalGiftCoins:totalUniqueGiftSenders:
onGiftCountChanged:totalGiftsSent:totalGiftCoins:totalUniqueGiftSenders:
- (void)onGiftCountChanged:
(NSString *)roomId
totalGiftsSent:
(NSUInteger)totalGiftsSent
totalGiftCoins:
(NSUInteger)totalGiftCoins
totalUniqueGiftSenders:
(NSUInteger)totalUniqueGiftSenders
收到礼物数量变化的通知参数
描述
roomId
直播间ID
totalGiftCoins
礼物价值
totalGiftsSent
礼物数量
totalUniqueGiftSenders
礼物发送者数量
onReceiveGiftMessage:giftInfo:giftCount:sender:
onReceiveGiftMessage:giftInfo:giftCount:sender:
- (void)onReceiveGiftMessage:
(NSString *)roomId
giftInfo:
(﻿TUIGiftInfo﻿ *)giftInfo
giftCount:
(NSUInteger)giftCount
sender:
(﻿TUIUserInfo﻿ *)sender
收到礼物消息的通知参数
描述
giftCount
礼物数量
giftInfo
礼物信息
roomId
直播间ID
sender
礼物发送者信息
onReceiveLikesMessage:totalLikesReceived:sender:
onReceiveLikesMessage:totalLikesReceived:sender:
- (void)onReceiveLikesMessage:
(NSString *)roomId
totalLikesReceived:
(NSUInteger)totalLikesReceived
sender:
(﻿TUIUserInfo﻿ *)sender
收到点赞消息的通知参数
描述
roomId
直播间ID
sender
点赞发送者信息
totalLikesReceived
点赞数量
addObserver:
addObserver:
- (void)addObserver:
(id<﻿TUILiveGiftObserver﻿>)observer
添加事件回调参数
描述
observer
监听的实例。
removeObserver:
removeObserver:
- (void)removeObserver:
(id<﻿TUILiveGiftObserver﻿>)observer
移除事件回调参数
描述
observer
监听的实例。
getGiftList:onSuccess:onError:
getGiftList:onSuccess:onError:
- (void)getGiftList:
(NSString *)roomId
onSuccess:
(TUIGetGiftListBlock)onSuccess
onError:
(TUIErrorBlock)onError
请求获取礼物列表。参数
描述
roomId
直播间ID
sendGift:giftId:count:onSuccess:onError:
sendGift:giftId:count:onSuccess:onError:
- (void)sendGift:
(NSString *)roomId
giftId:
(NSString *)giftId
count:
(NSUInteger)count
onSuccess:
(TUISuccessBlock)onSuccess
onError:
(TUIErrorBlock)onError
发送礼物参数
描述
count
礼物数量
giftId
礼物ID
roomId
直播间ID
sendLike:count:onSuccess:onError:
sendLike:count:onSuccess:onError:
- (void)sendLike:
(NSString *)roomId
count:
(NSUInteger)count
onSuccess:
(TUISuccessBlock)onSuccess
onError:
(TUIErrorBlock)onError
发送点赞参数
描述
count
点赞数量
roomId
直播间ID
getGiftCountByAnchor:onSuccess:onError:
getGiftCountByAnchor:onSuccess:onError:
- (void)getGiftCountByAnchor:
(NSString *)roomId
onSuccess:
(TUIGetGiftCountBlock)onSuccess
onError:
(TUIErrorBlock)onError
房主获取礼物数量参数
描述
roomId
直播间ID
getLikesCount:onSuccess:onError:
getLikesCount:onSuccess:onError:
- (void)getLikesCount:
(NSString *)roomId
onSuccess:
(TUIGetLikesCountBlock)onSuccess
onError:
(TUIErrorBlock)onError
获取点赞数量参数
描述
roomId
直播间ID
TUIGiftInfo
TUIGiftInfo
Gift 礼物信息枚举类型
描述
coins
Gift 礼物价格
desc
Gift 礼物描述
extensionInfo
Gift 礼物扩展自定义信息
giftId
Gift 礼物ID
iconUrl
Gift 礼物图标URL
level
Gift 礼物等级
name
Gift 礼物名称
resourceUrl
Gift 礼物资源URL
TUIGiftCategory
TUIGiftCategory
Gift 分类信息枚举类型
描述
categoryId
Gift 分类ID
desc
Gift 分类描述
extensionInfo
Gift 分类扩展自定义信息
giftList
Gift 分类礼物列表
name
Gift 分类名称

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

实时音视频

TUILiveGiftManager

TUILiveGiftObserver

TUILiveGiftManager

结构体类型

onGiftCountChanged:totalGiftsSent:totalGiftCoins:totalUniqueGiftSenders:

收到礼物数量变化的通知

onReceiveGiftMessage:giftInfo:giftCount:sender:

收到礼物消息的通知

onReceiveLikesMessage:totalLikesReceived:sender:

收到点赞消息的通知

addObserver:

添加事件回调

removeObserver:

移除事件回调

getGiftList:onSuccess:onError:

请求获取礼物列表。

sendGift:giftId:count:onSuccess:onError:

发送礼物

sendLike:count:onSuccess:onError:

发送点赞

getGiftCountByAnchor:onSuccess:onError:

房主获取礼物数量

getLikesCount:onSuccess:onError:

获取点赞数量

TUIGiftInfo

Gift 礼物信息

TUIGiftCategory

Gift 分类信息

帮助和支持

函数列表	描述
onGiftCountChanged:totalGiftsSent:totalGiftCoins:totalUniqueGiftSenders:	收到礼物数量变化的通知
onReceiveGiftMessage:giftInfo:giftCount:sender:	收到礼物消息的通知
onReceiveLikesMessage:totalLikesReceived:sender:	收到点赞消息的通知

- (void)onGiftCountChanged:	(NSString *)roomId
totalGiftsSent:	(NSUInteger)totalGiftsSent
totalGiftCoins:	(NSUInteger)totalGiftCoins
totalUniqueGiftSenders:	(NSUInteger)totalUniqueGiftSenders

参数	描述
roomId	直播间ID
totalGiftCoins	礼物价值
totalGiftsSent	礼物数量
totalUniqueGiftSenders	礼物发送者数量

- (void)onReceiveGiftMessage:	(NSString *)roomId
giftInfo:	(TUIGiftInfo *)giftInfo
giftCount:	(NSUInteger)giftCount
sender:	(TUIUserInfo *)sender

参数	描述
giftCount	礼物数量
giftInfo	礼物信息
roomId	直播间ID
sender	礼物发送者信息

- (void)onReceiveLikesMessage:	(NSString *)roomId
totalLikesReceived:	(NSUInteger)totalLikesReceived
sender:	(TUIUserInfo *)sender

- (void)getGiftList:	(NSString *)roomId
onSuccess:	(TUIGetGiftListBlock)onSuccess
onError:	(TUIErrorBlock)onError

- (void)sendGift:	(NSString *)roomId
giftId:	(NSString *)giftId
count:	(NSUInteger)count
onSuccess:	(TUISuccessBlock)onSuccess
onError:	(TUIErrorBlock)onError

参数	描述
count	礼物数量
giftId	礼物ID
roomId	直播间ID

- (void)sendLike:	(NSString *)roomId
count:	(NSUInteger)count
onSuccess:	(TUISuccessBlock)onSuccess
onError:	(TUIErrorBlock)onError

- (void)getGiftCountByAnchor:	(NSString *)roomId
onSuccess:	(TUIGetGiftCountBlock)onSuccess
onError:	(TUIErrorBlock)onError

- (void)getLikesCount:	(NSString *)roomId
onSuccess:	(TUIGetLikesCountBlock)onSuccess
onError:	(TUIErrorBlock)onError

枚举类型	描述
coins	Gift 礼物价格
desc	Gift 礼物描述
extensionInfo	Gift 礼物扩展自定义信息
giftId	Gift 礼物ID
iconUrl	Gift 礼物图标URL
level	Gift 礼物等级
name	Gift 礼物名称
resourceUrl	Gift 礼物资源URL

枚举类型	描述
categoryId	Gift 分类ID
desc	Gift 分类描述
extensionInfo	Gift 分类扩展自定义信息
giftList	Gift 分类礼物列表
name	Gift 分类名称