您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

用 QuickLook 框架在 iOS 中預覽 PDF、Word、PPT、Excel

編輯:iOS 開發綜合

要在 App 裡預覽 Office 文件與 PDF,不必自己寫解析器,也沒必要為每種格式各刻一個檢視器。iOS 內建的 QuickLook 框架已經把這件事包好了,只要幾個 delegate 方法就能上線。

標頭檔

#import <UIKit/UIKit.h>
#import <QuickLook/QuickLook.h>

@interface ViewController : UIViewController
<QLPreviewControllerDataSource, QLPreviewControllerDelegate, UIDocumentInteractionControllerDelegate>

@property (strong, nonatomic) QLPreviewController *previewController;

@end

實作檔

#import "ViewController.h"

@interface ViewController ()
@property (strong, nonatomic) NSArray *dirArray;
@property (strong, nonatomic) UIDocumentInteractionController *docInteractionController;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsPath = [paths objectAtIndex:0];

    // 從 App Bundle 取一份範例文件,複製到 Documents 目錄
    NSString *pathPPT = [[NSBundle mainBundle] pathForResource:@"C" ofType:@"pdf"];
    NSData *pptData = [NSData dataWithContentsOfFile:pathPPT];
    NSString *filePath = [documentsPath stringByAppendingPathComponent:@"C1.pdf"];
    [pptData writeToFile:filePath atomically:YES];

    NSFileManager *fileManager = [NSFileManager defaultManager];
    self.dirArray = [fileManager contentsOfDirectoryAtPath:documentsPath error:nil];
    NSLog(@"%@", self.dirArray);

    self.view.backgroundColor = [UIColor redColor];

    self.previewController = [[QLPreviewController alloc] init];
    self.previewController.view.backgroundColor = [UIColor grayColor];
    self.previewController.dataSource = self;
    self.previewController.delegate = self;
    self.previewController.currentPreviewItemIndex = 0;

    [self presentViewController:self.previewController animated:YES completion:^{
        [self.view addSubview:self.previewController.view];
    }];
    [self.view addSubview:self.previewController.view];
}

#pragma mark - QLPreviewControllerDataSource

// 可預覽的項目數量
- (NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController *)controller {
    return [self.dirArray count];
}

// 回傳指定索引的預覽項目,需為符合 QLPreviewItem 協議的物件(NSURL 即可)
- (id<QLPreviewItem>)previewController:(QLPreviewController *)controller previewItemAtIndex:(NSInteger)index {
    NSArray *documentPaths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentDir = [documentPaths objectAtIndex:0];
    NSString *name = [self.dirArray objectAtIndex:index];
    NSString *path = [documentDir stringByAppendingPathComponent:name];
    return [NSURL fileURLWithPath:path];
}

- (void)previewControllerDidDismiss:(QLPreviewController *)controller {
    // 使用者關閉預覽時的收尾處理
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
}

@end

幾個實務重點

  • 不支援的格式會開啟失敗。QuickLook 支援 PDF、Office 系列、圖片、純文字、iWork 等常見格式,但遇到冷門格式會直接顯示「無法預覽」。若需要更完整的相容性,可以搭配 UIDocumentInteractionController 叫出系統的「用其他 App 開啟」面板,把檔案丟給已安裝的第三方檢視器。
  • 路徑必須是 file URL。previewItemAtIndex: 要回傳的是符合 QLPreviewItem 協議的物件,最常用的是 NSURL;如果傳入的是 NSURL 但用 URLWithString: 產生了非 file scheme,一樣會預覽失敗。
  • 記得替 title 客製化。預覽頁頂端顯示的名稱取自檔案 URL 的最後一段,檔名有中文或特殊字元時建議先處理編碼。
  • Delegate 是選用的,但實作 previewControllerDidDismiss: 有助於釋放快取、記錄使用者閱讀行為。

整體來說,QuickLook 用不到三十行就能換來一個支援十餘種格式的文件檢視器,是 iOS 開發裡性價比相當高的一套 API。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved