大概一年前就开始关注KODI了,确实是个非常不错的开源项目,KODI提供很好的操作界面,但作为一个命令行控或者是没有显示屏的树莓派,我希望能够通过命令行对其进行控制,比如播放、暂停、静音等等. 于是去搜索了下,发现有个JSON-RPC,他是kODI官网推出的,方便其他开发者对接,到目前为止已经更新到v8,可以点击这里查看。这里将为大家详细介绍下它的用法。
初步印象
在使用JSON-RPC,必须开启,可以进入设置 – 服务 – 控制,开启服务,可设置端口、用户名、密码,当然可以不设置用户名和密码
入门
JSON-RPC顾名思义就是采用JSON进行RPC通信,那么它的基本格式如下:
请求(REQUEST)
- URI:http://host:port/jsonrpc
- METHOD:POST
- HEADER:ContentType:application/json
- BODY: {“jsonrpc”:”2.0″, “method”:”xx”, “params”:{}, “id”:xx},jsonrpc必须是2.0,这个与实际版本无关 method为具体方法,会在后面介绍,params为method对应的参数,若无,则可以不传 id是由客户端定义,用于标识客户端,服务器会返回相同的id(见响应)
如:
curl -X POST -H "ContentType:application/json" -d '{"jsonrpc": "2.0", "method": "JSONRPC.Version", "id":"22"}' http://localhost:8080/jsonrpc
响应(RESPONSE)
- BODY: {“jsonrpc”:”2.0″, “result”:”xxx”,”error”:{“code”:xx,”message”:”xxx”,”data”:”xxx”},”id”:xx } result为返回结果,若错误,则空,error错误,id为请求传递的,若错误,为空
{"id":"22","jsonrpc":"2.0","result":{"version":{"major":8,"minor":0,"patch":0}}}
进阶
以上内容就好比是内功,有了好的内功,其他的都好学,在之前的REQUEST我们了解到了method和params,那么我们来看看都有哪些外功. 外功分为v2、v4、v6、v8几个版本,目前最新的是v8,可以通过上面给出的例子,获取到当前版本. 竟然我用到的是v8,我们就来看下v8的定义。 v8是随着kodi v17一同发布的,它支持WebSocket。正所谓举其一可知大概,我在这里就不对所有的method进行介绍,我会抽出几个,告知大家如何看懂文档。
- Player.GetActivePlayers – 获取当前激活的播放器
5.9.1 Player.GetActivePlayers
Returns all active players
Permissions:
ReadData
Returns:
Type: array
Permissions 权限,可通过JSONRPC.Permission获取权限开关状态
Returns:返回
curl -X POST --header "content-type:application/json" --data '{"jsonrpc": "2.0", "method": "Player.GetActivePlayers", "id":"22"}' http://localhost:8080/jsonrpc
{"id":"22","jsonrpc":"2.0","result":[{"playerid":0,"type":"audio"}]}
- Application.SetVolume – 设置音量
5.2.4 Application.SetVolume
Set the current volume
Permissions:
ControlPlayback
Parameters:
mixed volume
Returns:
Type: integer
例子:
curl -X POST --header "content-type:application/json" --data '{"jsonrpc": "2.0", "method": "Application.SetVolume", "params":{"volume":8}, "id":"22"}' http://localhost:8080/jsonrpc
{"id":"22","jsonrpc":"2.0","result":8}
扩展
当然KODI还提供了kodi-send命令,来简化请求,格式如下:
kodi-send -a "XXX"
xxx见http://kodi.wiki/view/List_of_built-in_functions
如
osmc@osmc:~$ kodi-send -a "SetVolume(10)"
Sending action: SetVolume(10)