iOS 两种预览使用详解（配Demo下载）（ Quicklook& UIDocumentInteractionController）

版权声明：本文为博主原创文章，转载请附上本文链接地址。from : https://blog.csdn.net/lovechris00 https://blog.csdn.net/lovechris00/article/details/71083047

---

#一、 Demo下载地址

1、QuickLook Demo下载地址
http://download.csdn.net/detail/lovechris00/9831357

demo说明：本demo主要展示了以下类型：

1. pdf
2. jpg
3. gif
4. ppt
5. doc
6. mp4
7. 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 的区别

1. QLPreviewController是真正的控制器。QLPreviewController继承自NSObject。
2. QLPreviewController可以一起浏览多个文件，而UIDocumentInteractionController一次只能浏览一个文件。
3. UIDocumentInteractionController使用捏合手势可以最小化。

参考资料

1.Quicklook，iOS项目集成文档查看功能

2.使用UIDocumentInteractionController和QLPreviewController预览文件