一、引言

Quick Look技术是Apple在Mac OS X 10.5中引入的一种用于快速查看文件内容的技术。用户只需要选中文件单击空格键即可快速查看文件内容,可以在不打开文件的情况下快速浏览内容。公司是做全景视频开发的,具备自己的全景视频文件格式。因此,做一款针对自有视频格式的QuickLook插件显得非常有必要。QuickLook的技术资料非常丰富,不仅官方有着详尽的文档,互联网上也有不少开发者总结的开发经验。即便如此,在开发的过程中也碰到了不少的坑,如今总结在此。最终的QuickLook效果如下所示:

     

二、着手开发

QuickLook插件是Apple官方推出的一项技术,在XCode中可以直接创建QuickLook Plugins模板工程:

创建的模板工程中包含三个源文件:GenerateThumbnailForURL.c, GeneratePreviewForURL.c, main.c。其作用可顾名思义,不过我们只要修改前面两个文件就可以了。至于main.c文件,官方是不推荐我们去修改的。GenerateThumbnailForURL.c用于生成缩略图,如下是一种模板实现:

OSStatus GenerateThumbnailForURL(void *thisInterface, QLThumbnailRequestRef thumbnail, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options, CGSize maxSize)
{@autoreleasepool{// Get the UTI propertiesNSDictionary* uti_declarations = (__bridge_transfer NSDictionary*)UTTypeCopyDeclaration(contentTypeUTI);// Get the extensions corresponding to the image UTI, for some UTI there can be more than 1 extension (ex image.jpeg = jpeg, jpg...)// If it fails for whatever reason fallback to the filename extensionid extensions = uti_declarations[(__bridge NSString*)kUTTypeTagSpecificationKey][(__bridge NSString*)kUTTagClassFilenameExtension];NSString* extension = ([extensions isKindOfClass:[NSArray class]]) ? extensions[0] : extensions;if (nil == extension)extension = ([(__bridge NSURL*)url pathExtension] != nil) ? [(__bridge NSURL*)url pathExtension] : @"";extension = [extension lowercaseString];// Create the properties dicCFTypeRef keys[1] = {kQLThumbnailPropertyExtensionKey};CFTypeRef values[1] = {(__bridge CFStringRef)extension};CFDictionaryRef properties = CFDictionaryCreate(kCFAllocatorDefault, (const void**)keys, (const void**)values, 1, &kCFTypeDictionaryKeyCallBacks, &kCFTypeDictionaryValueCallBacks);// Check by extension because it's highly unprobable that an UTI for these formats is declared// the simplest way to declare one is creating a dummy automator app and adding imported/exported UTI conforming to public.imageCGImageRef img_ref = NULL;CFStringRef filepath = CFURLCopyPath(url);if ([extension isEqualToString:@"insp"]){if (!QLThumbnailRequestIsCancelled(thumbnail)){// 1. decode the image img_ref = decode_insp_at_path(filepath, NULL);    if (filepath != NULL)CFRelease(filepath);// 2. render itif (img_ref != NULL){QLThumbnailRequestSetImage(thumbnail, img_ref, properties);CGImageRelease(img_ref);}elseQLThumbnailRequestSetImageAtURL(thumbnail, url, properties);}elseQLThumbnailRequestSetImageAtURL(thumbnail, url, properties);}else if ([extension isEqualToString:@"insv"]){if (!QLThumbnailRequestIsCancelled(thumbnail)){// 1. decode the imageimg_ref = decode_insv_at_path(filepath, NULL);if (filepath != NULL)CFRelease(filepath);// 2. render itif (img_ref != NULL){QLThumbnailRequestSetImage(thumbnail, img_ref, properties);CGImageRelease(img_ref);}elseQLThumbnailRequestSetImageAtURL(thumbnail, url, properties);}elseQLThumbnailRequestSetImageAtURL(thumbnail, url, properties);}elseQLThumbnailRequestSetImageAtURL(thumbnail, url, properties);if (properties != NULL)CFRelease(properties);} return noErr;
}

  基本流程为:先获取文件UTI(Uniform Type Identifiers),然后再根据文件的扩展名来过滤文件,继而调用相应的解码库对图片或视频进行解码,构建CGImage引用返回。

GeneratePreviewForURL.c文件则用于完成预览图的生成。缩略图是就用单击空格键时弹出来的图,基本模板代码如下:

OSStatus GeneratePreviewForURL(void *thisInterface, QLPreviewRequestRef preview, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options)
{@autoreleasepool{NSString* extension = [[(__bridge NSURL*)url pathExtension] lowercaseString];image_infos infos;memset(&infos, 0, sizeof(image_infos));CGImageRef img_ref = NULL;CFStringRef filepath = CFURLCopyPath(url);if ([extension isEqualToString:@"insp"]){// 1. decode the imageif (!QLPreviewRequestIsCancelled(preview)){img_ref = decode_insp_at_path(filepath, &infos);if (filepath != NULL)CFRelease(filepath);// 2. render itCFDictionaryRef properties = create_properties(url, infos.filesize, infos.width, infos.height, true);if (img_ref != NULL){// Have to draw the image ourselvesCGContextRef ctx = QLPreviewRequestCreateContext(preview, (CGSize){.width = OUT_WIDTH, .height = OUT_HEIGHT+LOGO_HEIGHT}, YES, properties);CGContextDrawImage(ctx, (CGRect){.origin = CGPointZero, .size.width = OUT_WIDTH, .size.height = OUT_HEIGHT+LOGO_HEIGHT}, img_ref);QLPreviewRequestFlushContext(preview, ctx);CGContextRelease(ctx);CGImageRelease(img_ref);}elseQLPreviewRequestSetURLRepresentation(preview, url, contentTypeUTI, properties);if (properties != NULL)CFRelease(properties);}}else if([extension isEqualToString:@"insv"]){// 1. decode the imageif (!QLPreviewRequestIsCancelled(preview)){img_ref = decode_insv_at_path(filepath, &infos);if (filepath != NULL)CFRelease(filepath);// 2. render itCFDictionaryRef properties = create_properties(url, infos.filesize, infos.width, infos.height, true);if (img_ref != NULL){// Have to draw the image ourselvesCGContextRef ctx = QLPreviewRequestCreateContext(preview, (CGSize){.width = OUT_WIDTH, .height = OUT_HEIGHT+LOGO_HEIGHT}, YES, properties);CGContextDrawImage(ctx, (CGRect){.origin = CGPointZero, .size.width = OUT_WIDTH, .size.height = OUT_HEIGHT+LOGO_HEIGHT}, img_ref);QLPreviewRequestFlushContext(preview, ctx);CGContextRelease(ctx);CGImageRelease(img_ref);}elseQLPreviewRequestSetURLRepresentation(preview, url, contentTypeUTI, properties);if (properties != NULL)CFRelease(properties);}}else{// Standard images (supported by the OS by default)size_t width = 0, height = 0, file_size = 0;properties_for_file(url, &width, &height, &file_size);// Request preview with updated titlebarCFDictionaryRef properties = create_properties(url, file_size, width, height, false);QLPreviewRequestSetURLRepresentation(preview, url, contentTypeUTI, properties);if (properties != NULL)CFRelease(properties);}}return kQLReturnNoError;
}

  代码逻辑甚至更简单,其中的create_properties()函数用于给预览窗口添加宽高、图片名等信息。不需要的话可以去掉。上面的模板代码编写好之后,QuickLook插件的主要工作就是视频和图片的编解码了。编译好的QuickLook插件是一个以qlgenerator为扩展名的Bundle。官方推荐的安装位置有三个:(1)~/Library/QuickLook/:存放第三方开发的QuickLook插件,针对当前用户的,只有当前用户登录了才会加载插件。(2)/Library/QuickLook:存放第三方开发的QuickLook插件,这是针对所有用户起作用的。(3)/System/Library/QuickLook/:这里只存放苹果公司开发的QuickLook插件,所有用户都能用。可以根据自身需要将QuickLook插件安装到相应的位置。

三、注意事项

(1) 确定并设置文件UTI。QuickLook插件需要根据文件的UTI来关联,因此首要的一步是确定自有文件格式的UTI。那么怎么确定呢?其实有个命令可以查看文件的UTI元信息:mdls。kMDItemContentType即为文件的UTI信息。把获得的UTI添加到QuickLook工程当中的Info.plist文件中去即可。

(2)日志路径。在开发QuickLook插件的过程中,难免会遇到崩溃的情况。这个时候日志是非常重要的一种调试手段。QuickLook插件出现异常的第一步应该去查看/var/log/system.log文件。这个是OSX系统的系统日志文件。QuickLook插件如出现加载异常现象,里面都会有记录。其次我们应该去/Users/[user name]/Library/Logs/DiagnosticReports/目录下去查看崩溃日志。

(3) 需要注意的是,在GeneratePreviewForURL()GenerateThumbnailForURL()方法中传进来的文件路径以URL形式存在的。也就是说,当路径中存在中文时,会进行URL Encode编码。也就是说,中文"直播间"会变成"%E7%9B%B4%E6%92%AD%E9%97%B4"。在解析的时候要注意进行URL Decode操作,否则的话无法读取到文件。

(4)qlmanage的使用。qlmanage可以用于清除QuickLook缓存,也可以用来查看当前系统中存在哪些QuickLook插件,也可以查看哪些文件是和哪些QuickLook插件关联的。这对于判断你的QuickLook插件是否起作用很方便:

(5) install_name_toolutool。这两个命令配合使用,主要用于修改动态库的链接路径。主要使用方法为:

  • utool -L *.dylib
  • install_name_tool -id "new_path" *.dylib
  • install_name_tool -change "old_path" "new_path" *.dylib   

四、参考链接

  1. http://blog.10to1.be/cocoa/2012/01/27/creating-a-quick-look-plugin/
  2. http://apple.stackexchange.com/questions/153595/how-can-i-see-which-quicklook-plugin-is-responsible-for-which-data-type
  3. https://developer.apple.com/library/mac/documentation/UserExperience/Conceptual/Quicklook_Programming_Guide/Introduction/Introduction.html

Mac OS X平台下QuickLook开发教程相关推荐

  1. linux 拷机软件,拷机软件跑起来,OS X平台下OpenGL初体验

    拷机软件跑起来,OS X平台下OpenGL初体验 2012-11-12 18:55:03 作者:tina Tag:Mac 热度:745℃ 苹果自成一套的体系可以尽情展示自家的技术水准,但是也会给一些程 ...

  2. 基于Mac OS系统搭建51单片机开发环境

    基于Mac OS系统搭建51单片机开发环境 Reason 本人是杭电计科学生,参加的智能小车队伍平时需要大量基于单片机的操作,目前使用的是MBP(冤种mac),网上大多又是基于Windows系统等开发 ...

  3. Mac平台下Opencv开发环境搭建

    OpenCV(Open Source Computer Vision Library),是一个开源的跨平台的计算机视觉库,它实现了图像处理和计算机视觉领域的很多通用算法,可以在多种计算机平台上运行,支 ...

  4. 【开发软件】推荐一款MAC OS X 下php集成开发环境mamp

    这里给大家推荐一款在mac上搭建WEB服务器环境的集成环境安装软件,非常的好用,需要的朋友可以拿去,不用谢 ^_^ 之前苦于mac上搭建本地服务器之艰辛,找寻好久都没找到一款类似windows上集成的 ...

  5. mac os x使用Git简易入门教程

    该入门教程的流程是这样的: 什么是Git----------------->为什么选择Git----------------->如何安装Git到MAC OS X-------------- ...

  6. 【转】windows环境下安装win8.1+Mac OS X 10.10双系统教程

    先要感谢远景论坛里的各位大神们的帖子  没有他们的分享我也不能顺利的装上Mac OS X 10.10! 写这篇随笔主要是为了防止自己遗忘,同时给大家分享下我的经验. 本教程适用于BIOS+MBR分区的 ...

  7. 从Windows角度看Mac OS X上的软件开发

    如果原来从事Windows软件开发,想跨足或转换至Mac OS X环境,需要知道那些东西?有什么知识技能可以快速运用在Mac OS X环境上的?这两个问题应该是Windows开发者进入Mac OS X ...

  8. Mac OS X 懒人版安装教程(之前的图全部挂了,所以重发了)

    请版主把我之前发的那个帖子删了!因为所有的图全部挂了,所以麻烦版主了-- 安装中出现五国的话就请进入这里看看是那里的错误http://bbs.pcbeta.com/viewthread-863656- ...

  9. MAC OS X10 10上Android开发环境搭建

    由于Google官方已经不提供Adt-Bundle下载了,主推AndroidStudio.可以从这个链接下载http://www.androiddevtools.cn.上面不光有adt-bundle, ...

最新文章

  1. 盘点 IDEA2020.3 那些炫酷的插件,超级好用的那种
  2. PyCharm常用快捷键大全
  3. 假设你有一个数组,其中第i 个元素是第i天给定股票的价格。设计算法以找到最大利润。你可以根据需要完成尽可能多的交易(即,多次买入并卖出一股股票)。注意:您不能同时进行多笔交易(即,您必须在再次购买之前
  4. MTK MODEM(1)--- MTK平台NV基本功能与操作
  5. Spring4.0学习笔记(5) —— 管理bean的生命周期
  6. 聚类 | Map-Equation多级网络聚类模型——InfoMap
  7. 深度学习2.0-25.Train-Val-Test划分检测过拟合(交叉验证)
  8. C++深度探索系列:智能指针(Smart Pointer) [一] (转)
  9. Listary的使用
  10. 概率论与数理统计——几何分布的无记忆性证明
  11. java 使用xml生成word_java 根据word xml模板生成word
  12. 飞鱼手机短信语音验证码接收平台API接口例子
  13. 人生经验:热闹还是要看?
  14. A system tap script to detect UDP beacons
  15. 一个不错的 在线字体 网站
  16. 【西行 - 官封弼马温】Java 基本程序设计结构
  17. Thymeleaf是干什么的
  18. 北京自学考试计算机应用基础,北京教育考试院
  19. 配电数字化浪潮下-安科瑞能效管理方案助力电力成套行业转型发展
  20. oracle cmd导出数据库命令行,oracle 中数据库完全导入导出:cmd命令行模式(转载)...

热门文章

  1. Job for tomcat.service failed because the control process exited with error code 解决办法:
  2. 【自然语言处理】【多模态】多模态综述:视觉语言预训练模型
  3. [生存志] 第22节 历代大事件概览 五代十国
  4. java 绑定mac地址_如何JAVA实现使用TrueLicense在证书中绑定PC的MAC地址,防止止拷贝应用...
  5. kali mysql安装教程_MySQL 安装教程(windows版)
  6. 【C】 小球自由下落
  7. HTML 教程(初级)
  8. STM32之BKP原理
  9. 笔记本屏幕给另一台当扩展屏幕_chenjie的博客
  10. 小学计算机集体听课评课,小学听课评课活动总结