文章目录
#一、 Demo下载地址
1、QuickLook Demo下载地址
http://download.csdn.net/detail/lovechris00/9831357
demo说明:本demo主要展示了以下类型:
- jpg
- gif
- ppt
- doc
- mp4
- mp3
demo代码部分少,资源占用量较大。
2、 iOS 两种预览下载地址
介绍使用 UIDocumentInteractionController QLPreviewController 两种预览方式,方便学习者清晰看到区别。
二、 使用
1. 首先,引入框架
<Quicklook/Quicklook.h>
2. 将QLPreviewController设置为属性
其实说白了,Quicklook只是提供了文档的预览功能,从controller的名称就可以看出。
我们只使用QuicklookController的view,所以将QLPreviewController设置为属性
/** QuickLook预览页面 */
@property(nonatomic,strong) QLPreviewController *previewController;
3. 初始化
在viewDidLoad中初始化就可以
self.previewController = [[QSQLPreviewController alloc] init];
/** 这里我们要使用QLPreviewController的代理方法 */
self.previewController.dataSource = self;
self.previewController.delegate = self;
self.previewController.view.frame = self.view.frame;
/** 这里需要注意的是,我们不使用Controller,而是使用Controller的View,为的是避免QLController在Navgation等Controller中带来的坑 */
[self.view addSubview:self.previewController.view];
4. 设置代理和数据源
需要用到的代理为
QLPreviewControllerDataSource,QLPreviewControllerDelegate
实现代理方法,指定QLController访问的本地文件地址就可以。
这里返回的QLController中包含的文档数量,如果想设置左右滑动切换其他文档,可以设置为大于1
(NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController*)previewController {
return 1;
}
这里返回Controller所包含的每个文档的链接(本地),上面的方法设置了1,所以这里我们只返回一个链接,这里我为当前Controller设置了一个外部可以传进来的参数,就是要浏览的文档的地址,返回给QLController就可以了,想访问多个文档,可以为当前Controller设置一个数据源Array,里面放入文档的链接,这个用idx作为下标取出来,返回就可以,记得上面的方法返回数据源的个数
-(id)previewController:(QLPreviewController*)previewController previewItemAtIndex:(NSInteger)idx {
NSURL *fileURL = nil;
fileURL = [NSURL fileURLWithPath:self.path];
return fileURL;
}
5. 编码问题
当然在解码方面,QLController存在一点问题,打开txt格式文件时,一些windows上编辑的文档中的中文,可能会出现乱码现象,在上面方法中可以通过如下方式来进行文件编码的修改
- (id)previewController:(QLPreviewController *)previewController previewItemAtIndex:(NSInteger)idx {
if ([self.path hasSuffix:@"txt"] || [self.path hasSuffix:@"TXT"]) {
// 处理txt格式内容显示有乱码的情况
NSData *fileData = [NSData dataWithContentsOfFile:self.path];
// 判断是UNICODE编码
NSString *isUNICODE = [[NSString alloc] initWithData:fileData encoding:NSUTF8StringEncoding];
// 还是ANSI编码(-2147483623,-2147482591,-2147482062,-2147481296)encoding 任选一个就可以了
NSString *isANSI = [[NSString alloc] initWithData:fileData encoding:-2147483623];
if (isUNICODE) {
} else {
NSData *data = [isANSI dataUsingEncoding:NSUTF8StringEncoding];
[data writeToFile:self.path atomically:YES];
}
return [NSURL fileURLWithPath:self.path];
} else {
NSURL *fileURL = nil;
fileURL = [NSURL fileURLWithPath:self.path];
return fileURL;
}
}
个人小结
QLPreviewController使用细节
-
多页的pdf文件,会自动呈现页码;多页的ppt文件,不会自动出现页码;
-
音乐和视频点击播放时,会出现音频时间,过两秒就会消失;
-
滑动预览其他文件时,音频视频都会停止;
-
音乐预览点击可以暂停,视频无法暂停;
-
所有文本文件、视频都可以拖拽放大查看。
-
使用导航push的方式,无法实现预览功能;只能用modal的方式来展示。
[self.navigationController pushViewController:VC animated:YES];
--无效[self presentViewController:VC animated:YES completion:nil];
–有效
UIDocumentInteractionController
presentOptionsMenuFromRect 和 presentOpenInMenuFromRect 的区别
//显示不包含预览菜单项
[_documentController presentOpenInMenuFromRect:btn.frame inView:self.view animated:YES];
//显示包含预览的菜单项
[_documentController presentOptionsMenuFromRect:btn.frame inView:self.view animated:YES];
下面的按钮,建议多点击测试,防止崩溃。
QLPreviewController 和UIDocumentInteractionController 的区别
- QLPreviewController是真正的控制器。QLPreviewController继承自NSObject。
- QLPreviewController可以一起浏览多个文件,而UIDocumentInteractionController一次只能浏览一个文件。
- UIDocumentInteractionController使用捏合手势可以最小化。