tencent cloud

直播 SDK

动态与公告
TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
新手指引
产品简介
产品概述
产品优势
性能数据
基本概念
购买指南
TRTC Live 价格总览
Live 视频直播计费说明
开通服务(TUILiveKit)
Demo 体验
Demo 体验指引
跑通 Demo(TUILiveKit)
接入指南
视频直播
准备工作
主播开播
观众观看
直播列表
语聊房
准备工作
主播开播
观众观看
直播列表
推流助手
推流助手(Electron 桌面应用)
推流助手(Web 桌面浏览器)
直播监播
监播页面(Web 桌面浏览器 React 版)
监播页面(Web 桌面浏览器 Vue 版)
UI 自定义
直播视频组件
视频源编辑组件
观众列表组件
聊天弹幕组件
媒体源配置面板
连麦管理面板
直播送礼组件
无 UI 集成
搭建视频直播
搭建语聊房
功能指南
关注主播(TUILiveKit)
至臻画质(TUILiveKit)
输入媒体流进房(TUILiveKit)
礼物系统(TUILiveKit)
客户端 API
Android
iOS
Web
服务端 API(TUILiveKit)
账号系统
REST API
第三方回调
错误码(TUILiveKit)
常见问题
平台编译
用户鉴权
云直播推拉流 SDK
产品简介
购买指南
Demo 体验
免费测试
SDK 下载
License 管理
高级功能
客户端 API
常见问题
无 UI 集成方案
API 文档
OSS information
OSS Attribution Notice

礼物配置指引

PDF
聚焦模式
字号
最后更新时间: 2026-03-11 13:29:50

礼物系统简介

礼物相关信息由礼物、礼物分类、礼物与分类关系、语言信息四部分组成。四部分包含的信息如下:
礼物:包括了GiftId、礼物默认名称、礼物默认描述、礼物等级、礼物的虚拟货币价格、图标、自定义扩展信息。其中GiftId是礼物在系统中的唯一标识,是后续操作的对象。礼物的虚拟货币价格,用于礼物展示的“标价”,虚拟货币与实际支付金额对应关系需业务另外自行定义。
礼物分类:包括了 CategoryId、分类默认名称、分类默认描述、自定义扩展信息。与 GiftId 相同,CategoryId 为礼物分类在系统中的唯一标识,是后续操作的对象。

注意:
礼物分类信息并不包括礼物和分类的关系,仅包括礼物分类 Id、分类名称、分类描述以及扩展信息等,详细见添加礼物分类
礼物与分类关系:用于描述一个分类下有哪些礼物

语言信息:礼物与礼物分类的名称与描述支持国际化,语言信息用于记录不同语言下礼物描述的翻译。
注意:
在使用 SDK 获取礼物列表时,如礼物或礼物分类未设置指定语言的名称和描述,则返回设置礼物时默认的礼物名称和描述。

礼物系统配置流程

组件中的礼物功能需要对应应用(SDKAppID)为 TUILiveKit 体验版或大规模直播版 方可使用,开通后再有序的添加礼物相关信息,下面给出礼物配置顺序:
1. 添加礼物和礼物分类
首先添加礼物和礼物分类,添加后会得到若干 GiftId 和 CategoryId,利用这些 Id可以进行后续操作,添加方法见 添加礼物添加礼物分类
2. 添加礼物分类与礼物关系
利用上一步得到的 GiftId 与 CategoryId,设置对应关系,操作方法见 添加礼物分类关系
3. 添加礼物与礼物分类的语言信息
这一步不是必要步骤,如果有国际化的需求可进行设置,操作方法见 添加礼物语言信息添加礼物分类语言信息
配置顺序如下图所示:


帮助和支持

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

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

文档反馈