即时通信 IM 观众观看(Flutter)(观众观看)

TUILiveKit 语聊房为纯音频直播场景提供了开箱即用的全功能界面。它支持快速搭建观众观看、上麦互动所需的核心能力,让你无需关注复杂的 UI 与麦位管理逻辑。

相关产品
即时通信 IM 产品页,含版本规格、价格与购买入口。

注意:集成提示:

注意:这篇档介绍基于 UI 组件 的观众进房方式(含完整交互 UI)。若你需通过 Core SDK 自行搭建观众端界面,请参考 观众观看 (Core SDK)。

一、功能概览

·收听直播: 清晰、流畅地收听主播的实时音频直播。

·上麦互动: 申请上麦,与主播进行音频连麦互动。

·直播间信息: 查看直播间公告,及在线观众列表等信息。

·观众互动: 支持弹幕、礼物、点赞等丰富的直播互动形式。

收听直播 上麦互动 直播间信息 观众互动
   

二、步骤1:开通服务

参考 开通服务 文档开通体验版或大规模直播版套餐。

三、步骤2:代码集成

参考 准备工作 接入 TUILiveKit。

四、步骤3:添加观众观看页面

TUIVoiceRoomOverlay 已内置了语聊房场景的观众端完整 UI 与业务逻辑,支持浮窗模式。在观看直播期间,可以切换到应用内浮窗模式。TUIVoiceRoomOverlay 是基于 Flutter API Overlay 实现的,具体接入流程如下:

import 'package:tencent_live_uikit/tencent_live_uikit.dart';// 跳转到观看页面Navigator.push(context, MaterialPageRoute( builder: (BuildContext context) { final roomId = "test_voice_room_id"; return TUIVoiceRoomOverlay(roomId: roomId, behavior: RoomBehavior.join);}));

注意:说明:

集成后,调用代码即可拉起观众页面并开始播放直播内容,效果如 功能概览 的收听直播图所示。

五、TUIVoiceRoomWidget 参数说明

参数名  类型 描述
roomId  String 全局唯一的直播间 ID。
behavior  RoomBehavior 进房行为:autoCreate:自动创建直播间并进房。prepareCreate:先进入开播前预览页,用户点击开始直播后创建直播间并进房。join:观众进房。
params  RoomParams 主播开播参数,详见下一节。观众进房(behavior 为 join)时无需配置此参数。

RoomParams 参数说明

参数名 类型 描述
maxSeatCount int 直播间最大麦位数。
seatMode TUISeatMode 观众的上麦模式:applyToTake:观众需要申请,主播同意后上麦freeToTake:观众自由上麦,无需主播同意。

六、浮窗模式效果

点击观看页面右上角的浮窗按钮,进入浮窗模式,效果如下:

七、文案定制

TUILiveKit 使用 ARB 文件和 Flutter 标准国际化方案来管理 UI 文案显示。你可以直接编辑 livekit/lib/common/language/i10n/ 目录下的 ARB 文件来修改需要调整的文案:

·livekit_en.arb:英文文案。

·livekit_zh.arb:简体中文文案。

·livekit_zh_Hant.arb:繁体中文文案。

修改后通过命令行执行 flutter gen-l10n 重新生成本地化代码即可。生成成功后,livekit/lib/common/language/gen/ 目录里的代码文件将会刷新。

八、图标定制

TUILiveKit UI 所需的图片资源在 livekit/assets/images/ 目录下管理,你可以直接替换该目录下的 PNG 图片文件来快速修改自定义界面所需的图标。

重新构建并运行应用,即可看到更新的图标。

九、下一步

恭喜你,现在你已经成功集成了观众观看功能。接下来,你可以实现主播开播、直播列表和礼物系统等功能,可参考下表:

功能 描述 集成指引
主播开播 主播开播全流程功能,包括开播前的准备和开播后的各种互动 主播开播
直播列表 展示直播列表界面和功能,包含直播列表,房间信息展示功能 直播列表
礼物系统 实现自定义礼物素材配置、计费系统对接、PK 场景互动等功能 礼物系统

十、观众发送弹幕时,直播间内其他观众看不到弹幕内容?

·原因 1: 先检查网络连接,确保观众设备网络正常。

·原因 2: 该观众被主播禁言,无法发送弹幕。

·原因 3:观众的弹幕内容涉及到关键词屏蔽,请确认观众发送的弹幕内容是否符合直播间规则。

赞 (0)
上一篇 4天前
下一篇 4天前