腾讯云短视频SDKSDK 集成(XCode)_音视频解决方案_同尘科技

支持平台

SDK 支持 iOS 8.0 以上系统。

开发环境

Xcode 9 或更高版本。iOS12.0及以上系统。

设置步骤

步骤1：链接 SDK 及系统库

将下载的 SDK 资源包解压，并将 SDK 文件夹中 TXLiteAVSDK_ 开头的 framework（如 TXLiteAVSDK_UGC.framework）复制到工程所在文件夹，并拖动到工程当中。1. 按照 SDK 的版本，集成对应的库：TXLiteAVSDK 9.5 以下添加集成库TXLiteAVSDK 10.0以上添加系统库1. 选中工程的 Target，添加以下系统库：Accelerate.frameworkSystemConfiguration.frameworklibc++.tbdlibsqlite3.tbd2. 添加完毕后，工程库依赖如下图所示：
1. 选中工程的 Target，添加以下系统库：Accelerate.frameworkSystemConfiguration.frameworklibc++.tbdlibsqlite3.tbdMetalKit.frameworkVideoToolbox.frameworkReplayKit.frameworkGLKit.frameworkOpenAL.frameworkCoreServices.framework2. Build Phases 选项下面添加以下动态库，动态库在 SDK 目录下的 Link Binary With Librares 添加：TXFFmpeg.xcframeworkTXSoundTouch.xcframework3. Embed Frameworks 中添加以下，勾选 Code Sign On Copy。TXFFmpeg.xcframeworkTXSoundTouch.xcframework2. 选中工程的 Target，在 Build Settings 中搜索 bitcode，将 Enable Bitcode 设置为 NO。

步骤2：配置 App 权限

应用会需要相册及相册的访问权限，需要在 Info.plist 中添加对应项，可以通过在 Info.plist 中右键选 Open as / Source Code 粘贴并修改以下内容进行配置。

NSAppleMusicUsageDescription 视频云工具包需要访问您的媒体库权限以获取音乐，不允许则无法添加音乐 NSCameraUsageDescription 视频云工具包需要访问您的相机权限，开启后录制的视频才会有画面 NSMicrophoneUsageDescription 视频云工具包需要访问您的麦克风权限，开启后录制的视频才会有声音 NSPhotoLibraryAddUsageDescription 视频云工具包需要访问您的相册权限，开启后才能保存编辑的文件 NSPhotoLibraryUsageDescription 视频云工具包需要访问您的相册权限，开启后才能编辑视频文件 

步骤3：SDK License 设置与基本信息获取

1. 通过 License 申请 的指引申请 License 后，从 控制台 复制 key 和 url，见下图。
2. 在您的应用中使用短视频功能之前，建议在- [AppDelegate application:didFinishLaunchingWithOptions:]中进行如下设置：

@import TXLiteAVSDK_UGC;@implementation AppDelegate- (BOOL)application:(UIApplication*)applicationdidFinishLaunchingWithOptions:(NSDictinoary*)options {    NSString * const licenceURL = @"";    NSString * const licenceKey = @"";    [TXUGCBase setLicenceURL:licenceURL key:licenceKey];    NSLog(@"SDK Version = %@", [TXLiveBase getSDKVersionStr]);}@end

说明对于使用4.7版本 License 的用户，如果您升级了 SDK 到4.9版本，您可以登录控制台，单击下图的 切换到新版License 生成对应的 key 和 url，切换后的 License 必须使用4.9及更高的版本，切换后按照上述操作集成即可。


步骤4：Log 配置

在 TXLiveBase 中可以设置 log 是否在控制台打印以及 log 的级别，相关接口如下：setConsoleEnabled
设置是否在 xcode 的控制台打印 SDK 的相关输出。setLogLevel
设置是否允许 SDK 打印本地 log，SDK 默认会将 log 写到当前 App 的 Documents/logs 文件夹下。
如果您需要我们的技术支持，建议将此开关打开，在重现问题后提供 log 文件，非常感谢您的支持。Log 文件的查看
小直播 SDK 为了减少 log 的存储体积，对本地存储的 log 文件做了加密，并且限制了 log 数量的大小，所以要查看 log 的文本内容，需要使用 log 解压缩工具。

[TXLiveBase setConsoleEnabled:YES];[TXLiveBase setLogLevel:LOGLEVEL_DEBUG];

步骤5：编译运行

如果前面各步骤都操作正确的话，HelloSDK 工程就可以顺利编译通过。在 Debug 模式下运行 App，Xcode 的 Console 窗格会打印出 SDK 的版本信息：

2017-09-26 16:16:15.767 HelloSDK[17929:7488566] SDK Version = 5.2.5541

快速接入功能模块

为了方便您快速集成 SDK 各项功能，我们提供了 UGCKit。UGCKit 是在短视频 SDK 基础上构建的一套 UI 组件库。您可以通过 GitHub 或 资源下载 中提供的 SDK 压缩包获取 UGCKit。UGCKit 位于压缩包 Demo/TXLiteAVDemo/UGC/UGCKit 目录下。

UGCKit 开发环境要求

Xcode 10 及以上。iOS 9.0 及以上。

步骤1：集成 UGCKit

1. 项目中使用 cocoapods，根据实际情况选择其中一种操作：在项目根目录，执行 pod init && pod install，可得到 Podfile 文件。把 UGCKit 文件夹拷贝到项目根目录下（Podfile 同级目录）。2. 打开 Podfile 文件，增加：

pod 'UGCKit', :path => 'UGCKit/UGCKit.podspec', :subspecs => ["UGC"]   #subspecs 根据SDK来选择

3. 如果集成基础美颜，把BeautySettingKit文件夹拷贝到项目根目录下（Podfile 同级目录），并且在Podfile文件中，增加：

pod 'BeautySettingKit', :path => 'BeautySettingKit/BeautySettingKit.podspec'

4. 如果集成腾讯特效，把xmagickit文件夹拷贝到项目根目录下（Podfile 同级目录），并且在Podfile文件中增加：

pod 'xmagickit', :path => 'xmagickit/xmagickit.podspec'

5. 执行 pod install，并打开 项目名.xcworkspace，可以看到在 Pods/Development Pods 目录下已有 UGCKit BeautySettingKit x magickit。

步骤2：使用 UGCKit

1. 录制UGCKitRecordViewController提供了完整的录制功能，您只需实例化这个控制器后展现在界面中即可。

UGCKitRecordViewController *recordViewController = [[UGCKitRecordViewController alloc] initWithConfig:nil theme:nil];[self.navigationController pushViewController:recordViewController]

录制后的结果将通过 completion block 回调，示例如下：

recordViewController.completion = ^(UGCKitResult *result) { if (result.error) {     // 录制出错     [self showAlertWithError:error]; } else {     if (result.cancelled) {          // 用户取消录制，退出录制界面          [self.navigationController popViewControllerAnimated:YES];     } else {          // 录制成功, 用结果进行下一步处理          [self processRecordedVideo:result.media];     } }};

2. 编辑UGCKitEditViewController提供了完整的图片转场和视频编辑功能，实例化时需要传入待编辑的媒体对象，以处理录制结果为例，示例如下：

- (void)processRecordedVideo:(UGCKitMedia *)media {     // 实例化编辑控制器     UGCKitEditViewController *editViewController = [[UKEditViewController alloc] initWithMedia:media conifg:nil theme:nil];     // 展示编辑控制器     [self.navigationController pushViewController:editViewController animated:YES];

编辑后的结果将通过 completion block 回调，示例如下：

editViewController.completion = ^(UGCKitResult *result) {    if (result.error) {         // 出错        [self showAlertWithError:error];    } else {         if (result.cancelled) {                 // 用户取消录制，退出编辑界面                 [self.navigationController popViewControllerAnimated:YES];        } else {                 // 编辑保存成功, 用结果进行下一步处理                 [self processEditedVideo:result.path];         }    }}

3. 从相册中选择视频或图片3.1 UGCKitMediaPickerViewController 用来处理媒体的选择与合并，当选择多个视频时，将会返回拼接后的视频，示例如下：

// 初始化配置UGCKitMediaPickerConfig *config = [[UGCKitMediaPickerConfig alloc] init];config.mediaType = UGCKitMediaTypeVideo;//选择视频config.maxItemCount = 5;                //最多选5个
// 实例化媒体选择器UGCKitMediaPickerViewController *mediaPickerViewController = [[UGCKitMediaPickerViewController alloc] initWithConfig:config theme:nil];// 展示媒体选择器[self presentViewController:mediaPickerViewController animated:YES completion:nil];

3.2 选择的结果将通过 completion block 回调，示例如下：

mediaPickerViewController.completion = ^(UGCKitResult *result) { if (result.error) {  // 出错  [self showAlertWithError:error]; } else {     if (result.cancelled) {              // 用户取消录制，退出选择器界面              [self dismissViewControllerAnimated:YES completion:nil];     } else {              // 编辑保存成功, 用结果进行下一步处理              [self processEditedVideo:result.media];     } }}

4. 裁剪UGCKitCutViewController提供视频的裁剪功能，与编辑接口相同，在实例化时传入媒体对象，在 completion 中处理剪辑结果即可。示例如下：

UGCKitMedia *media = [UGCKitMedia mediaWithVideoPath:@""];UGCKitCutViewController *cutViewController = [[UGCKitCutViewController alloc] initWithMedia:media theme:nil];cutViewController.completion = ^(UGCKitResult *result) {     if (!result.cancelled && !result.error) {              [self editVideo:result.media];     } else {              [self.navigationController popViewControllerAnimated:YES];     }}[self.navigationController pushViewController: cutViewController]

详细介绍

以下为 SDK 各模块的详细说明：视频录制视频编辑视频拼接视频上传视频播放

对音视频的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案