基础接口开发手册
概要
小龟小车各种操控API。
基础API
- sleep(seconds:int)
- 暂停多少秒。
- seconds: 暂停多少秒,最小暂停时间为10ms。
- 返回值: 小车的当前编号
#范例: 暂停1.5秒。 >sleep(1.5)
- 参数:
- car.id()->str
- 返回小车的编号。
- 返回值: 小车的当前编号
#范例: 返回小车的编号。 >car.id() "acvbekdi334343"
- 参数:
- car.model()->str
- 返回小车的型号。
- 返回值: 小车的当前型号
#范例: 返回小车的型号。 >car.model() "A1"
- 参数:
- car.version()->str
- 返回小车固件版本。
- 返回值: 小车的当前型号
#范例: 返回小车的固件版本。 >car.version() "V191101"
- 参数:
- car.require(min_version)
- 检测小车当前固件版本是否符合要求,如小车固件版本低于参数则中止Python代表,并返回异常。
- min_version: 要求最低的固件版本,如:V200301
- 返回值: 本函数无返回值,如当前小车固件版本不符合的话,则直接触发异常,并中断当前Python代码。
#范例: 要求小车的固件版本必须高于V200301。 >car.require("V200301")
- 参数:
- car.random()->float
- 返回一个随机数。
- 返回值: 一个随机数
#范例: 返回一个随机数。 >car.random() 0.4321
- 参数:
- car.idle()
- 让CPU歇一歇缓口气。因为小龟小车采用的是嵌入式CPU,在个别场合过密的操作指令会导致CPU一直被Python程序占据,进而存在引发系统宕机的概率。因此建议过密的计算操作适当加入该CPU歇一歇指令,让CPU缓口气执行其它系统操作。
#范例: 让CPU空闲一下下。 car.idle()
- car.go(keep:int, diff:int=None)
- 小车前进指定的时间和斜向角度偏位。
#范例: 小车以向左倾斜行走2秒。 car.go(2, -10)
- car.left(keep:int, diff:int=None)
- 小车左转指定的时间和角度偏位。
#范例: 小车以向左倾斜行走2秒。 car.left(2, -10)
- car.right(keep:int, diff:int=None)
- 小车右转指定的时间和角度偏位。
#范例: 小车以向左倾斜行走2秒。 car.right(2, -10)
- car.back(keep:int, diff:int=None)
- 小车后退指定的时间和斜向角度偏位。
#范例: 小车以向左倾斜后退2秒。 car.back(2, -10)
- car.stop()
- 小车刹车。
#范例: 小车前进过程中,刹车。 car.go(2) car.stop()
- car.speed(speed:int)
- 调整小车速度(单位:毫米每秒)。
#范例: 调整小车速度到每秒20毫米。 car.speed(20)
- car.hello([action:int=None])
- 播放小车特征动作
- action: 小车特征动作编号,默认-轻摇3次,1-轻摇3次,2-轻摇1次,3-闪灯3次,4-闪灯1次
#范例: 小车轻摇三次。 car.hello()
- 参数: