基础接口开发手册

概要

小龟小车各种操控API。

基础API

sleep(seconds:int)
暂停多少秒。
#范例: 暂停1.5秒。
>sleep(1.5)

    参数:
  • seconds: 暂停多少秒,最小暂停时间为10ms。
  • 返回值: 小车的当前编号
car.id()->str
返回小车的编号。
#范例: 返回小车的编号。
>car.id()
"acvbekdi334343"

    参数:
  • 返回值: 小车的当前编号
car.model()->str
返回小车的型号。
#范例: 返回小车的型号。
>car.model()
"A1"

    参数:
  • 返回值: 小车的当前型号
car.version()->str
返回小车固件版本。
#范例: 返回小车的固件版本。
>car.version()
"V191101"

    参数:
  • 返回值: 小车的当前型号
car.require(min_version)
检测小车当前固件版本是否符合要求,如小车固件版本低于参数则中止Python代表,并返回异常。
#范例: 要求小车的固件版本必须高于V200301。
>car.require("V200301")


    参数:
  • min_version: 要求最低的固件版本,如:V200301
  • 返回值: 本函数无返回值,如当前小车固件版本不符合的话,则直接触发异常,并中断当前Python代码。
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])
播放小车特征动作
#范例: 小车轻摇三次。
car.hello()

    参数:
  • action: 小车特征动作编号,默认-轻摇3次,1-轻摇3次,2-轻摇1次,3-闪灯3次,4-闪灯1次