/TUIBarrage

腾讯云音视频弹幕组件

Primary LanguageObjective-CMIT LicenseMIT

本文档主要介绍如何运行TUIBarrage组件的,以及如何在别的工程中集成TUIBarrage组件

目录结构

TUIBarrage
├─ Example              // Example 模块,主要提供 TUIBarrage 的功能测试页面
├─ Source               // TUIBarrage 组件的代码逻辑封装
├─ Resources            // TUIBarrage 组件中用到的资源文件
└─ TUIBarrage.podspec   // TUIBarrage 组件 pod 接入文件

环境准备

  • iOS 13.0,Xcode 11.0 以上

运行示例

前提条件

您已 注册腾讯云 账号,并完成 实名认证

申请 SDKAPPID 和 SECRETKEY

  1. 登录实时音视频控制台,选择【开发辅助】>【快速跑通Demo】。
  2. 单击【立即开始】,输入您的应用名称,例如TestTRTC,单击【创建应用】。

3. 创建应用完成后,单击【我已下载,下一步】,可以查看 SDKAppID 和密钥信息。

开通移动直播服务

  1. 开通直播服务并绑定域名 如果还没开通,点击申请开通,之后在域名管理中配置推流域名和拉流域名
  2. 获取SDK的测试License
  3. 配置推拉流域名

配置工程文件

  1. 使用终端,cd 到 TUIBarrage/Example 路径,使用命令 "sh init.sh" 下载 SDK 及 Pod 更新
  2. 使用 Xcode(11.0及以上的版本)打开源码工程TUIBarrageApp.xcworkspace
  3. 找到并打开TUIBarrage/Debug/GenerateTestUserSig.swift文件。
  4. 设置GenerateTestUserSig.swift文件中的相关参数:
  • SDKAPPID:默认为 PLACEHOLDER ,请设置为实际的 SDKAppID;
  • SECRETKEY:默认为空字符串,请设置为实际的密钥信息;
  1. 修改 Bundle Id 为 License 信息所对应的包名

编译运行

用 Xcode 打开该项目,连上 iOS 设备,编译并运行。

集成TUIBarrage

如果需要将 TUIBarrage 组件集成到自己的项目中,可按如下步骤接入

工程配置

  1. TUIBarrage/ResourcesTUIBarrage/SourceTUIBarrage/TUIBarrage.podspec 模块导入到自己的工程中
  2. 在项目的 Podfile 文件中添加我们的 TUIBarrage 模块
   pod 'TUIBarrage', :path => "../"

TUIBarrageSendPlugView功能使用

  1. 创建 TUIBarrageSendPlugView
    TUIBarrageSendPlugView *plugView = [[TUIBarrageSendPlugView alloc]initWithFrame:frame groupId:groupId];;
  1. 添加 TUIBarrageSendPlugView
    [self.view addSubview:plugView];
  1. 使用 TUIBarrageView 相关功能

展示

    plugView.hidden = NO;

TUIBarrageDisplayView功能使用

  1. 创建 TUIBarrageDisplayView
    TUIBarrageDisplayView *displayView = [[TUIBarrageDisplayView alloc]initWithFrame:frame groupId:groupId];
    [TUIBarrageExtension setDisplayViewByGroupId:displayView groupId:groupId];
  1. 添加 TUIBarrageDisplayView
    [self.view addSubview:displayView];
  1. 使用 TUIBarrageDisplayView 相关功能

展示

    [displayView receiveBarrage:barrage];

我们在自己的小直播工程中也使用了该TUIBarrage组件,可以参考。

问题答疑

1、我们官网文档常见问题中整理了一些常见的问题,如果遇到相同的问题,可以参考上面的解决方案 2、可以加入我们的 TUIKIT 答疑群,在群里我们有专人进行答疑