Текст книги "iOS. Приемы программирования"

13.2. Фотографирование с помощью камеры

Постановка задачи

Требуется попросить пользователя сделать снимок (фотография выполняется камерой устройства). После того как пользователь сделает снимок, необходимо получить доступ к этой фотографии.

Решение

Инстанцируйте объект типа UIImagePickerController и представьте его пользователю как модальный вид в актуальном контроллере вида. Вот объявление этого контроллера вида:

#import «ViewController.h»

#import <MobileCoreServices/MobileCoreServices.h>

@interface ViewController ()<UIImagePickerControllerDelegate,

UINavigationControllerDelegate>

@end

@implementation ViewController

<# Остаток вашего кода находится здесь #>

Делегат экземпляра UIImagePickerController должен соответствовать протоколам UINavigationControllerDelegate и UIImagePickerControllerDelegate. Если вы забудете включить их в. h-файл вашего объекта-делегата, то будете получать предупреждения от компилятора при присвоении значения делегатному свойству контроллера для выбора изображений. Не забывайте, что вы можете присваивать делегату объект экземпляра UIImagePickerController и в том случае, если данный объект не соответствует явно протоколам UIImagePickerControllerDelegate и UINavigationControllerDelegate, но реализует методы, необходимые в этих протоколах. Тем не менее я советую «подсказывать» компилятору, что фактически объект-делегат соответствует вышеупомянутым протоколам, – так вы избавитесь от лишних предупреждений компилятора.

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

– (void)viewDidAppear:(BOOL)animated{

[super viewDidAppear: animated];

static BOOL beenHereBefore = NO;

if (beenHereBefore){

/* Отображаем элемент для выбора даты только после того, как вызывается

метод viewDidAppear:, что происходит при каждом отображении вида

нашего контроллера вида */

return;

} else {

beenHereBefore = YES;

}

if ([self isCameraAvailable] &&

[self doesCameraSupportTakingPhotos]){

UIImagePickerController *controller =

[[UIImagePickerController alloc] init];

controller.sourceType = UIImagePickerControllerSourceTypeCamera;

NSString *requiredMediaType = (__bridge NSString *)kUTTypeImage;

controller.mediaTypes = [[NSArray alloc]

initWithObjects: requiredMediaType, nil];

controller.allowsEditing = YES;

controller.delegate = self;

[self.navigationController presentModalViewController: controller

animated: YES];

} else {

NSLog(@"Camera is not available.");

}

}

В этом примере пользуемся методами isCameraAvailable и doesCameraSupportTakingPhotos. Эти методы реализованы и подробно рассмотрены в разделе 13.1.

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

– (void) imagePickerController:(UIImagePickerController *)picker

didFinishPickingMediaWithInfo:(NSDictionary *)info{

NSLog(@"Picker returned successfully.");

NSLog(@"%@", info);

NSString *mediaType = [info objectForKey:

UIImagePickerControllerMediaType];

if ([mediaType isEqualToString:(__bridge NSString *)kUTTypeMovie]){

NSURL *urlOfVideo =

[info objectForKey: UIImagePickerControllerMediaURL];

NSLog(@"Video URL = %@", urlOfVideo);

}

else if ([mediaType isEqualToString:(__bridge NSString *)kUTTypeImage]){

/* Получим метаданные. Это касается

только изображений, но не видеороликов. */

NSDictionary *metadata =

[info objectForKey:

UIImagePickerControllerMediaMetadata];

UIImage *theImage =

[info objectForKey:

UIImagePickerControllerOriginalImage];

NSLog(@"Image Metadata = %@", metadata);

NSLog(@"Image = %@", theImage);

}

[picker dismissModalViewControllerAnimated: YES];

}

– (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker{

NSLog(@"Picker was cancelled");

[picker dismissModalViewControllerAnimated: YES];

}

Обсуждение

При работе с делегатом инструмента для выбора изображений необходимо учитывать пару немаловажных аспектов. Два делегатных метода вызываются у объекта-делегата контроллера для выбора изображений. Метод imagePickerController: didFinishPickingMediaWithInfo: вызывается, когда пользователь завершает работу с инструментом выбора изображений (то есть делает снимок и наконец нажимает кнопку). В свою очередь, метод imagePickerControllerDidCancel: вызывается в случае, когда операция с инструментом выбора изображений отменяется.

Кроме того, метод делегата imagePickerController: didFinishPickingMediaWithInfo: содержит данные о том предмете, который был отснят пользователем, независимо от того, изображение это или видеоданные. Параметр didFinishPickingMediaWithInfo – это словарь значений, сообщающий, что именно было отснято в инструменте выбора изображений плюс метаданные отснятого контента и другую полезную информацию. Работу в этом методе следует начать со считывания значения ключа UIImagePickerControllerMediaType из этого словаря. Объект для данного ключа представляет собой экземпляр NSString и может принимать одно из следующих значений:

• kUTTypeImage – фотография, сделанная камерой;

• kUTTypeMovie – видеоролик, отснятый камерой.

Значения kUTTypeImage и kUTTypeMovie доступны во фреймворке Mobile Core Services и относятся к типу CFStringRef. При необходимости можно просто привести тип этих значений к NSString.

Определив тип ресурса, созданного камерой (то есть узнав, идет речь о фотографии или видеоролике), можно получить доступ к свойствам этого ресурса, вновь воспользовавшись параметром словаря didFinishPickingMediaWithInfo.

При работе с изображениями (kUTTypeImage) можно получить доступ к следующим ключам:

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

• UIImagePickerControllerOriginalImage – объектом, хранимым по этому ключу, является объект типа UIImage. В нем содержится изображение, отснятое пользователем;

• UIImagePickerControllerCropRect – если вы активизировали возможность редактирования (с помощью свойства allowsEditing объекта UIImagePickerController), то в объекте этого ключа будет содержаться прямоугольник, по которому была сделана обрезка;

• UIImagePickerControllerEditedImage – если вы активизировали возможность редактирования (с помощью свойства allowsEditing объекта UIImagePickerController), то в значении этого ключа будет содержаться отредактированное изображение (масштабированное, с измененными размерами).

Для видеороликов (kUTTypeMovie), отснятых пользователем, можно получать доступ к ключу UIImagePickerControllerMediaURL в параметре словаря didFinishPickingMediaWithInfo в методе imagePickerController: didFinishPickingMediaWithInfo:. Значение этого ключа представляет собой объект типа NSURL, содержащий URL видеоролика, отснятого пользователем.

После того как вы получите ссылку на экземпляр UIImage, отснятый пользователем с помощью камеры, можете просто начинать использовать этот экземпляр в своем приложении.

Фотографии, снятые внутри приложения с помощью инструмента для выбора изображений, по умолчанию не сохраняются в каталоге для снимков фотокамеры (Camera Roll).

См. также

Раздел 13.1.

13.3. Запись видео с помощью камеры

Постановка задачи

Необходимо обеспечить пользователю возможность записи видео со своего устройства с системой iOS. Кроме того, вы сами должны иметь возможность применять это видео в своем приложении.

Решение

Воспользуйтесь объектом UIImagePickerController с источником типа UIImagePickerControllerSourceTypeCamera и медийной информацией типа kUTTypeMovie:

– (void)viewDidAppear:(BOOL)animated{

[super viewDidAppear: animated];

static BOOL beenHereBefore = NO;

if (beenHereBefore){

/* Отображаем элемент для выбора даты только после того, как вызывается

метод viewDidAppear:, что происходит при каждом отображении вида

нашего контроллера вида */

return;

} else {

beenHereBefore = YES;

}

if ([self isCameraAvailable] &&

[self doesCameraSupportTakingPhotos]){

UIImagePickerController *controller =

[[UIImagePickerController alloc] init];

controller.sourceType = UIImagePickerControllerSourceTypeCamera;

controller.mediaTypes = @[(__bridge NSString *)kUTTypeMovie];

controller.allowsEditing = YES;

controller.delegate = self;

[self.navigationController presentModalViewController: controller

animated: YES];

} else {

NSLog(@"Camera is not available.");

}

}

Методы isCameraAvailable и doesCameraSupportShootingVideos, использованные в данном примере, реализованы и обсуждены в разделе 13.1.

Вот как мы реализуем методы делегата инструмента для выбора изображений:

– (void) imagePickerController:(UIImagePickerController *)picker

didFinishPickingMediaWithInfo:(NSDictionary *)info{

NSLog(@"Picker returned successfully.");

NSLog(@"%@", info);

NSString *mediaType = [info objectForKey:

UIImagePickerControllerMediaType];

if ([mediaType isEqualToString:(__bridge NSString *)kUTTypeMovie]){

NSURL *urlOfVideo =

[info objectForKey: UIImagePickerControllerMediaURL];

NSLog(@"Video URL = %@", urlOfVideo);

NSError *dataReadingError = nil;

NSData *videoData =

[NSData dataWithContentsOfURL: urlOfVideo

options: NSDataReadingMapped

error:&dataReadingError];

if (videoData!= nil){

/* Нам удалось считать данные. */

NSLog(@"Successfully loaded the data.");

} else {

/* Нам не удалось считать данные. Используем переменную

dataReadingError, чтобы определить, в чем заключается ошибка. */

NSLog(@"Failed to load the data with error = %@",

dataReadingError);

}

}

[picker dismissModalViewControllerAnimated: YES];

}

– (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker{

NSLog(@"Picker was cancelled");

[picker dismissModalViewControllerAnimated: YES];

}

Обсуждение

Как только вы обнаружите, что устройство с системой iOS, на котором работает ваше приложение, поддерживает запись видео, можно открыть инструмент для выбора изображений с типом источника UIImagePickerControllerSourceTypeCamera и типом медийной информации kUTTypeMovie, чтобы пользователь вашего приложения мог снимать видео. Как только съемка будет закончена, будет вызван метод делегата imagePickerController: didFinishPickingMediaWithInfo: и вы сможете использовать параметр словаря didFinishPickingMediaWithInfo, чтобы узнать более подробную информацию об отснятом видео. (Значения, которые могут быть размещены в таком словаре, подробно рассмотрены в разделе 13.2.)

Когда пользователь записывает видео, работая при этом с инструментом для выбора изображений, это видео будет сохраняться во временной папке в пакете вашего приложения, а не в каталоге для снимков камеры на устройстве (то есть не в Camera Roll). Пример такого URL: file://localhost/private/var/mobile/Applications/<APPID>/tmp/captureT0x104e20.tmp.TQ9UTr/capturedvideo.MOV.

Значение APPID в этом URL будет представлять уникальный идентификатор вашего приложения. Разумеется, оно будет специфичным в каждой конкретной программе.

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

• videoQuality – характеризует качество записываемого видео. Для данного свойства можно выбрать, например, значение UIImagePickerControllerQualityTypeHigh или UIImagePickerControllerQualityTypeMedium;

• videoMaximumDuration – указывает максимальную длительность видео. Это значение измеряется в секундах.

Например, если мы предоставляем пользователю возможность записывать высококачественное видео длительностью до 30 секунд, то можем просто изменить значения вышеупомянутых свойств экземпляра UIImagePickerController:

– (void)viewDidAppear:(BOOL)animated{

[super viewDidAppear: animated];

static BOOL beenHereBefore = NO;

if (beenHereBefore){

/* Отображаем элемент для выбора даты только после того, как вызывается

метод viewDidAppear:, что происходит при каждом отображении вида

нашего контроллера вида */

return;

} else {

beenHereBefore = YES;

}

if ([self isCameraAvailable] &&

[self doesCameraSupportTakingPhotos]){

UIImagePickerController *controller =

[[UIImagePickerController alloc] init];

controller.sourceType = UIImagePickerControllerSourceTypeCamera;

controller.mediaTypes = @[(__bridge NSString *)kUTTypeMovie];

controller.allowsEditing = YES;

controller.delegate = self;

/* Записываем видео в высоком качестве. */

controller.videoQuality = UIImagePickerControllerQualityTypeHigh;

/* Позволяем записать только 30 секунд видео. */

controller.videoMaximumDuration = 30.0f;

[self.navigationController presentModalViewController: controller

animated: YES];

} else {

NSLog(@"Camera is not available.");

}

}

См. также

Раздел 13.1.

13.4. Сохранение снимков в библиотеке фотографий

Постановка задачи

Необходимо обеспечить возможность сохранения снимков в пользовательской библиотеке фотографий.

Решение

Воспользуйтесь процедурой UIImageWriteToSavedPhotosAlbum:

– (void) imageWasSavedSuccessfully:(UIImage *)paramImage

didFinishSavingWithError:(NSError *)paramError

contextInfo:(void *)paramContextInfo{

if (paramError == nil){

NSLog(@"Image was saved successfully.");

} else {

NSLog(@"An error happened while saving the image.");

NSLog(@"Error = %@", paramError);

}

}

– (void) imagePickerController:(UIImagePickerController *)picker

didFinishPickingMediaWithInfo:(NSDictionary *)info{

NSLog(@"Picker returned successfully.");

NSLog(@"%@", info);

NSString *mediaType = [info objectForKey:

UIImagePickerControllerMediaType];

if ([mediaType isEqualToString:(__bridge NSString *)kUTTypeImage]){

UIImage *theImage = nil;

if ([picker allowsEditing]){

theImage = [info objectForKey: UIImagePickerControllerEditedImage];

} else {

theImage = [info objectForKey: UIImagePickerControllerOriginalImage];

}

SEL selectorToCall = @selector(imageWasSavedSuccessfully:

didFinishSavingWithError: contextInfo:);

UIImageWriteToSavedPhotosAlbum(theImage,

self,

selectorToCall,

NULL);

}

[picker dismissModalViewControllerAnimated: YES];

}

– (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker{

NSLog(@"Picker was cancelled");

[picker dismissModalViewControllerAnimated: YES];

}

– (void)viewDidAppear:(BOOL)animated{

[super viewDidAppear: animated];

static BOOL beenHereBefore = NO;

if (beenHereBefore){

/* Отображаем элемент для выбора даты только после того, как вызывается

метод viewDidAppear:, что происходит при каждом отображении вида

нашего контроллера вида */

return;

} else {

beenHereBefore = YES;

}

if ([self isCameraAvailable] &&

[self doesCameraSupportTakingPhotos]){

UIImagePickerController *controller =

[[UIImagePickerController alloc] init];

controller.sourceType = UIImagePickerControllerSourceTypeCamera;

NSString *requiredMediaType = (__bridge NSString *)kUTTypeImage;

controller.mediaTypes = [[NSArray alloc]

initWithObjects: requiredMediaType, nil];

controller.allowsEditing = YES;

controller.delegate = self;

[self.navigationController presentModalViewController: controller

animated: YES];

} else {

NSLog(@"Camera is not available.");

}

}

Методы isCameraAvailable и doesCameraSupportTakingPhotos, использованные в данном примере, подробно рассмотрены в разделе 13.1.

Обсуждение

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

Но если вы решите, что хотите сохранить экземпляр UIImage в библиотеке фотографий на пользовательском устройстве, то можете применить функцию UIImageWriteToSavedPhotosAlbum. Она принимает четыре параметра:

• изображение;

• объект, который станет получать уведомления всякий раз, когда изображение будет полностью сохранено;

• параметр, указывающий селектор (этот селектор будет вызываться применительно к целевому объекту). Данный параметр идет вторым, а селектор вызывается по завершении операции;

• значение контекста, передаваемое указанному селектору, как только операция будет завершена.

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

– (void) imageWasSavedSuccessfully:(UIImage *)paramImage

didFinishSavingWithError:(NSError *)paramError

contextInfo:(void *)paramContextInfo{

if (paramError == nil){

NSLog(@"Image was saved successfully.");

} else {

NSLog(@"An error happened while saving the image.");

NSLog(@"Error = %@", paramError);

}

}

Если вы попытаетесь воспользоваться процедурой UIImageWriteToSavedPhotosAlbum для сохранения фотоснимка в пользовательской библиотеке фотографий и приложение впервые выполняет эту операцию на данном устройстве, то iOS запросит у пользователя разрешение на такую операцию (рис. 13.1). Таким образом, пользователь может позволить или не позволить приложению сохранять фотографии на устройстве. В конце концов, это пользовательское устройство и мы не можем делать на этом устройстве ничего такого, чего нам не разрешил пользователь. Если пользователь дает разрешение, то процедура UIImageWriteToSavedPhotosAlbum продолжит сохранение изображения. Если разрешение не получено, то селектор обработчика завершения по-прежнему будет вызываться, но параметр didFinishSavingWithError этого селектора будет устанавливаться в валидный экземпляр ошибки.

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

Теперь, если пользователь отказывает приложению в праве доступа, все последующие вызовы процедуры UIImageWriteToSavedPhotosAlbum будут неуспешными, пока пользователь вручную не изменит настройки своего устройства (рис. 13.2).

Рис. 13.2. Приложению не разрешен доступ к пользовательской библиотеке фотографий

Если в данном селекторе вы получаете параметр error, значение которого равно nil, это означает, что изображение было успешно сохранено в пользовательской библиотеке фотографий. В противном случае можно получить значение данного параметра, чтобы выяснить, в чем заключается ошибка.

13.5. Сохранение видео в библиотеке фотографий

Постановка задачи

Требуется сохранить в библиотеке фотографий видеоролик, доступный по URL, например ролик из пакета вашего приложения.

Решение

Воспользуйтесь методом экземпляра writeVideoAtPathToSavedPhotosAlbum: completionBlock:, относящимся к классу ALAssetsLibrary:

#import «AppDelegate.h»

#import <AssetsLibrary/AssetsLibrary.h>

@interface AppDelegate ()

@property (nonatomic, strong) ALAssetsLibrary *assetsLibrary;

@end

@implementation AppDelegate

– (BOOL) application:(UIApplication *)application

didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{

self.assetsLibrary = [[ALAssetsLibrary alloc] init];

NSURL *videoURL = [[NSBundle mainBundle] URLForResource:@"MyVideo"

withExtension:@"MOV"];

if (videoURL!= nil){

[self.assetsLibrary

writeVideoAtPathToSavedPhotosAlbum: videoURL

completionBlock: ^(NSURL *assetURL, NSError *error) {

if (error == nil){

NSLog(@"no errors happened");

} else {

NSLog(@"Error happened while saving the video.");

NSLog(@"The error is = %@", error);

}

}];

} else {

NSLog(@"Could not find the video in the app bundle.");

}

return YES;

}