4.CyberPi Python API使用教程

前言
欢迎使用童芯派学习 Python 编程,童芯派具备丰富的输入输出能力,能够让你和你的代码互动起来,并直观地展现撰写代码的效果。
童芯派自带蓝牙及 Wi-Fi,你可以使用它们组建本地局域网或连接至因特网。在实际项目进行动手实践,可了解和掌握物联网、人工智能、计算机网络等方面的相关知识和技能。
童芯派还支持30余种扩展电子模块以及数块扩展板,能够支撑智慧农场、智能家居、自动驾驶车、智能机器人、竞赛用机器人等项目的制作。
cyberpi 库能够帮助你实现上述的所有功能。

1.cyberpi 库的导入
cyberpi 库其实指向运行在童芯派硬件上的 micro-python 库 cyberpi,以及运行在电脑端的 python 库 ,这两个库并不是同一个,但它们拥有相同的名字,完全一致的 API,以及相近的执行效果。这一特性来自于 cyberpi 团队的刻意追求,这使得您在上传模式(运行在童芯派硬件)下撰写的 micro-python 代码,可以同时在在线模式下(运行在电脑)可以被作为 python 代码来执行。我们相信这有利于学习者从 micro-python 较舒适地过渡到 python 学习。

为了让您更好的阅读童芯派的API文档,我们对API的可使用场景(Python3与MicroPython)进行了标识。Python3 对应的是童芯派在线模式的编程,MicroPython对应的是上传模式的编程。

支持Python 3 的标识:

支持MicroPython 的标识:

你可以在 Python 编辑器或 micro-python 编辑器中使用 cyberpi库,按如下方式导入:

## python 全写
import cyberpi
cyberpi.console.print("hello")
## micropython 简写
from cyberpi import *
console.print("hello")

全写的写法更适合在线模式下的 python 代码撰写,这意味 cyberpi 部分的代码不会在导入其他 python 库时出错。
简写的写法更适合在上传模式下的 micro-python 代码撰写时使用——这样你可以少打一些字。

慧编程的积木转码会倾向于使用更不容易出错的全写。

2.cyberpi 库中的 API

cyberpi 库提供多个 API 用以实现对硬件的控制,本页面描述童芯派的API,你还可查看童芯派的各种扩展 API:
功能扩展 API
扩展板 API
mBuild 电子模块 API

3.童芯派的 API

用于对童芯派本身进行编程控制,涵盖童芯派的主要功能,包含如下部分:

播放
童芯派带有扬声器和麦克风,使用以下 API 实现音频的录制、播放以及音量和播放速度的调节。

预置音频

图片[1]-4.CyberPi Python API使用教程-Senc森辞知识分享站

cyberpi.audio.play_until(music_name)

播放预置的音频文件,该 API 会阻塞线程直至音频播放结束。参数:
music_name str,有效范围和对应的音频效果见表(1-1)。

图片[2]-4.CyberPi Python API使用教程-Senc森辞知识分享站

cyberpi.audio.play(music_name)

播放预置的音频文件。参数:
music_name str,表示播放音频的文件名,有效范围为和对应的音频效果见下表1-1。
表1-1

所属于积木块    文件名    变量名称    中文名    英文名
01情绪    hello    SPEAKER.hello    哈喽    hello
hi    SPEAKER.hi    嗨    hi
bye    SPEAKER.bye    拜    bye
yeah    SPEAKER.yeah    耶    yeah
wow    SPEAKER.wow    哇    wow
laugh    SPEAKER.laugh    笑声    laugh
hum    SPEAKER.hum    哼唱    hum
sad    SPEAKER.sad    难过    sad
sigh    SPEAKER.sigh    叹气    sigh
annoyed    SPEAKER.annoyed    哼    annoyed
angry    SPEAKER.angry    生气    angry
surprised    SPEAKER.surprised    惊讶    surprised
yummy    SPEAKER.yummy    撒娇    yummy
curious    SPEAKER.curious    好奇    curious
embarrassed    SPEAKER.embarrassed    尴尬    embarrassed
ready    SPEAKER.ready    准备    ready
sprint    SPEAKER.sprint    冲刺    sprint
sleepy    SPEAKER.sleepy    打呼    sleepy
meow    SPEAKER.meow    喵    meow
02电子音效    start    SPEAKER.start    启动    start
switch    SPEAKER.switch    开关    switch
beeps    SPEAKER.beeps    哔哔    beeps
buzzing    SPEAKER.buzzing    蜂鸣    buzzing
explosion    SPEAKER.explosion    爆炸    explosion
jump    SPEAKER.jump    跳动    jump
laser    SPEAKER.laser    激光    laser
level-up    SPEAKER.level-up    升级    level-up
low-energy    SPEAKER.low-energy    低能量    low-energy
prompt-tone    SPEAKER.prompt-tone    提示    prompt-tone
right    SPEAKER.right    正确    right
wrong    SPEAKER.wrong    错误    wrong
ring    SPEAKER.ring    铃声    ring
score    SPEAKER.score    得分    score
wake    SPEAKER.wake    激活    wake
warning    SPEAKER.warning    警告    warning
03物理音效    metal-clash    SPEAKER.metal-clash    金属音    metal-clash
shot    SPEAKER.shot-1    发射    shot
glass-clink    SPEAKER.glass-clink    玻璃杯    glass-clink
inflator    SPEAKER.inflator    打气    inflator
running water    SPEAKER.running-water    流水声    running water
clockwork    SPEAKER.clockwork    发条    clockwork
click    SPEAKER.click    滴答    click
current    SPEAKER.current    电流    current
switch    SPEAKER.switch    开关    switch
wood-hit    SPEAKER.wood-hit-3    木桶    wood-hit
iron    SPEAKER.iron-1    金属    iron
drop    SPEAKER.drop    水滴    drop
bubble    SPEAKER.bubble-1    冒泡    bubble
wave    SPEAKER.wave    挥动    wave
magic    SPEAKER.magic    魔法    magic
spitfire    SPEAKER.spitfire    喷火    spitfire
heartbeat    SPEAKER.heartbeat    心跳    heartbeat
load    SPEAKER.load    装弹    load



全篇结束,Byebye。

© 版权声明
THE END
喜欢就支持一下吧
点赞5 分享
评论 共2条
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片
    • Senc的头像-Senc森辞知识分享站钻石会员Senc徽章-年度人气达人-Senc森辞知识分享站等级-LV6-Senc森辞知识分享站作者0