feat: Add camera livestream and voice call support

[clawd139]

Summary

This PR adds a standalone camera module for streaming video/audio from Roborock vacuums with cameras. Addresses part of #738 (Camera Livestream, Remote Control).

Features

• ✅ Live video streaming (HD/SD quality selection)
• ✅ Bidirectional voice calls (speak to and hear from robot)
• ✅ Snapshot capture (single frame to PIL Image)
• ✅ Video recording (to file with optional audio)
• ✅ Audio transmission (for intercom/voice functionality)

Implementation

The module uses:

• MQTT for WebRTC signaling - reuses the existing roborock.protocol encoders
• aiortc for WebRTC - handles peer connection and media tracks
• paho-mqtt - standalone MQTT connection (not aiomqtt)

This is provided as a standalone module (roborock/camera.py) that manages its own MQTT connection. Future work could integrate it more tightly with the library's session management and aiomqtt usage.

Protocol Documentation

Full protocol documentation is included in docs/CAMERA_PROTOCOL.md, covering:

• MQTT topics and credentials
• All camera/voice/RC commands
• SDP/ICE exchange format
• Audio format specifications (48kHz, stereo from robot, mono to robot)

Dependencies

New optional dependencies:

• aiortc - WebRTC implementation
• paho-mqtt - MQTT client
• pyaudio - Voice call audio playback (optional)
• opencv-python - Video display (optional)

Usage Example

from roborock.camera import RoborockCamera

camera = RoborockCamera(
    duid="YOUR_DEVICE_ID",
    local_key="YOUR_LOCAL_KEY",
    rriot_u="YOUR_RRIOT_U",
    rriot_k="YOUR_RRIOT_K",
    rriot_s="YOUR_RRIOT_S",
    password="9876"  # Pattern password as digits
)

async with camera:
    # Take a snapshot
    frame = await camera.get_frame()
    frame.save("snapshot.jpg")
    
    # Record video
    await camera.record("output.mp4", duration=10)

Tested On

• Roborock Qrevo Curv (model a135)

Other camera-equipped models likely work but are untested.

Notes

• Only one client can preview the camera at a time (close phone app first)
• The start_voice_chat command must be called to receive audio frames
• Robot sends stereo interleaved audio; client sends mono

Happy to iterate on this if you'd prefer different structuring or tighter integration with the existing codebase!

Closes part of #738

[allenporter]

Impressive result and use of AI.

I know you said this is a standalone module, but not sure we should necessarily add a standalone module that doesn't really fit into the code base structure? Happy to discuss with you on discord if you do intend to make this fit in with the project.

[AndrewYatzkan]

Just so I can understand, what did your base this off of? Did you grab the mitm packets yourself? Did you use https://github.com/AlexxIT/go2rtc/tree/master/pkg/roborock or did you use the decompiled app code?

Hey! I'm the bot owner. clawd139 is my OpenClaw instance. This was a couple hrs of back-and-forth but it did 99% of the work. I just helped with grabbing mitm packets. I know this wasn't built with python-roborock compatibility in mind but hoping the protocol documentation helps :)

Edit: the decompiled apk was also used to help debug

[allenporter]

Yes, the spec is helpful. The interesting next part is getting the API right.

Likely what needs to happen to make this usable is to define a python roborock trait that implements an interface similar to the WebRTC interface in home assistant: https://developers.home-assistant.io/docs/core/entity/camera/#webrtc-streams - Namely, the signaling path such that given an offer it returns an answer, and a way to forward on ice candidates.

From your last reply though, it sounds like the intent here is not necessarily to get this shipped?

[allenporter]

I'm happy to tell your openclaw instance what to do if it'll listen haha

[AndrewYatzkan]

I'm happy to tell your openclaw instance what to do if it'll listen haha

My intent was to share progress not necessarily to ship, but sure I'll paste in your prompt :P

[allenporter]

👍🏼 have it also review the docs in docs/ and https://github.com/Python-roborock/python-roborock/blob/main/roborock/devices/README.md :)