Skip to content

DuckBuddy 0.1.0

Latest

Choose a tag to compare

@jackwuwei jackwuwei released this 22 Nov 06:53
· 1 commit to main since this release

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 the control channel; robot 0.17.8 doesn't create the unreliable teleop channel yet.
  • 安全(Noise 设置码)模式已实现,但 0.17.8 的 btd 还不支持;App 里还不能输入自设 PIN。Secure (Noise setup-code) mode is implemented but not yet supported by 0.17.8's btd; 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 optional robot/fanstat service 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.