一、引言

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 properties
NSDictionary* 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 extension
id 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 dic
CFTypeRef 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.image
CGImageRef 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 it
if (img_ref != NULL)
{
QLThumbnailRequestSetImage(thumbnail, img_ref, properties);
CGImageRelease(img_ref);
}
else
QLThumbnailRequestSetImageAtURL(thumbnail, url, properties);
}
else
QLThumbnailRequestSetImageAtURL(thumbnail, url, properties);
}
else if ([extension isEqualToString:@"insv"])
{
if (!QLThumbnailRequestIsCancelled(thumbnail))
{
// 1. decode the image
img_ref = decode_insv_at_path(filepath, NULL);
if (filepath != NULL)
CFRelease(filepath); // 2. render it
if (img_ref != NULL)
{
QLThumbnailRequestSetImage(thumbnail, img_ref, properties);
CGImageRelease(img_ref);
}
else
QLThumbnailRequestSetImageAtURL(thumbnail, url, properties);
}
else
QLThumbnailRequestSetImageAtURL(thumbnail, url, properties);
}
else
QLThumbnailRequestSetImageAtURL(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 image
if (!QLPreviewRequestIsCancelled(preview))
{
img_ref = decode_insp_at_path(filepath, &infos);
if (filepath != NULL)
CFRelease(filepath); // 2. render it
CFDictionaryRef properties = create_properties(url, infos.filesize, infos.width, infos.height, true);
if (img_ref != NULL)
{
// Have to draw the image ourselves
CGContextRef 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);
}
else
QLPreviewRequestSetURLRepresentation(preview, url, contentTypeUTI, properties);
if (properties != NULL)
CFRelease(properties);
}
}
else if([extension isEqualToString:@"insv"])
{
// 1. decode the image
if (!QLPreviewRequestIsCancelled(preview))
{
img_ref = decode_insv_at_path(filepath, &infos);
if (filepath != NULL)
CFRelease(filepath); // 2. render it
CFDictionaryRef properties = create_properties(url, infos.filesize, infos.width, infos.height, true);
if (img_ref != NULL)
{
// Have to draw the image ourselves
CGContextRef 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);
}
else
QLPreviewRequestSetURLRepresentation(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 titlebar
CFDictionaryRef 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. Windows平台下PHP开发环境的配置

    Windows平台下PHP开发环境的配置 一.基本环境 1.Windows XP 32位 2.Apache 2.2.25,下载地址:http://mirror.bit.edu.cn/apache/ht ...

  2. 在Mac OS X中使用VIM开发STM32(2)

    本文原创于http://www.cnblogs.com/humaoxiao,非法转载者请自重! 在我先前的博文⎣在Mac OS X中使用VIM开发STM32(1)⎤中,我们安装完成了MACVIM,这一 ...

  3. 在Mac OS X中使用VIM开发STM32(1)

       本文原创于http://www.cnblogs.com/humaoxiao,非法转载者请自重!     在我先前的博文⎣在Mac OS X中搭建STM32开发环境⎤中,我们在Mac中DIY出了最 ...

  4. 转-在Mac OS上搭建Python的开发环境

    在Mac OS上搭建Python的开发环境   本文转载自:http://www.jb51.net/article/76931.htm 一. 安装python mac系统其实自带了一个python的执 ...

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

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

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

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

  7. 笔记:MAC OS X下配置PHP开发、调试环境

    操作系统:MAC OS X 工具:MAMP.PhpStorm.xdebug.chrome 1.下载MAMP 2.安装比较简单,安装完成后,应用程序中会增加如下4个应用 MacGDBp是PHP调试器,使 ...

  8. windows环境下安装win8.1+Mac OS X 10.10双系统教程

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

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

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

随机推荐

  1. CI框架,源代码一次性判断获取post(get)数据是否有某个字段值为空方法

    一.以下是CI框架 1.把所有的要接收的字段放在数组中 例: 我要接收:id,name,age,mobile 等字段 $req = array('id','name','age','mobile'); ...

  2. 重载与覆盖(java)

    一般来说,分为两种情况.一是在同一个类里面有两个或两个以上的同名的方法,这些方法的名字相同,但参数不同,这种情况中叫重载.当你调用方法时,会根据你传进去的参数的类型来决定调用哪个方法.二是一个类继承了 ...

  3. 基于 Jenkins 快速搭建持续集成环境

      什么是持续集成 随着软件开发复杂度的不断提高,团队开发成员间如何更好地协同工作以确保软件开发的质量已经慢慢成为开发过程中不可回避的问题.尤其是近些年来,敏捷(Agile) 在软件工程领域越来越红火 ...

  4. 【腾讯Bugly干货分享】美团大众点评 Hybrid 化建设

    本文来自于腾讯Bugly公众号(weixinBugly),未经作者同意,请勿转载,原文地址:http://mp.weixin.qq.com/s/rNGD6SotKoO8frmxIU8-xw 本期 T ...

  5. 清晰易懂TCP通信原理解析(附demo、简易TCP通信库源码、解决沾包问题等)C#版

    目录 说明 TCP与UDP通信的特点 TCP中的沾包现象 自定义应用层协议 TCPLibrary通信库介绍 Demo演示 未完成功能 源码下载 说明 我前面博客中有多篇文章讲到了.NET中的网络编程, ...

  6. 浅析用Base64编码的图片优化网页加载速度

    想必大家都知道网页加载的过程,从开始请求,到加载页面,开始解析和显示网页,遇到图片就再次向服务器发送请求,加载图片.如果图片很多的话,就会产生大量的http请求,从而影响页面的加载速度.所以现在有一种 ...

  7. Objective-C 装饰模式--简单介绍和使用

    装饰模式是在不必改变原类文件和使用继承的情况下,动态地扩展一个对象的功能.它是通过创建一个包装对象,也就是装饰来包裹真实的对象. 比如游戏机有一个GamePad类, 现在要增加一个作弊功能(例如100 ...

  8. [Hadoop大数据]——Hive连接JOIN用例详解

    SQL里面通常都会用Join来连接两个表,做复杂的关联查询.比如用户表和订单表,能通过join得到某个用户购买的产品:或者某个产品被购买的人群.... Hive也支持这样的操作,而且由于Hive底层运 ...

  9. Android开发学习之路-下拉刷新怎么做?

    因为最近的开发涉及到了网络读取数据,那么自然少不了的就是下拉刷新的功能,搜索的方法一般是自己去自定义ListView或者RecyclerView来重写OnTouch或者OnScroll方法来实现手势的 ...

  10. show master/slave status求根溯源

    show master/slave status分别是查看主数据库以及副数据库的状态,是一种能查看主从复制运行情况的方式. 这里仅仅讨论linux下的nysql5.7.13版本的执行情况 一.show ...