Конфигурирование сеанса

Вы используете предварительную установку на сеансе для указания качества изображения и разрешения, которое Вы хотите. Предварительная установка является константой, идентифицирующей одну из многих возможных конфигураций; в некоторых случаях фактическая конфигурация специфична для устройства:

Если Вы хотите установить носители специфичная для типа телосложения конфигурация, необходимо проверить, поддерживается ли она прежде, чем установить его, следующим образом:

if ([session canSetSessionPreset:AVCaptureSessionPreset1280x720]) {

    session.sessionPreset = AVCaptureSessionPreset1280x720;

}

else {

    // Handle the failure.

}

Если бы необходимо скорректировать параметры сеанса на более гранулированном уровне, чем возможно с предварительной установкой, или требуется внести изменения в рабочий сеанс, Вы окружаете свои изменения beginConfiguration и commitConfiguration методы. beginConfiguration и commitConfiguration методы гарантируют, чтобы изменения устройств произошли как группа, минимизировав видимость или несоответствие состояния. После вызова beginConfiguration, можно добавить или удалить выводы, измениться sessionPreset свойство, или конфигурируют свойства ввода или вывода получения частного лица. Никакие изменения фактически не внесены, пока Вы не вызываете commitConfiguration, в котором времени они применяются вместе.

[session beginConfiguration];

// Remove an existing capture device.

// Add a new capture device.

// Reset the preset.

[session commitConfiguration];

Контроль состояния сеанса получения

Сеанс получения отправляет уведомления, которые можно наблюдать, чтобы быть уведомленными, например, когда он запускает или прекращает работать, или когда он прерван. Можно зарегистрироваться для получения AVCaptureSessionRuntimeErrorNotification если происходит ошибка периода выполнения. Можно также опросить сеанс running свойство, чтобы узнать, работает ли это, и interrupted свойство, чтобы узнать, прервано ли это. Кроме того, оба running и interrupted свойства являются значением ключа, наблюдающим совместимый, и уведомления отправляются на основном потоке.

Характеристики устройства

Можно спросить устройство о его различных характеристиках. Можно также протестировать, обеспечивает ли это определенный тип среды или поддерживает данное предварительно установленное использование сеанса получения hasMediaType: и supportsAVCaptureSessionPreset: соответственно. Для предоставления информации пользователю можно узнать позицию устройства захвата изображения (является ли это на передней стороне или задней части протестированного модуля), и его локализованное имя. Если Вы хотите представить список устройств захвата изображения, чтобы позволить пользователю выбирать то, это может быть полезно.

Рисунок 4-1 показывает позиции обращенного к задней стороне (AVCaptureDevicePositionBack) и обращенный к передней стороне (AVCaptureDevicePositionFront) камеры.

Следующий пример кода выполняет итерации по всем доступным устройствам и регистрирует их имя — и для видеоустройств, их позиции — на модуле.

NSArray *devices = [AVCaptureDevice devices];

for (AVCaptureDevice *device in devices) {

    NSLog(@"Device name: %@", [device localizedName]);

    if ([device hasMediaType:AVMediaTypeVideo]) {

        if ([device position] == AVCaptureDevicePositionBack) {

            NSLog(@"Device position : back");

        }

        else {

            NSLog(@"Device position : front");

        }

    }

}

Кроме того, можно узнать ID устройства модели и его уникальный идентификатор.

Настройки получения устройства

Различные устройства имеют различные возможности; например, некоторые могут поддерживать различный фокус или высветить режимы; некоторые могут поддерживать внимание на интересное место.

Следующий фрагмент кода показывает, как можно найти устройства ввода видеосигнала, имеющие режим факела и поддерживающие данную предварительную установку сеанса получения:

NSArray *devices = [AVCaptureDevice devicesWithMediaType:AVMediaTypeVideo];

NSMutableArray *torchDevices = [[NSMutableArray alloc] init];

for (AVCaptureDevice *device in devices) {

    [if ([device hasTorch] &&

         [device supportsAVCaptureSessionPreset:AVCaptureSessionPreset640x480]) {

        [torchDevices addObject:device];

    }

}

Если Вы находите многократные устройства, удовлетворяющие Ваши критерии, Вы могли бы позволить пользователю выбрать, какой они хотят использовать. Для отображения описания устройства пользователю можно использовать localizedName свойство.

Вы используете всевозможные функции похожими способами. Существуют константы для указания определенного режима, и можно спросить устройство, поддерживает ли это определенный режим. В нескольких случаях можно наблюдать, что свойство уведомляется, когда изменяется функция. Во всех случаях необходимо заблокировать устройство прежде, чем изменить режим определенной функции, как описано в Конфигурировании Устройства.

if ([currentDevice isFocusModeSupported:AVCaptureFocusModeContinuousAutoFocus]) {

    CGPoint autofocusPoint = CGPointMake(0.5f, 0.5f);

    [currentDevice setFocusPointOfInterest:autofocusPoint];

    [currentDevice setFocusMode:AVCaptureFocusModeContinuousAutoFocus];

}

if ([currentDevice isExposureModeSupported:AVCaptureExposureModeContinuousAutoExposure]) {

    CGPoint exposurePoint = CGPointMake(0.5f, 0.5f);

    [currentDevice setExposurePointOfInterest:exposurePoint];

    [currentDevice setExposureMode:AVCaptureExposureModeContinuousAutoExposure];

}

AVCaptureConnection *captureConnection = <#A capture connection#>;

if ([captureConnection isVideoOrientationSupported])

{

    AVCaptureVideoOrientation orientation = AVCaptureVideoOrientationLandscapeLeft;

    [captureConnection setVideoOrientation:orientation];

}

Конфигурирование устройства

Для установки свойств получения на устройстве необходимо сначала получить блокировку на использовании устройства lockForConfiguration:. Это избегает вносить изменения, которые могут быть несовместимыми с настройками в других приложениях. Следующий фрагмент кода иллюстрирует, как приблизиться к изменению режима фокуса на устройстве первым определением, поддерживается ли режим, затем пытаясь заблокировать устройство для реконфигурирования. Режим фокуса изменяется, только если блокировка получена, и блокировка выпущена сразу позже.

if ([device isFocusModeSupported:AVCaptureFocusModeLocked]) {

    NSError *error = nil;

    if ([device lockForConfiguration:&error]) {

        device.focusMode = AVCaptureFocusModeLocked;

        [device unlockForConfiguration];

    }

    else {

        // Respond to the failure as appropriate.

Необходимо содержать блокировку устройства, только если Вам нужны устанавливаемые свойства устройства, чтобы остаться неизменными. Содержание блокировки устройства излишне может ухудшить качество получения в других приложениях, совместно использующих устройство.

Переключение между устройствами

Иногда можно хотеть позволить пользователям переключаться между устройствами ввода данных — например, переключаясь от использования обращенного к передней стороне к к обращенной к задней стороне камере. Для предотвращения пауз или заикания можно реконфигурировать сеанс, в то время как оно работает, однако необходимо использовать beginConfiguration и commitConfiguration заключить в скобки Ваши изменения конфигурации:

AVCaptureSession *session = <#A capture session#>;

[session beginConfiguration];

[session removeInput:frontFacingCameraDeviceInput];

[session addInput:backFacingCameraDeviceInput];

[session commitConfiguration];

Когда наиболее удаленное commitConfiguration вызывается, все изменения внесены вместе. Это гарантирует плавный переход.

Сохранение к файлу ролика

Вы сохраняете данные фильма к файлу с помощью AVCaptureMovieFileOutput объект. (AVCaptureMovieFileOutput конкретный подкласс AVCaptureFileOutput, который определяет большую часть основного поведения.) Можно сконфигурировать различные аспекты вывода файла ролика, такие как максимальная продолжительность записи или ее максимальный размер файла. Если существуют меньше, чем данная сумма оставленного дискового пространства, можно также запретить запись.

AVCaptureMovieFileOutput *aMovieFileOutput = [[AVCaptureMovieFileOutput alloc] init];

CMTime maxDuration = <#Create a CMTime to represent the maximum duration#>;

aMovieFileOutput.maxRecordedDuration = maxDuration;

aMovieFileOutput.minFreeDiskSpaceLimit = <#An appropriate minimum given the quality of the movie format and the duration#>;

Разрешение и скорость передачи для вывода зависят от сеанса получения sessionPreset. Видео кодированием обычно является H.264, и аудиокодированием обычно является AAC. Фактические значения варьируются устройством.

AVCaptureMovieFileOutput *aMovieFileOutput = <#Get a movie file output#>;

NSURL *fileURL = <#A file URL that identifies the output location#>;

[aMovieFileOutput startRecordingToOutputFileURL:fileURL recordingDelegate:<#The delegate#>];

- (void)captureOutput:(AVCaptureFileOutput *)captureOutput

        didFinishRecordingToOutputFileAtURL:(NSURL *)outputFileURL

        fromConnections:(NSArray *)connections

        error:(NSError *)error {

    BOOL recordedSuccessfully = YES;

    if ([error code] != noErr) {

        // A problem occurred: Find out if the recording was successful.

        id value = [[error userInfo] objectForKey:AVErrorRecordingSuccessfullyFinishedKey];

        if (value) {

            recordedSuccessfully = [value boolValue];

        }

    }

    // Continue as appropriate...

AVCaptureMovieFileOutput *aMovieFileOutput = <#Get a movie file output#>;

NSArray *existingMetadataArray = aMovieFileOutput.metadata;

NSMutableArray *newMetadataArray = nil;

if (existingMetadataArray) {

    newMetadataArray = [existingMetadataArray mutableCopy];

}

else {

    newMetadataArray = [[NSMutableArray alloc] init];

}

AVMutableMetadataItem *item = [[AVMutableMetadataItem alloc] init];

item.keySpace = AVMetadataKeySpaceCommon;

item.key = AVMetadataCommonKeyLocation;

CLLocation *location - <#The location to set#>;

item.value = [NSString stringWithFormat:@"%+08.4lf%+09.4lf/"

    location.coordinate.latitude, location.coordinate.longitude];

[newMetadataArray addObject:item];

aMovieFileOutput.metadata = newMetadataArray;

Обработка кадров видео

AVCaptureVideoDataOutput возразите делегации использования для продажи видеокадров. Вы устанавливаете делегата, использующего setSampleBufferDelegate:queue:. В дополнение к установке делегата Вы указываете последовательную очередь, на которую они вызываются методы делегата. Необходимо использовать последовательную очередь, чтобы гарантировать, что кадры поставлены делегату в надлежащем порядке. Можно использовать очередь для изменения приоритета, отданного поставке и обработке видеокадров. Посмотрите SquareCam для демонстрационной реализации.

Кадры представлены в методе делегата, captureOutput:didOutputSampleBuffer:fromConnection:, как экземпляры CMSampleBufferRef непрозрачный тип (см. Представления Носителей). По умолчанию буферы испускаются в самом эффективном формате камеры. Можно использовать videoSettings свойство для указания пользовательского выходного формата. Свойство параметров видео является словарем; в настоящее время единственный поддерживаемый ключ kCVPixelBufferPixelFormatTypeKey. Рекомендуемые форматы пикселя возвращаются availableVideoCVPixelFormatTypes свойство, и availableVideoCodecTypes свойство возвращает поддерживаемые значения. И Базовая Графика и OpenGL работают хорошо с BGRA формат:

AVCaptureVideoDataOutput *videoDataOutput = [AVCaptureVideoDataOutput new];

NSDictionary *newSettings =

                @{ (NSString *)kCVPixelBufferPixelFormatTypeKey : @(kCVPixelFormatType_32BGRA) };

videoDataOutput.videoSettings = newSettings;

 // discard if the data output queue is blocked (as we process the still image

[videoDataOutput setAlwaysDiscardsLateVideoFrames:YES];)

// create a serial dispatch queue used for the sample buffer delegate as well as when a still image is captured

// a serial dispatch queue must be used to guarantee that video frames will be delivered in order

// see the header doc for setSampleBufferDelegate:queue: for more information

videoDataOutputQueue = dispatch_queue_create("VideoDataOutputQueue", DISPATCH_QUEUE_SERIAL);

[videoDataOutput setSampleBufferDelegate:self queue:videoDataOutputQueue];

AVCaptureSession *captureSession = <#The Capture Session#>;

if ( [captureSession canAddOutput:videoDataOutput] )

     [captureSession addOutput:videoDataOutput];

Получение неподвижных изображений

Вы используете AVCaptureStillImageOutput вывод, если Вы хотите получить неподвижные изображения с сопроводительными метаданными. Разрешение изображения зависит от предварительной установки для сеанса, а также устройства.

AVCaptureStillImageOutput *stillImageOutput = [[AVCaptureStillImageOutput alloc] init];

NSDictionary *outputSettings = @{ AVVideoCodecKey : AVVideoCodecJPEG};

[stillImageOutput setOutputSettings:outputSettings];

AVCaptureConnection *videoConnection = nil;

for (AVCaptureConnection *connection in stillImageOutput.connections) {

    for (AVCaptureInputPort *port in [connection inputPorts]) {

        if ([[port mediaType] isEqual:AVMediaTypeVideo] ) {

            videoConnection = connection;

            break;

        }

    }

    if (videoConnection) { break; }

}

[stillImageOutput captureStillImageAsynchronouslyFromConnection:videoConnection completionHandler:

    ^(CMSampleBufferRef imageSampleBuffer, NSError *error) {

        CFDictionaryRef exifAttachments =

            CMGetAttachment(imageSampleBuffer, kCGImagePropertyExifDictionary, NULL);

        if (exifAttachments) {

            // Do something with the attachments.

        }

        // Continue as appropriate.

    }];

Предварительный просмотр видео

Можно предоставить пользователю предварительный просмотр того, что зарегистрировано с помощью AVCaptureVideoPreviewLayer объект. AVCaptureVideoPreviewLayer подклассCALayer (см. Базовое Руководство по программированию Анимации. Вам не нужны никакие выводы для показа предварительного просмотра.

Используя AVCaptureVideoDataOutput класс предоставляет клиентскому приложению возможность получить доступ к видео пикселям, прежде чем они будут представлены пользователю.

В отличие от вывода получения, уровень предварительного просмотра видео поддерживает сильную ссылку к сеансу, с которым он связан. Это должно гарантировать, что сеанс не освобожден, в то время как уровень пытается вывести на экран видео. Это отражается в способе, которым Вы инициализируете уровень предварительного просмотра:

AVCaptureSession *captureSession = <#Get a capture session#>;

CALayer *viewLayer = <#Get a layer from the view in which you want to present the preview#>;

AVCaptureVideoPreviewLayer *captureVideoPreviewLayer = [[AVCaptureVideoPreviewLayer alloc] initWithSession:captureSession];

[viewLayer addSublayer:captureVideoPreviewLayer];

В целом уровень предварительного просмотра ведет себя как любой другой CALayer объект в дереве рендеринга (см. Базовое Руководство по программированию Анимации). Можно масштабировать изображение и выполнить трансформации, вращения, и т.д. так же, как Вы были бы любой уровень. Одно различие - то, что Вы, возможно, должны установить уровень orientation свойство, чтобы указать, как это должно повернуть изображения, прибывающие из камеры. Кроме того, можно протестировать на поддержку устройства зеркального отражения видео путем запросов supportsVideoMirroring свойство. Можно установить videoMirrored свойство как требуется, несмотря на то, что, когда automaticallyAdjustsVideoMirroring свойство установлено в YES (значение по умолчанию), значение зеркального отражения автоматически установлено на основе конфигурации сеанса.

Показ уровней звука

Для контроля средних и пиковых уровней мощности в звуковом канале в соединении получения Вы используете AVCaptureAudioChannel объект. Уровни звука не являются заметным значением ключа, таким образом, необходимо опрашивать относительно обновленных уровней так часто, как Вы хотите обновить свой пользовательский интерфейс (например, 10 раз в секунду).

AVCaptureAudioDataOutput *audioDataOutput = <#Get the audio data output#>;

NSArray *connections = audioDataOutput.connections;

if ([connections count] > 0) {

    // There should be only one connection to an AVCaptureAudioDataOutput.

    AVCaptureConnection *connection = [connections objectAtIndex:0];

    NSArray *audioChannels = connection.audioChannels;

    for (AVCaptureAudioChannel *channel in audioChannels) {

        float avg = channel.averagePowerLevel;

        float peak = channel.peakHoldLevel;

        // Update the level meter user interface.

    }

}

Создайте и сконфигурируйте сеанс получения

Вы используете AVCaptureSession возразите для координирования потока данных от устройства ввода данных AV до вывода. Создайте сеанс и сконфигурируйте его для создания видеокадров среднего разрешения.

AVCaptureSession *session = [[AVCaptureSession alloc] init];

session.sessionPreset = AVCaptureSessionPresetMedium;

Создайте и сконфигурируйте ввод устройства и устройства

Устройства захвата изображения представлены AVCaptureDevice объекты; класс обеспечивает методы для получения объекта для входного типа, который Вы хотите. Устройство имеет один или несколько портов, сконфигурированное использование AVCaptureInput объект. Как правило, Вы используете ввод получения в его конфигурации по умолчанию.

Найдите устройство видеосъемки, затем создайте ввод устройства с устройством и добавьте его к сеансу. Если надлежащее устройство не может быть расположено, то deviceInputWithDevice:error: метод возвратит ошибку ссылкой.

AVCaptureDevice *device =

        [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];

NSError *error = nil;

AVCaptureDeviceInput *input =

        [AVCaptureDeviceInput deviceInputWithDevice:device error:&error];

if (!input) {

    // Handle the error appropriately.

}

[session addInput:input];

Создайте и сконфигурируйте вывод видеоданных

Вы используете AVCaptureVideoDataOutput объект обработать несжатые кадры от получаемого видео. Вы обычно конфигурируете несколько аспектов вывода. Для видео, например, можно указать формат пикселя с помощью videoSettings свойство и прописная буква частота кадров путем установки minFrameDuration свойство.

Создайте и сконфигурируйте вывод для видеоданных и добавьте его к сеансу; ограничьте частоту кадров к 15 кадр/с путем установки minFrameDuration свойство к 1/15 секунде:

AVCaptureVideoDataOutput *output = [[AVCaptureVideoDataOutput alloc] init];

[session addOutput:output];

output.videoSettings =

                @{ (NSString *)kCVPixelBufferPixelFormatTypeKey : @(kCVPixelFormatType_32BGRA) };

output.minFrameDuration = CMTimeMake(1, 15);

Объект вывода данных использует делегацию для продажи видеокадров. Делегат должен принять AVCaptureVideoDataOutputSampleBufferDelegate протокол. При установке делегата вывода данных необходимо также предоставить очереди, на которую должны быть вызваны обратные вызовы.

dispatch_queue_t queue = dispatch_queue_create("MyQueue", NULL);

[output setSampleBufferDelegate:self queue:queue];

dispatch_release(queue);

Вы используете очередь для изменения приоритета, отданного поставке и обработке видеокадров.

Реализуйте демонстрационный буферный метод делегата

В классе делегата реализуйте метод (captureOutput:didOutputSampleBuffer:fromConnection:) когда демонстрационный буфер записан, это вызывают. Выходной объект видеоданных поставляет кадры как CMSampleBuffer непрозрачные типы, таким образом, необходимо преобразовать из CMSampleBuffer непрозрачный тип к a UIImage объект. Функция для этой работы показана в Преобразовании CMSampleBuffer к Объекту UIImage.

- (void)captureOutput:(AVCaptureOutput *)captureOutput

         didOutputSampleBuffer:(CMSampleBufferRef)sampleBuffer

         fromConnection:(AVCaptureConnection *)connection {

    UIImage *image = imageFromSampleBuffer(sampleBuffer);

    // Add your code here that uses the image.

}

Помните, что метод делегата вызывается на очередь, в которой Вы указали setSampleBufferDelegate:queue:; если Вы хотите обновить пользовательский интерфейс, необходимо вызвать любой соответствующий код основного потока.

Запуск и остановка записи

После конфигурирования сеанса получения необходимо гарантировать, что камера имеет разрешение записать согласно предпочтениям пользователя.

NSString *mediaType = AVMediaTypeVideo;

[AVCaptureDevice requestAccessForMediaType:mediaType completionHandler:^(BOOL granted) {

    if (granted)

    {

        //Granted access to mediaType

        [self setDeviceAuthorized:YES];

    }

    else

    {

        //Not granted access to mediaType

        dispatch_async(dispatch_get_main_queue(), ^{

        [[[UIAlertView alloc] initWithTitle:@"AVCam!"

                                    message:@"AVCam doesn't have permission to use Camera, please change privacy settings"

                                   delegate:self

                          cancelButtonTitle:@"OK"

                          otherButtonTitles:nil] show];

                [self setDeviceAuthorized:NO];

        });

    }

}];

Если сеанс камеры сконфигурирован, и пользователь утвердил доступ к камере (и при необходимости, микрофон), отправьте a startRunning обменивайтесь сообщениями для запуска записи.

[session startRunning];

Чтобы прекратить записывать, Вы отправляете сеанс a stopRunning сообщение.

Воспроизведение

Экземпляр AVPlayer управляет большей частью скорости воспроизведения автоматически путем установки setRate: значение метода. Значение используется в качестве множителя для скорости воспроизведения. Значение 1,0 причин, которые нормальное воспроизведение, 0.5 воспроизводит на половине скорости, 5.0, воспроизводит в пять раз быстрее, чем нормальный и т.д.

AVPlayerItem поддержка объектов audioTimePitchAlgorithm свойство. Это свойство позволяет Вам указывать, как аудио играется, когда фильм проигрывается в различных частотах кадров с помощью Time Pitch Algorithm Settings константы.

Следующая таблица показывает поддерживаемые алгоритмы подачи времени, качество, заставляет ли алгоритм аудио хватать к определенным частотам кадров и диапазону частоты кадров, который поддерживает каждый алгоритм.

Редактирование

При редактировании Вы используете AVMutableComposition класс для создания временных редактирований.

• Создайте новое AVMutableComposition экземпляр с помощью composition метод класса.

• Вставьте свой видео актив с помощью insertTimeRange:ofAsset:atTime:error: метод.

• Установите масштаб времени части использования состава scaleTimeRange:toDuration:

Экспорт

Экспорт видео на 60 кадр/с использует AVAssetExportSession класс для экспорта актива. Содержание может быть экспортировано с помощью двух методов:

• Используйте AVAssetExportPresetPassthrough предварительная установка, чтобы избежать повторно кодировать фильм. Это повторно синхронизирует носители с разделами носителей, тегированных как раздел 60 кадр/с, раздел, замедленный или ускоренный раздел.

• Используйте постоянный экспорт частоты кадров для максимальной совместимости воспроизведения. Установите frameDuration свойство видео состава к 30 кадр/с. Можно также указать подачу времени при помощи установки сеанса экспорта audioTimePitchAlgorithm свойство.

Запись

Вы получаете видео высокой частоты кадров использование AVCaptureMovieFileOutput класс, автоматически поддерживающий запись высокой частоты кадров. Это автоматически выберет корректный уровень тона H264 и скорость передачи.

Чтобы сделать пользовательскую запись, необходимо использовать AVAssetWriter класс, требующий некоторой дополнительной установки.

assetWriterInput.expectsMediaDataInRealTime=YES;

Эта установка гарантирует, что получение может не отставать от входящих данных.