开发环境要求
Xcode 9.0+。
iOS 9.0 以上的 iPhone 或者 iPad 真机。
项目已配置有效的开发者签名。
集成 LiteAVSDK
您可以选择使用 CocoaPods 自动加载的方式,或者先下载 SDK,再将其导入到您当前的工程项目中。
CocoaPods
1. 安装 CocoaPods
在终端窗口中输入如下命令(需要提前在 Mac 中安装 Ruby 环境):
sudo gem install cocoapods
2. 创建 Podfile 文件
进入项目所在路径,输入以下命令行之后项目路径下会出现一个 Podfile 文件。
pod init
3. 编辑 Podfile 文件
编辑 Podfile 文件,有两种设置方式:
方式一:使用腾讯云 LiteAVSDK 的 podspec 文件路径。
platform :ios, '9.0'target 'App' dopod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'end
方式二:使用 CocoaPod 官方源,支持选择版本号。
platform :ios, '9.0'source 'https://github.com/CocoaPods/Specs.git'target 'App' dopod 'TXLiteAVSDK_Professional'end
4. 更新并安装 SDK
在终端窗口中输入如下命令以更新本地库文件,并安装 LiteAVSDK:
pod install
或使用以下命令更新本地库版本:
pod update
pod 命令执行完后,会生成集成了 SDK 的
.xcworkspace
后缀的工程文件,双击打开即可。手动集成
1. 下载 LiveAVSDK ,下载完成后进行解压。
2. 打开您的 Xcode 工程项目,选择要运行的 target , 选中 Build Phases 项。
3. 单击 Link Binary with Libraries 项展开,单击底下的 + 添加依赖库。
4. 依次添加所下载的
TXLiteAVSDK_Professional.framework
、TXFFmpeg.xcframework
、TXSoundTouch.xcframework
及其所需依赖库:AVFoundation.frameworkVideoToolbox.frameworklibz.tbdOpenGLES.frameworkAccelerate.frameworklibsqlite3.0.tbdMetalKit.frameworkCoreTelephony.frameworklibresolv.tbdGLKit.frameworkFoundation.frameworkSystemConfiguration.frameworkAssetsLibrary.frameworklibc++.tbdCoreServices.frameworkCoreMedia.frameworkAVKit.frameworkMetalPerformanceShaders.framework
5. 选中 Build Settings 项,搜索
Other Linker Flags
。添加-ObjC
。
授权摄像头和麦克风使用权限
使用 SDK 的音视频功能,需要授权麦克风和摄像头的使用权限。在 App 的 Info.plist 中添加以下两项,分别对应麦克风和摄像头在系统弹出授权对话框时的提示信息。
Privacy - Microphone Usage Description,并填入麦克风使用目的提示语。
Privacy - Camera Usage Description,并填入摄像头使用目的提示语。
在工程中引入 SDK
项目代码中使用 SDK 有两种方式:
方式一: 在项目需要使用 SDK API 的文件里,添加模块引用。
@import TXLiteAVSDK_Professional;
方式二:在项目需要使用 SDK API 的文件里,引入具体的头文件。
#import "TXLiteAVSDK_Professional/TXLiteAVSDK.h"
给 SDK 配置 License 授权
1. 单击 License 申请 获取测试用 License,您会获得两个字符串:一个字符串是 licenseURL,另一个字符串是解密 key。
2. 在您的 App 调用 LiteAVSDK 的相关功能之前(建议在
- [AppDelegate application:didFinishLaunchingWithOptions:]
中)进行如下设置:@import TXLiteAVSDK_Professional;@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {NSString * const licenceURL = @"<获取到的licenseUrl>";NSString * const licenceKey = @"<获取到的key>";//TXLiveBase 位于 "TXLiveBase.h" 头文件中[TXLiveBase setLicenceURL:licenceURL key:licenceKey];NSLog(@"SDK Version = %@", [TXLiveBase getSDKVersionStr]);}@end
常见问题
1. LiteAVSDK 是否支持后台运行?
支持,如需要进入后台仍然运行相关功能,操作如下:
1. 选中当前工程项目,选择 Signing&Capabilities ,单击左上角“+”,如图所示:
2. 选择 Background Modes。
3. 在 Background Modes中勾选 Audio,AirPlay and Picture in Picture ,如下图所示:
2. 项目里面同时集成了直播 SDK/实时音视频/播放器等 LiteAVSDK 系列的多个 SDK 报符号冲突问题怎么解决?
如果集成了2个或以上产品(直播、播放器、TRTC、短视频)的 LiteAVSDK 版本,编译时会出现库冲突问题,因为有些 SDK 底层库有相同符号文件,这里建议只集成一个全功能版 SDK 可以解决,直播、播放器、TRTC、短视频这些都包含在一个 SDK 里面。具体请参见 SDK 下载。