How to call methods in ring_doorbell python library in python scripts?

MacGyver33 · March 21, 2020, 10:08pm

So I am trying to trigger the live video recording on some of my Ring cameras with a python script. I don’t really care about viewing the live feed right away, I just want it to record to the cloud so I have a recording and I can download it after it completes. I found that in the ring_doorbell python library that is used for the Ring HA integration there is a method called “live_streaming_json” that can trigger the live recording. I have tested it using Postman and the API calls it makes appears to start a live recording:

github.com

tchellomello/python-ring-doorbell/blob/3e82ab99c0c3f3469aee829b671ea3d2f40ee4b3/ring_doorbell/doorbot.py#L299-L310


@property
def live_streaming_json(self):
    """Return JSON for live streaming."""
    url = LIVE_STREAMING_ENDPOINT.format(self.id)
    req = self._ring.query(url, method="POST")
    if req and req.status_code == 204:
        url = DINGS_ENDPOINT
        try:
            return self._ring.query(url).json()[0]
        except (IndexError, TypeError):
            pass
    return None

Now all I need to do is call this method using a python script and the Ring entity from HA but I am having trouble figuring out how to call the method in the library in a script. Here is what I have so far but it does not appear to start recordings and there are no errors in the log. Any suggestions?

# obtain ring doorbell camera object
ring_cam = hass.states.get("camera.front")

ring_cam.live_streaming_json

I’d also like to be able to call this method in a script to have the camera take a fresh snapshot and then download it as another step to this script:

github.com

tchellomello/python-ring-doorbell/blob/3e82ab99c0c3f3469aee829b671ea3d2f40ee4b3/ring_doorbell/doorbot.py#L409-L422


def get_snapshot(self, retries=3, delay=1):
    """Take a snapshot and download it"""
    url = SNAPSHOT_TIMESTAMP_ENDPOINT
    payload = {"doorbot_ids": [self._attrs.get("id")]}
    self._ring.query(url)
    request_time = time.time()
    for _ in range(retries):
        time.sleep(delay)
        response = self._ring.query(url, method="POST", json=payload).json()
        if response["timestamps"][0]["timestamp"] / 1000 > request_time:
            return self._ring.query(
                SNAPSHOT_ENDPOINT.format(self._attrs.get("id"))
            ).content
    return False