Quicklook,iOS项目集成文档查看功能

前言

现在的工作所担当的项目,是在一家教育公司,为学校做一款云盘软件,老师们会上传很多office文档到云盘中,安卓客户端是没有集成app内查看文档的,打开文档需要分享到其他app中查看,比如wps等等,这样就增加了操作的繁琐,所以我在使用其他第三方app查看的基础上,又加入了app内Quicklook功能。

使用

首先,引入
其实说白了,Quicklook只是提供了文档的预览功能,从controller的名称就可以看出。

我们只使用QuicklookController的view,所以将QLPreviewController设置为属性

/**  QuickLook预览页面  */
@property(nonatomic,strong)  QLPreviewController  *previewController;

在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];

需要用到的代理为
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;
}

当然在解码方面,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;
    }
}

总结

这样,就简单的实现了app内文档的查看,当然在文件兼容方面上,还是存在一点问题的,某些DOC文档可能会无法浏览,这时可以通过第三方应用打开的方式来进行查看。
Quicklook支持的文件格式很多,正常的文档类文件都可以查看,同时mp3,mp4,jpg等音频、视频、图片的查看也不在话下,使用起来也比较简单,代理方法跟UITableView比较像

你可能感兴趣的:(Quicklook,iOS项目集成文档查看功能)