Repository navigation
DuckBuddy 的第一个公开版本:Pollen Robotics Microduck 双足机器鸭的手机 App,iOS 和 Android 均为原生开发,共用一个 Rust 核心。
The first public release of DuckBuddy, a phone app for Pollen Robotics' Microduck bipedal duck: native on iOS and Android, sharing one Rust core.
非官方 App / Unofficial app:DuckBuddy 是独立的社区作品,不是 Pollen Robotics 的官方 App,与 Pollen Robotics / Hugging Face 没有隶属或背书关系。
DuckBuddy is an independent community project. It is not an official Pollen Robotics app and is not affiliated with or endorsed by Pollen Robotics or Hugging Face.
功能 / Features
- 添加机器人 / Setup:蓝牙找鸭子、出厂 PIN 自动认证、配 Wi-Fi、起名字。Find the duck over Bluetooth, authenticate with the factory PIN automatically, join Wi-Fi, name it.
- 驾驶 / Drive:WebRTC 实时视频,四种摇杆模式(行走 / 头部 / 边走边看 / 高度),动作列,13 个情绪动作和三个玩法(激光追逐、自动踢球、自由活动),拍照和录像存进相册,按住说话(豆包实时语音,用户自备密钥)。
Live WebRTC video, four stick modes (walk / head / look while walking / height), moves, 13 emotions and three play modes (laser chase, soccer, free play), photos and video saved to the gallery, hold-to-talk voice (Doubao realtime, bring your own key). - 状态 / Status:实时 3D 姿态(官方四种配色)、站姿、电池、温度、15 个舵机的角度与偏差。Live 3D pose in the four official colourways, posture, battery, temperatures, and all 15 servos.
- 策略 / Policies:双腿 / 轮子切换、槽位管理、检查更新、在 Hugging Face 搜索下载。Legs / wheels, slots, update checks, and Hugging Face search and download.
- 设置 / Settings:换 Wi-Fi、语音、中文 / English。Wi-Fi, voice, Chinese / English.
- 自适应布局 / Adaptive layout:手机横竖屏、iPad、Android 平板与折叠屏、iPhone Duo。Phones in portrait and landscape, iPad, Android tablets and foldables, iPhone Duo.
- 演示模式 / Demo mode:没有机器人也能体验每个页面。Every screen works without a robot.
兼容性 / Compatibility
| 手机 / Phone | iOS 17+,Android 8.0+(API 26) |
| 机器人 / Robot | 已在 Microduck 0.17.8(API 44)上实测;低于 API 31 的机器人会被拒绝。情绪动作需 API 49+;蓝牙下的玩法需 0.23.0+,有视频连接时任何版本可用。 Tested on Microduck 0.17.8 (API 44); robots below API 31 are refused. Emotions need API 49+; play modes over Bluetooth need 0.23.0+, and work on any version while video is connected. |
安装 / Install
| 文件 / File | 说明 / Notes |
|---|---|
DuckBuddy-0.1.0.apk |
Android:直接安装(允许"安装未知来源应用")。用开发密钥签名,以后换正式签名时需先卸载旧版。 Install directly (allow unknown sources). Signed with a development key; switching to a release key later will need an uninstall first. |
DuckBuddy-0.1.0.ipa |
iOS:未签名,需用自己的 Apple ID 重签后安装,例如 AltStore、Sideloadly。 Unsigned: re-sign with your own Apple ID to install, e.g. with AltStore or Sideloadly. |
DuckBuddy-0.1.0-ios-dSYMs.zip |
iOS 符号文件,用于崩溃报告符号化。iOS debug symbols for crash reports. |
也可以从源码构建,见 README。You can also build from source; see the README.
已知限制 / Known limitations
- 摇杆走
control数据通道:机器人 0.17.8 还不提供teleop(不可靠)通道。The sticks use thecontrolchannel; robot 0.17.8 doesn't create the unreliableteleopchannel yet. - 安全(Noise 设置码)模式已实现,但 0.17.8 的
btd还不支持;App 里还不能输入自设 PIN。Secure (Noise setup-code) mode is implemented but not yet supported by 0.17.8'sbtd; a custom PIN can't be entered in the app yet. - 机器人不报告配色,默认奶油色,需在状态页选一次。Robots don't report their colourway; it defaults to Cream until picked on the Status screen.
- 高度模式目前只控制头部,机身高度 / 侧倾接口待官方确认。Height mode only moves the head for now; the body height / lean API is pending with Pollen.
- 风扇转速需在机器人上另装可选的
robot/fanstat。Fan speed needs the optionalrobot/fanstatservice on the robot.
许可 / License
Apache-2.0,与官方 pollen-robotics/microduck 相同。第三方组件与来源见 NOTICE。
Apache-2.0, the same as the official pollen-robotics/microduck. Third-party components and sources are listed in NOTICE.