准备工作(iOS)

最近更新时间:2025-09-08 22:59:42

我的收藏

功能预览

TUILiveKit 是一个功能全面的直播组件,集成后可快速实现以下功能模块:
主播准备页
主播开播页
直播列表
观众观看页













准备工作

开通服务

在使用 TUILiveKit 前,您需要在 TRTC 控制台 开通相关服务,并领取体验版或者开通付费版。

开发环境要求

Xcode 15 或更高版本。
iOS 13.0 或更高版本。
已安装 CocoaPods 环境。如果您尚未安装,请 点击查看 安装步骤。

代码集成

步骤 1:通过 CocoaPods 导入组件

TUILiveKit 组件通过 CocoaPods 导入,如果您对 CocoaPods 不熟悉,请先参见 环境准备。具体导入步骤如下:
1. 添加 Pod 依赖:在您的 Podfile 文件中添加 pod 'TUILiveKit' 依赖。如果您的项目中没有 Podfile,请在终端中 cd 到您的 .xcodeproj 目录,然后执行 pod init 命令创建。如果您遇到任何问题,请参见 Example 工程。
target 'xxxx' do
...
...
pod 'TUILiveKit'
end
如果您没有Podfile 文件,首先终端cdxxxx.xcodeproj目录,然后通过以下命令创建:
pod init
2. 安装组件:在终端中 cd 到 Podfile 所在的目录,然后执行以下命令安装组件。
pod install
如果无法安装 TUILiveKit 最新版本,可以先删除 Podfile.lock Pods。然后执行以下命令更新本地的 CocoaPods 仓库列表。
pod repo update
之后执行以下命令,更新组件库的 Pod 版本。
pod update
3. 您可以先编译运行,如果遇到问题,请参见 常见问题。问题如果依然无法解决,可以先去跑一下我们的 Example 工程。您在接入和使用过程中遇到的任何问题,欢迎给我们 反馈

步骤 2:工程配置

为了使用音视频功能,您的应用需要获取麦克风和摄像头的权限。请在应用的 Info.plist 文件中添加以下两项,并填写对应的使用说明,这将在系统请求权限时向用户显示。
<key>NSCameraUsageDescription</key>
<string>TUILiveKit需要访问你的相机权限,开启后录制的视频才会有画面</string>
<key>NSMicrophoneUsageDescription</key>
<string>TUILiveKit需要访问您的麦克风权限,开启后录制的视频才会有声音</string>


完成登录

集成完成后,您需要通过调用 TUICore 接口完成登录。这是使用 TUILiveKit 的关键步骤,因为只有在登录成功后才能正常使用 TUILiveKit 的各项功能,故请您耐心检查相关参数是否配置正确:
Swift
Objective-C
//
// AppDelegate.swift
//

import TUICore
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
TUILogin.login(1400000001, // 请替换为开通服务控制台的 SDKAppID
userID: "denny", // 请替换为您的 UserID
userSig: "xxxxxxxxxxx") { // 您可以在控制台中计算一个 UserSig 并填在这个位置
print("login success")
} fail: { (code, message) in
print("login failed, code: \\(code), error: \\(message ?? "nil")")
}
return true
}
//
// AppDelegate.m
//

#import <TUICore/TUILogin.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[TUILogin login:1400000001 // 请替换为开通服务控制台的 SDKAppID
userID:@"denny" // 请替换为您的 UserID
userSig:@"xxxxxxxxxxx" // 您可以在控制台中计算一个 UserSig 并填在这个位置
succ:^{
NSLog(@"login success");
} fail:^(int code, NSString * _Nullable msg) {
NSLog(@"login failed, code: %d, error: %@", code, msg);
}];
return YES;
}
登录接口参数说明
参数
类型
说明
SDKAppID
int
UserID
String
当前用户的唯一 ID,仅包含英文字母、数字、连字符和下划线。
userSig
String
用于腾讯云鉴权的票据。请注意:
开发环境:您可以采用本地 GenerateTestUserSig.genTestSig 函数生成 userSig 或者 通过 UserSig 辅助工具 生成临时的 UserSig。
生产环境:为了防止密钥泄露,请务必采用服务端生成 UserSig 的方式。详细信息请参考 服务端生成 UserSig
更多信息请参见 如何计算及使用 UserSig

接入直播功能

恭喜您,现在您已经成功集成了视频直播组件并完成了登录。接下来,您可以开始接入 主播开播观众观看 功能或实现其他直播功能。