IOS版本开发接入文档

更新时间：2025-08-22

一、概述

百度云短视频产品(SDK)专注移动端视音频场景研发，提供端到端的一站式视音频技术解决方案，不限于采集、录制、合成、上传、存储、分发，极大降低客户接入音视频产品的技术门槛。 1.1 注意事项 1.1.1 头文件引用说明 本SDK使用C++开发，对于引用<BDCloudAVContext/BDCloudAVContext.h>头文件的类文件，需要将.m文件修改成.mm文件,以适配C++。 1.1.2 运行环境 iOS9系统以上，Xcode->General->Depolyment Info->Depolyment Target

二、快速接入

请从百度云开发者中心下载最新版本拍摄器。

在使用拍摄器SDK，需要申请产品对应的授权文件，如无授权，产品无法正常使用。申请成功后，会得到一个licenseID和对应授权文件下载地址，用户下载成功后，需要手动添加到项目工程中注意：授权文件后缀名为.license。

三、使用说明

3.1 录制设置

录制的相关接口是在BDCloudAVStreamContext类里，包括采集预览(startPreview)，录制(startRecording:)，添加视频美颜(applyBeautyBaseVideoFx)等。注意：百度云拍摄器SDK所有的类都是以“BDCloud”开头。 3.1.1 BDCloudAVStreamContext类 BDCloudAVStreamContext是拍摄器SDK的流媒体上下文类，是接入拍摄器SDK产品的入口。开始使用前，需要先初始化BDCloudAVStreamContext类，注意BDCloudAVStreamContext是单例类。

BDCloudAVStreamContext初始化代码如下

_avStreamContext = [BDCloudAVStreamContext sharedInstance]; BDCloudAVStreamContext销毁代码如下

[_avStreamContext destroyInstance]; _avStreamContext = nil;

注意：BDCloudAVStreamContext初始化后，需要调用verifySDKLicense: completionHandler:验证客户的合法性，其中appid即用户申请的licenseID，若未申请授权，请参考快速接入

3.1.2 BDCloudAVStreamSettings类配置

BDCloudAVStreamSettings是拍摄器SDK配置项，支持客户调整摄像头位置、摄像头类型、视频维度（分辨率）、视频帧速率、视频帧码率及手电筒、对焦、曝光补光、预览放大缩小、预览模式。

考虑到配置项较多且偏专业，拍摄器SDK提供默认配置项，代码如下：

BDCloudAVStreamSettings *settings = [BDCloudAVStreamSettings defaultSettings];

3.1.3 预览前设置

完成流媒体上下文初始化及配置项后，下面就要创建预览前配置，创建拍摄器及预览画面，代码如下：

Plain Text

1// 使用配置项创建拍摄器
2_avStreamContext = [_avStreamContext initWithCaptureConfig:settings];
3// 获取拍摄器预览界面
4UIView *preview = _avStreamContext.view;
5// 设置预览界面展示区域
6preview.frame = self.view.bounds;
7// 设置拍摄器回调代理
8_avStreamContext.delegate = self;
9// 将预览界面添加到用户控制器上
10[self.view insertSubview:preview atIndex:0];

3.1.4 启动预览

启动预览对应startPreview接口，此接口发检查用户照相机和麦克风系统权限。

3.1.5 录制与停止录制

调用录制接口前startRecording: recordCallBack:，需要先创建录制文件的路径，建议用户使用.MOV和.mp4文件。录制接口在写入文件的同时，会不断回调给使用方，用户需要关心回调状态BDCloudAVStreamFileOutputState。

代码示例如下：

Plain Text

1    [[BDCloudAVStreamContext sharedInstance] startRecording:recordVideoPath recordCallBack:^(BDCloudAVStreamFileOutputState state, double recordSecond, NSError *error) {
2
3    switch (state) {
4
5        case BDCloudAVStreamFileOutputStateStarting:
6            break;
7        case BDCloudAVStreamFileOutputStateStarted:
8            break;
9        case BDCloudAVStreamFileOutputStateCancel:
10            break;
11        case BDCloudAVStreamFileOutputStateError:
12            //错误信息
13            break;
14        case BDCloudAVStreamFileOutputStateEnding:
15            //录制结束
16            break;
17        case BDCloudAVStreamFileOutputStateEnded:
18            break;
19        default:
20            break;
21    }
22
23}];

停止录制，代码示例如下：

[[BDCloudAVStreamContext sharedInstance] stopRecording];

3.1.6 录制设置

设置闪光灯是否开启，代码示例如下:

Plain Text

1    AVCaptureFlashMode      _flashMode; 
2   _flashMode = _flashMode == AVCaptureFlashModeOff ? AVCaptureFlashModeOn : AVCaptureFlashModeOff;
3    [[BDCloudAVStreamContext sharedInstance] toggleFlash:_flashMode];
4    if (_flashMode == AVCaptureFlashModeOff) {
5        [[BDCloudAVStreamContext sharedInstance] toggleTorch:NO];
6    }else {
7        [[BDCloudAVStreamContext sharedInstance] toggleTorch:YES];
8    }

设置自动对焦

Plain Text

1    [[BDCloudAVStreamContext sharedInstance] setCameraContinuousAutofocus:YES];
2    [[BDCloudAVStreamContext sharedInstance] setCameraFocusPointOfInterest:[BDCloudAVStreamContext sharedInstance].view.center];

设置曝光点

Plain Text

1[[BDCloudAVStreamContext sharedInstance] setCameraExposurePointOfInterest:[BDCloudAVStreamContext sharedInstance].view.center];

设置缩放

Plain Text

1[[BDCloudAVStreamContext sharedInstance] setCameraZoomFactor:1.3];

3.2 美颜设置

添加美颜(applyBeautyBaseVideoFx)特效后，在预览窗口就可以看到美颜效果。录制视频时，用户需要根据手机性能任意选择带美颜录制或者不带美颜录制。美颜特效分为基础美颜(美白、磨皮)和高级美颜(大眼、瘦脸)。

开启美颜，代码示例如下：

//开启美颜 [_avStreamContext applyBeautyBaseVideoFx]; //调整美白 [[BDCloudAVStreamContext sharedInstance] adjustBeautyWhiteLevel:newValue]; //调整磨皮 [[BDCloudAVStreamContext sharedInstance] adjustBeautyBlurLevel:newValue]; //调整大眼 [[BDCloudAVStreamContext sharedInstance] adjustBeautyEnlargingLevel:newValue]; //调整瘦脸 [[BDCloudAVStreamContext sharedInstance] adjustBeautyThinningLevel:newValue];

注意：需要在初始化拍摄器后开启美颜。使用高级美颜时，需要申请对应权限，免费版本不支持此功能

3.3 滤镜设置

开启滤镜(applyEffect:)特效后，在预览窗口就可以看到滤镜效果。

代码示例如下：

[[BDCloudAVStreamContext sharedInstance] applyEffect:filterID]; 注意：当前filterID仅支持内置滤镜使用，用户在申请授权成功后，会得到滤镜资源包，具体使用可以参考短视频SDK DemoD拍摄模块

3.4 贴纸设置

开启滤镜(applyLocalStickerVideoFx: stickerModelPath: stickerType: stickerIdentify:)特效后，在预览窗口就可以看到贴纸效果。

代码示例如下：

Plain Text

1    // 内置贴纸
2    NSString *name = [NSString stringWithFormat:@"AR.bundle/%@.zip", stickerID];
3
4    NSString *path = [[[NSBundle mainBundle]resourcePath] stringByAppendingPathComponent:name];
5
6    BOOL isExist = [[NSFileManager defaultManager] fileExistsAtPath:path];
7
8    //解压
9
10    if (isExist) {
11
12        NSString *destPath = [self localPath];
13
14        destPath = [destPath stringByAppendingPathComponent:stickerID];
15
16        BOOL bSucess = [self unzipStickerPackage:path destPath:destPath];
17
18        if (bSucess) {
19            // 开启贴纸
20            [[BDCloudAVStreamContext sharedInstance] applyLocalStickerVideoFx:destPath stickerModelPath:@"" stickerType:@"10" stickerIdentify:@"10273"];
21
22        }
23
24    } else {
25            // 关闭贴纸
26        [[BDCloudAVStreamContext sharedInstance] disabledStickerVideoFx];
27
28    }

快速接入

视频指导

智能视频SDK VideoCreatingSDK

智能视频SDK VideoCreatingSDK

IOS版本开发接入文档

一、概述

二、快速接入

三、使用说明