Tag: itunes

Mac OS X 10.5 中，由于 [Scripting Bridge][] 的引入，用 Ruby 或 Python 程序完成原来 AppleScript 才能完成的任务变得非常简单，而因为这两门语言自身的强大，无形中，可以完成的工作也多了不少。比如我们原来可能要用 ID3Mod 这样的软件进行 iTunes Music Library 的歌曲乱码转换，现在写一段不到十行的 Python 脚本就能完成 (当然，界面没有那么方便)。

[Scripting Bridge]: http://www.apple.com/applescript/features/scriptingbridge.html

### 一个小例子

这里先用 Python 简单的展示一点可以完成的操作:

# 导入必要的模块
from Foundation import *
from ScriptingBridge import *

# 找到 iTunes 这个应用程序
iTunes = SBApplication.applicationWithBundleIdentifier_(“com.apple.iTunes”)

# 打印出当前正在播放的音乐名称
print iTunes.currentTrack().name()

这段代码在 Leopard 下，既可以保存为 .py 文件，用系统自带的 python 解释器 (`/usr/bin/python`) 执行，也可以直接在命令行下调用 Python 解释器，查看它的输出，比如我这里是:

$ python
Python 2.5.1 (r251:54863, Oct 5 2007, 21:08:09)
[GCC 4.0.1 (Apple Inc. build 5465)] on darwin
Type “help”, “copyright”, “credits” or “license” for more information.
>>> from Foundation import *
>>> from ScriptingBridge import *
>>> iTunes = SBApplication.applicationWithBundleIdentifier_(“com.apple.iTunes”)
>>> print iTunes.currentTrack().name()
Le Festin
>>>

注意，执行之前最好先在 iTunes 里开始播放一首曲目。

### 了解更多

见识了 Scripting Bridge 的威力之后，你很自然的想知道这段代码为何可以工作，应该按什么方式来调用它，除了查询当前播放的歌曲名称以外，还有什么其他的接口可以使用。这时候，我们就需要对我们希望用脚本操纵的程序所提供的 Scripting 接口有个清晰的了解。所以可以用 `sdef` 这个命令获得一个程序的脚本接口定义:

$ sdef /Applications/iTunes.app
xml version=”1.0″ encoding=”UTF-8″?>


…

出现了一长串的怪异信息，太混乱了，看不懂，怎么办呢？这时应该用 `sdp` 命令过滤一下，生成一个比较可读的格式，Objective-C 头文件:

$ sdef /Applications/iTunes.app | sdp -fh –basename iTunes
$ ls
iTunes.h
$ more iTunes.h
/*
* iTunes.h
*/

#import
#import
…

这里就是一个对 iTunes 提供的脚本编程接口的详尽描述了。从这里我们其实很容易看出，原来 `iTunes = SBApplication.applicationWithBundleIdentifier_(“com.apple.iTunes”)
` 获得的，是一个 iTunesApplication 对象，以这个对象为出发点，我们可以做到任何 API 允许的事情。下面就是一个例子。

#!/usr/bin/python

from Foundation import *
from ScriptingBridge import *

iTunes = SBApplication.applicationWithBundleIdentifier_(“com.apple.iTunes”)

for track in iTunes.sources()[0].playlists()[0].tracks():
print track.name(), track.artist()

简单的观察一下，iTunes 的脚本编程 API 组织是这样的：在 `iTunesApplication` 下，可以找到多个来源 (`iTunesSource`)，来源有许多种，比如 music library，比如 CD，比如 iPod 等等，而每个来源里，又按照播放列表 (`iTunesPlaylist`) 来组织，而每个播放列表中，显而易见地有多个曲目 (`iTunesTrack`)，在上面这个例子里，我们要找的第一个来源 (`sources()[0]`) 的第一个播放列表 (`playlists()[0]`)，正是你的 iTunes Music Library。

值得注意的一点是，在 `iTunes.h` 中用 `SBElementArray *` 表示的数据类型，一眼可以看出它是数组，在 Python 中处理起来也很简单，直接当成 list 类型遍历即可。

### 修改数据

那么，查询我们知道了，该怎么把信息写回去，也就是说，修改原来 Music Library 的内容呢？

先来看看 `iTunes.h` 中的出现的一段:

@interface iTunesTrack : iTunesItem

– (SBElementArray *) artworks;

@property (copy) NSString *album;
@property (copy) NSString *albumArtist;
@property NSInteger albumRating;
@property (readonly) iTunesERtK albumRatingKind;

这里描述的是一个曲目 (它继承了 `iTunesItem` 类型，所以也继承了它的 `name` 等属性)，`@property` 这种写法，是 Objective-C 2.0 中[新出现的][objc-property]，也很好理解，`(copy)` 的意思是你的赋值会被复制一份保存，`(readonly)` 当然是只读的，而 `NSInteger` 这种简单的变量也是可以写的。

[objc-property]: http://theocacao.com/document.page/510

那么，查询我们知道了，比如这里有个 `album` 属性，我们就去调用 track 的 `album()` 方法，但究竟如何赋值呢？还是按照 Cocoa 的 Key-value coding 的老规矩，改成 `setAlbum(<参数>)`，比如:

>>> iTunes.sources()[0].playlists()[0].tracks()[0].name()
u’Le Festin – Performed by Camille’
>>> iTunes.sources()[0].playlists()[0].tracks()[0].setName_(u’Le Festin’)

这里把一首原来叫做 Le Festin – Performed by Camille 的歌曲名称修正为 [Le Festin]()，回到 iTunes 里一看，果然改了。

[Le Festin]: http://blog.pixnet.net/cherrybear/post/8735331

### 系统自带与 macports

在 Mac OS X 10.4 中，由于系统自带的 Python 是老旧的 2.3 版本，所以对 Python 爱好者来说，都往往不得不自己编译一份或者使用 fink/macports 中提供的 Python 2.4/2.5 版本。而在 Mac OS X 10.5 中，终于把自带的 Python 升级到了最新的 2.5.1 版本，对爱好者来说无疑是省事了，可惜这个自带的版本一个令中文用户郁闷的 bug 是：在提示符模式下无法用输入法输入任何中文字符 (相信其他 CJK 字符也是如此)，比如我用输入法打一段：你好 hello 世界 world，等我一确认，Python 解释器只收到了 hello world，中文字符被自动滤掉了！然而，通过 macports 安装的 Python 此功能却是正常的。

这使得我们这里如果要修改中文的歌曲、作家、专辑名等等都变得很不方便，怎么办呢？

系统自带的 Python 的特别之处，其实在于它自带了许多 Apple 添加的模块，比如我们在代码最开始导入的 `Foundation` 和 `ScriptingBridge` 模块，这些模块有些不是开源的，有些则还没来得及把代码公开，所以我们机器上只安装有编译好的 Python 模块，然而幸好这些模块是 2.5 版本的，只要我们用 macports 也安装一个 2.5 版本，把系统自带模块的路径给加进去，就能找到并使用它们了。让我们还是用开头那个例子做个简单的示范:

#!/opt/local/bin/python2.5

import sys

sys.path.append(‘/System/Library/Frameworks/Python.framework/Versions/2.5/Extras/lib/python’)
sys.path.append(‘/System/Library/Frameworks/Python.framework/Versions/2.5/Extras/lib/python/PyObjC’)

from Foundation import *
from ScriptingBridge import *

iTunes = SBApplication.applicationWithBundleIdentifier_(“com.apple.iTunes”)

print iTunes.currentTrack().name()

有了上面这些介绍，相信要把这几个工具组合在一起成为一套 iTunes Music Library 的管理利器也不是难事，各位不妨发挥想象力，我就不多说了。