来至原文:https://code.google.com/p/stonelab/wiki/RaspCTL

什么是RaspCTL
RaspCTL是Raspberry Pi和Control字母的组合,表示树莓派控制端。 RaspCTL是一款通过手机终端(泛义上包括手机,平板,电脑等设备)控制树莓派的软件。
目前,通过Raspberry&RaspCTL组合,打造成家庭多媒体播放机顶盒,在此场景中,RaspCTL非常类似XBMC平台。
未来,会不断扩展RaspCTL功能,成为控制家庭物联网的设备中心,比如控制摄像头,空调开关等。此乃后话,按下不表。
为什么选择Raspberry Pi&RaspCTL为什么选择Raspberry Pi
我们先来看看Raspberry Pi的相关参数:
CPU700 MHz, ARM1176JZF-S
GPU(显卡)Broadcom VideoCore? IV,OpenGL ES 2.0, 1080p30 h.264/MPEG-4 AVC high-profile decoder
MEM(内存)512M
分辨率1080P
输出接口1*SD口 2*USB口 1*音频口 1*HDMI口 1*网卡
尺寸85.6 x 53.98 x 17mm (一张信用卡大小)
价格$35

好吧,一起来总结下Raspberry Pi的优势吧
从这些特性看,Raspberry非常合适充当高清视频播放机顶盒,来替代目前的华数机顶盒(华数官方垄断,费用高,质量差)。 家庭中,只要购置了Raspberry Pi和宽带,高清电影电视,免费看。 :)
为什么选择RaspCTL
只有一个原因:Raspberry Pi CPU很弱:700MHZ。 同样,我们来看一组数据:

如果,Raspberry Pi CPU能强悍那么一点点,那么XBian一定是首选,我也不会重新创造RaspCTL这个轮子了。只是目前,XBMC在Raspberry Pi(XBian)上的性能太糟糕了。 从数据看,只有在Raspbian Terminal下的性能,才能符合用户的期望,所以作者编写了RaspCTL这个控制端。通过手机终端的界面,来操作Raspbian Terminal,实现多媒体播放的功能。
RaspCTL功能特性V0.1.0V0.1.1V0.1.2使用者文档如何安装RaspCTL如何使用RaspCTL常见问题开发者文档类库API
Omxplayer
play播放,可以指定播放列表中任一一个资源
pause暂停播放
resume恢复播放
stop停止播放
lseek快退, 快退30秒, 参数为True的话,快退10分钟
rseek快进, 快进30秒,参数为True的话,快进10分钟
prev播放上一首
next播放下一首
set_playlist设置播放列表
add_playitem添加多媒体资源到播放列表中, 参数为 ('url', 'name') 资源地址, 资源显示名
del_playitem清空播放列表
sort_playitem播放列表排序
set_dev设置输出设备, hdmi接口 或者 本地音频接口
set_loop设置播放模式:顺序,循环
get_info获取播放器信息,如播放状态等

LocalFile?
get_mediapath获得多媒体文件根目录路径
list获取一个目录下的所有资源
list_all递归获取一个目录下的所有资源

Config
load获取raspctl.cnf中的配置信息
save更新raspctl.cnf中的配置信息

MediaUrl?
get_urls获取网站url对应的真实视屏url地址信息, fmt=high 获取高清视屏地址

Ajax规范
使用Ajax的目的:为了RaspCTL提供的服务可以同时被WAP, Android APP, IOS APP使用,RaspCTL服务均以Ajax形式提供。希望Plugins开发者也遵照这个规约,但不强制。
类库中,只要被标志@classmethod的方法,会直接暴露成Ajax服务,如:
class Foo:
    @classmethod
    def hello(cls, arg1, arg2):
        return {msg: 'Hello Ajax[%s %s]' % (arg1, arg2)}
Ajax服务地址为:http://xxx.xxx.xxx.xxx:8000/api?data={"name":"Foo.hello", "args":["stone2083", "connie2083"]} 服务信息为:
{
  status: "Success",
  message: "Success",
  api: {
    args: [ ],
    name: "Foo.hello"
  },
  result: {
    msg: "Hello Ajax[stone2083 connie2083]"
  }
}Plugins规范youku --> 插件名字
    __init__.py --> 插件程序
    index.html --> 插件模板 【可选择】
init.py 内容为:
from rasplib import Plugin
urls = (
    '/', 'Index',
)

# 必须创建plugin实例,参数分别为插件名,作者名,版本号, 支持功能的urls
#其中,plugin中包含RaspCTL类库的所有方法,可直接调用
plugin = Plugin('youku','stone2083', '0.1', urls)

#web.py写法,插件规范并不引入新的学习成本。
class Index:
    def GET(self):
        return 'youku-NotSupported.'  #可以直接输出
        #return plugin.render.index()  #可以渲染某个模板信息
写在最后