Постановка задачи
Необходимо обеспечить пользователю возможность записи видео со своего устройства с системой 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//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. Сохранение видео в библиотеке фотографий