正文
avfoundation 是apple ios和os x系统中用于处理基于时间的媒体数据的高级框架,通过开发所需的工具提供了强大的功能集,让开发者能够基于苹果平台创建当下最先进的媒体应用程序,其针对64位处理器设计,充分利用了多核硬件优势,会自动提供硬件加速操作,确保大部分设备能以最佳性能运行,是ios开发接触音视频开发必学的框架之一。
参与掘金日新计划,持续记录avfoundation学习,demo学习地址,里面封装了一些工具类,可以直接使用,这篇文章主要讲述avfoundation中的avcapturesession等类实现媒体捕捉功能,其他类的相关用法可查看我的其他文章。
捕捉媒体
媒体捕捉是avfoundation的核心功能之一,也是开发音视频app必不可少的功能。捕捉用到的类如图所示

- avcapturesession是avfoundation捕捉栈的核心类,捕捉会话用于连接输入和输出资源,管理从物理设备得到的输入流,例如从摄像头得到的视频从麦克风得到的音频,以不同的方式输出给一个或多个输出,可以动态配置输入和输出线路,让开发者能够在会话中按需重新配置捕捉环境。
- avcapturedevice为摄像头麦克风等物理设备定义了一个接口,在ios10以后,使用avcapturedevicediscoverysession获取设备。
- 将avcapturedevice包装成avcapturedeviceinput才能添加到捕捉回话中。
- avfoundation定义了avcaptureoutput的许多扩展类,avcaptureoutput是一个抽象基类,用于从捕捉回话中得到数据,框架定义了这个抽象类的高级扩展类,常用的有avcapturestillimageoutput静态图片输出、avcapturemoviefileoutput视频文件输出、avcapturevideodataoutput视频流数据输出、avcaptureaudiodataoutput音频流数据输出、avcapturemetadataoutput元数据输出。注意,不能同时配置avcapturevideodataoutput和avcapturemoviefileoutput,二者无法同时启用。
- avcapturevideopreviewlayer是coreanimation框架中calayer的一个子类,对捕捉视频数据实时预览。当然也可以使用glkview、uiimageview预览实时视频流的buffer。
具体代码可以看demo中的cqcapturemanager类对捕捉工具的封装
1.创建会话
创建会话并配置分辨率
- 配置分辨率注意要判断下能否支持,例如老机型前置摄像头配置4k是不支持的。
- 不同分辨率的缩放倍数也是不同的
self.capturesession = [[avcapturesession alloc] init];
- (void)configsessionpreset:(avcapturesessionpreset)sessionpreset {
    [self.capturesession beginconfiguration];
    if ([self.capturesession cansetsessionpreset:sessionpreset])  {
        self.capturesession.sessionpreset = sessionpreset;
    } else {
        self.capturesession.sessionpreset = avcapturesessionpresethigh;
    }
    [self.capturesession commitconfiguration];
    self.isconfigsessionpreset = yes;
}
2.配置视频输入
/// 配置视频输入
- (bool)configvideoinput:(nserror * _nullable *)error {
    // 添加视频捕捉设备
    // 拿到默认视频捕捉设备 ios默认后置摄像头
//    avcapturedevice *videodevice = [avcapturedevice defaultdevicewithmediatype:avmediatypevideo];
    avcapturedevice *videodevice = [self getcamerawithposition:avcapturedevicepositionback];
    // 将捕捉设备转化为avcapturedeviceinput
    // 注意:会话不能直接使用avcapturedevice,必须将avcapturedevice封装成avcapturedeviceinput对象
    avcapturedeviceinput *videoinput = [avcapturedeviceinput deviceinputwithdevice:videodevice error:error];
    // 将捕捉设备添加给会话
    // 使用前判断videoinput是否有效以及能否添加,因为摄像头是一个公共设备,不属于任何app,有可能别的app在使用,添加前应该先进行判断是否可以添加
    if (videoinput && [self.capturesession canaddinput:videoinput]) {
        // 将videoinput 添加到 capturesession中
        [self.capturesession beginconfiguration];
        [self.capturesession addinput:videoinput];
        [self.capturesession commitconfiguration];
        self.videodeviceinput = videoinput;
        return yes;
    }else {
        return no;
    }
}
/// 移除视频输入设备
- (void)removevideodeviceinput {
    if (self.videodeviceinput) [self.capturesession removeinput:self.videodeviceinput];
    self.videodeviceinput = nil;
}
- 获取摄像头,ios10之后使用avcapturedevicediscoverysession获取
- 长焦超广或者双摄三摄必须使用avcapturedevicediscoverysession获取,[avcapturedevice deviceswithmediatype:avmediatypevideo]无法获取
/// 根据position拿到摄像头
- (avcapturedevice *)getcamerawithposition:(avcapturedeviceposition)position {
    /**
     avcapturedevicetypebuiltinwideanglecamera 广角(默认设备,28mm左右焦段)
     avcapturedevicetypebuiltintelephotocamera 长焦(默认设备的2x或3x,只能使用avcapturedevicediscoverysession获取)
     avcapturedevicetypebuiltinultrawidecamera 超广角(默认设备的0.5x,只能使用avcapturedevicediscoverysession获取)
     avcapturedevicetypebuiltindualcamera (一个广角一个长焦(iphone7p,iphonex),可以自动切换摄像头,只能使用avcapturedevicediscoverysession获取)
     avcapturedevicetypebuiltindualwidecamera (一个超广一个广角(iphone12 iphone13),可以自动切换摄像头,只能使用avcapturedevicediscoverysession获取)
     avcapturedevicetypebuiltintriplecamera (超广,广角,长焦三摄像头,iphone11promax iphone12promax iphone13promax,可以自动切换摄像头,只能使用avcapturedevicediscoverysession获取)
     avcapturedevicetypebuiltintruedepthcamera (红外和摄像头, iphone12promax iphone13promax )
     */
    nsarray *devicetypes;
    if (position == avcapturedevicepositionback) {
        devicetypes = @[avcapturedevicetypebuiltindualcamera,
                        avcapturedevicetypebuiltindualwidecamera,
                        avcapturedevicetypebuiltintriplecamera, ];
    } else {
        devicetypes = @[avcapturedevicetypebuiltinwideanglecamera];
    }
    avcapturedevicediscoverysession *devicesession = [avcapturedevicediscoverysession discoverysessionwithdevicetypes:devicetypes mediatype:avmediatypevideo position:position];
    if (devicesession.devices.count) return devicesession.devices.firstobject;
    if (position == avcapturedevicepositionback) {
        // 非多摄手机
        devicetypes = @[avcapturedevicetypebuiltinwideanglecamera];
        avcapturedevicediscoverysession *devicesession = [avcapturedevicediscoverysession discoverysessionwithdevicetypes:devicetypes mediatype:avmediatypevideo position:position];
        if (devicesession.devices.count) return devicesession.devices.firstobject;
    }
    return nil;
}
3.配置音频输入
/// 配置音频输入
- (bool)configaudioinput:(nserror * _nullable *)error {
    // 添加音频捕捉设备 ,如果只是拍摄静态图片,可以不用设置
    // 选择默认音频捕捉设备 即返回一个内置麦克风
    avcapturedevice *audiodevice = [avcapturedevice defaultdevicewithmediatype:avmediatypeaudio];
    self.audiodeviceinput = [avcapturedeviceinput deviceinputwithdevice:audiodevice error:error];
    if (self.audiodeviceinput && [self.capturesession canaddinput:self.audiodeviceinput]) {
        [self.capturesession beginconfiguration];
        [self.capturesession addinput:self.audiodeviceinput];
        [self.capturesession commitconfiguration];
        return yes;
    }else {
        return no;
    }
}
/// 移除音频输入设备
- (void)removeaudiodeviceinput {
    if (self.audiodeviceinput) [self.capturesession removeinput:self.audiodeviceinput];
}
5.配置输出
#pragma mark - func 静态图片输出配置
/// 配置静态图片输出
- (void)configstillimageoutput {
    // avcapturestillimageoutput 从摄像头捕捉静态图片
    self.stillimageoutput = [[avcapturestillimageoutput alloc] init];
    // 配置字典:希望捕捉到jpeg格式的图片
    self.stillimageoutput.outputsettings = @{avvideocodeckey:avvideocodecjpeg};
    // 输出连接 判断是否可用,可用则添加到输出连接中去
    [self.capturesession beginconfiguration];
    if ([self.capturesession canaddoutput:self.stillimageoutput]) {
        [self.capturesession addoutput:self.stillimageoutput];
    }
    [self.capturesession commitconfiguration];
}
/// 移除静态图片输出
- (void)removestillimageoutput {
    if (self.stillimageoutput) [self.capturesession removeoutput:self.stillimageoutput];
}
#pragma mark - func 电影文件输出配置
/// 配置电影文件输出
- (void)configmoviefileoutput {
    // avcapturemoviefileoutput,将quicktime视频录制到文件系统
    self.moviefileoutput = [[avcapturemoviefileoutput alloc] init];
    [self.capturesession beginconfiguration];
    if ([self.capturesession canaddoutput:self.moviefileoutput]) {
        [self.capturesession addoutput:self.moviefileoutput];
    }
    [self.capturesession commitconfiguration];
}
/// 移除电影文件输出
- (void)removemoviefileoutput {
    if (self.moviefileoutput) [self.capturesession removeoutput:self.moviefileoutput];
}
6.开始会话\结束会话
// 异步开始会话
- (void)startsessionasync {
    // 检查是否处于运行状态
    if (![self.capturesession isrunning]) {
        // 使用同步调用会损耗一定的时间,则用异步的方式处理
        dispatch_async(self.capturevideoqueue, ^{
            [self.capturesession startrunning];
        });
    }
}
// 异步停止会话
- (void)stopsessionasync {
    // 检查是否处于运行状态
    if ([self.capturesession isrunning]) {
        dispatch_async(self.capturevideoqueue, ^{
            [self.capturesession stoprunning];
        });
    }
}
7.捕捉静态图片
#pragma mark - 静态图片捕捉
#pragma mark public func 静态图片捕捉
// 捕捉静态图片
- (void)capturestillimage {
    if (!self.isconfigsessionpreset) [self configsessionpreset:avcapturesessionpresetmedium];
    if (!self.videodeviceinput) {
        nserror *configerror;
        bool configresult = [self configvideoinput:&configerror];
        if (!configresult) return;
    }
    if (!self.stillimageoutput) [self configstillimageoutput];
    [self startsessionsync];
    // 获取图片输出连接
    avcaptureconnection *connection = [self.stillimageoutput connectionwithmediatype:avmediatypevideo];
    // 即使程序只支持纵向,但是如果用户横向拍照时,需要调整结果照片的方向
    // 判断是否支持设置视频方向, 支持则根据设备方向设置输出方向值
    if (connection.isvideoorientationsupported) {
        connection.videoorientation = [self getcurrentvideoorientation];
    }
    [self.stillimageoutput capturestillimageasynchronouslyfromconnection:connection completionhandler:^(cmsamplebufferref  _nullable imagedatasamplebuffer, nserror * _nullable error) {        if (imagedatasamplebuffer != null) {            dispatch_async(dispatch_get_main_queue(), ^{                if (self.delegate && [self.delegate respondstoselector:@selector(mediacaptureimagefilesuccess)]) {
                    [self.delegate mediacaptureimagefilesuccess];
                }
            });
            // cmsamplebufferref转uiimage 并写入相册
            nsdata *imagedata = [avcapturestillimageoutput jpegstillimagensdatarepresentation:imagedatasamplebuffer];
            uiimage *image = [[uiimage alloc] initwithdata:imagedata];
            [self writeimagetoassetslibrary:image];
        } else {
            dispatch_async(dispatch_get_main_queue(), ^{
                if (self.delegate && [self.delegate respondstoselector:@selector(mediacaptureimagefailedwitherror:)]) {
                    [self.delegate mediacaptureimagefailedwitherror:error];
                }
            });
            nslog(@"null samplebuffer:%@",[error localizeddescription]);
        }
    }];
}
#pragma mark private func 静态图片捕捉
/**
 assets library 框架
 用来让开发者通过代码方式访问ios photo
 注意:会访问到相册,需要修改plist 权限。否则会导致项目崩溃
 */
/// 将uiimage写入到用户相册
- (void)writeimagetoassetslibrary:(uiimage *)image {
    alassetslibrary *library = [[alassetslibrary alloc] init];
    // 参数1 图片, 参数2 方向, 参数3 回调
    [library writeimagetosavedphotosalbum:image.cgimage orientation:(nsuinteger)image.imageorientation completionblock:^(nsurl *asseturl, nserror *error) {        if (!error) {            dispatch_async(dispatch_get_main_queue(), ^{                if (self.delegate && [self.delegate respondstoselector:@selector(assetlibrarywriteimagesuccesswithimage:)]) {
                    [self.delegate assetlibrarywriteimagesuccesswithimage:image];
                }
            });
        } else {
            dispatch_async(dispatch_get_main_queue(), ^{
                if (self.delegate && [self.delegate respondstoselector:@selector(assetlibrarywriteimagefailedwitherror:)]) {
                    [self.delegate assetlibrarywriteimagefailedwitherror:error];
                }
            });
        }
    }];
}
8.捕捉视频文件
#pragma mark - 电影文件捕捉
#pragma mark public func 电影文件捕捉
// 开始录制电影文件
- (void)startrecordingmoviefile {
    if (!self.isconfigsessionpreset) [self configsessionpreset:avcapturesessionpresetmedium];
    if (!self.videodeviceinput) {
        nserror *configerror;
        bool configresult = [self configvideoinput:&configerror];
        if (!configresult) return;
    }
    if (!self.moviefileoutput) [self configmoviefileoutput];
    [self startsessionsync];
    if ([self isrecordingmoviefile]) return;
    avcaptureconnection *videoconnection = [self.moviefileoutput connectionwithmediatype:avmediatypevideo];
    // 设置输出方向
    // 即使程序只支持纵向,但是如果用户横向拍照时,需要调整结果照片的方向
    // 判断是否支持设置视频方向, 支持则根据设备方向设置输出方向值
    if (videoconnection.isvideoorientationsupported) {
        videoconnection.videoorientation = [self getcurrentvideoorientation];
    }
    // 设置视频帧稳定
    // 判断是否支持视频稳定 可以显著提高视频的质量。只会在录制视频文件涉及
//    if (videoconnection.isvideostabilizationsupported) {
//        videoconnection.enablesvideostabilizationwhenavailable = yes;
//    }
    videoconnection.preferredvideostabilizationmode = avcapturevideostabilizationmodeauto;
    // 设置对焦
    avcapturedevice *device = [self getactivecamera];
    // 摄像头可以进行平滑对焦模式操作。即减慢摄像头镜头对焦速度。当用户移动拍摄时摄像头会尝试快速自动对焦。
    if (device.issmoothautofocusenabled) {
        nserror *error;
        if ([device lockforconfiguration:&error]) {
            device.smoothautofocusenabled = yes;
            [device unlockforconfiguration];
        } else {
            dispatch_async(dispatch_get_main_queue(), ^{
                if (self.delegate && [self.delegate respondstoselector:@selector(deviceconfigurationfailedwitherror:)]) {
                    [self.delegate deviceconfigurationfailedwitherror:error];
                }
            });
        }
    }
    self.moviefileoutputurl = [self getvideotemppathurl];
    // 开始录制 参数1:录制保存路径  参数2:代理
    [self.moviefileoutput startrecordingtooutputfileurl:self.moviefileoutputurl recordingdelegate:self];
}
// 停止录制电影文件
- (void)stoprecordingmoviefile {
    if ([self isrecordingmoviefile]) {
        [self.moviefileoutput stoprecording];
    }
}
// 是否在录制电影文件
- (bool)isrecordingmoviefile {
    return self.moviefileoutput.isrecording;
}
// 录制电影文件的时间
- (cmtime)moviefilerecordedduration {
    return self.moviefileoutput.recordedduration;
}
#pragma mark avcapturefileoutputrecordingdelegate
/// 捕捉电影文件成功的回调
- (void)captureoutput:(avcapturefileoutput *)output didfinishrecordingtooutputfileaturl:(nsurl *)outputfileurl fromconnections:(nsarray<avcaptureconnection *> *)connections error:(nserror *)error {
    if (error) {
        dispatch_async(dispatch_get_main_queue(), ^{
            if (self.delegate && [self.delegate respondstoselector:@selector(mediacapturemoviefilefailedwitherror:)]) {
                [self.delegate mediacapturemoviefilefailedwitherror:error];
            }
        });
    } else {
        dispatch_async(dispatch_get_main_queue(), ^{
            if (self.delegate && [self.delegate respondstoselector:@selector(mediacapturemoviefilesuccess)]) {
                [self.delegate mediacapturemoviefilesuccess];
            }
        });
        // copy一个副本再置为nil
        // 将文件写入相册
        [self writevideotoassetslibrary:self.moviefileoutputurl.copy];
        self.moviefileoutputurl = nil;
    }
}
#pragma mark private func 电影文件捕捉
/// 创建视频文件临时路径url
- (nsurl *)getvideotemppathurl {
    nsfilemanager *filemanager = [nsfilemanager defaultmanager];
    nsstring *temppath = [filemanager temporarydirectorywithtemplatestring:@"video.xxxxxx"];
    if (temppath) {
        nsstring *filepath = [temppath stringbyappendingpathcomponent:@"temp_video.mov"];
        return [nsurl fileurlwithpath:filepath];
    }
    return nil;
}
/// 将视频文件写入到用户相册
- (void)writevideotoassetslibrary:(nsurl *)videourl {
    alassetslibrary *library = [[alassetslibrary alloc] init];
    // 和图片不同,视频的写入更耗时,所以写入之前应该判断是否能写入
    if (![library videoatpathiscompatiblewithsavedphotosalbum:videourl]) return;
    [library writevideoatpathtosavedphotosalbum:videourl completionblock:^(nsurl *asseturl, nserror *error) {
        if (error) {
            dispatch_async(dispatch_get_main_queue(), ^{
                if (self.delegate && [self.delegate respondstoselector:@selector(assetlibrarywritemoviefilefailedwitherror:)]) {
                    [self.delegate assetlibrarywritemoviefilefailedwitherror:error];
                }
            });
        } else {
            // 写入成功 回调封面图
            [self getvideocoverimagewithvideourl:videourl callblock:^(uiimage *coverimage) {
                dispatch_async(dispatch_get_main_queue(), ^{
                    if (self.delegate && [self.delegate respondstoselector:@selector(assetlibrarywritemoviefilesuccesswithcoverimage:)]) {
                        [self.delegate assetlibrarywritemoviefilesuccesswithcoverimage:coverimage];
                    }
                });
            }];
        }
    }];
}
/// 获取视频文件封面图
- (void)getvideocoverimagewithvideourl:(nsurl *)videourl callblock:(void(^)(uiimage *))callblock {
    dispatch_async(self.capturevideoqueue, ^{
        avasset *asset = [avasset assetwithurl:videourl];
        avassetimagegenerator *imagegenerator = [avassetimagegenerator assetimagegeneratorwithasset:asset];
        // 设置maximumsize 宽为100,高为0 根据视频的宽高比来计算图片的高度
        imagegenerator.maximumsize = cgsizemake(100.0f, 0.0f);
        // 捕捉视频缩略图会考虑视频的变化(如视频的方向变化),如果不设置,缩略图的方向可能出错
        imagegenerator.appliespreferredtracktransform = yes;
        cgimageref imageref = [imagegenerator copycgimageattime:kcmtimezero actualtime:null error:nil];
        uiimage *image = [uiimage imagewithcgimage:imageref];
        cgimagerelease(imageref);
        dispatch_async(dispatch_get_main_queue(), ^{
            !callblock ?: callblock(image);
        });
    });
}
9.预览视频
previewview.session = capturemanager.capturesession
以上就是avfoundation avcapturesession媒体捕捉的详细内容,更多关于avfoundation avcapturesession的资料请关注代码网其它相关文章!
 
             我要评论
我要评论 
                                             
                                            
发表评论