bosch-shc-api-docs icon indicating copy to clipboard operation
bosch-shc-api-docs copied to clipboard

Camera services documentation

Open david-pace opened this issue 2 years ago โ€ข 6 comments

Hi,

previously, security cameras such as the Eyes camera exposed three services:

  • CameraLight
  • CameraNotification
  • PrivacyMode

but since the last Smart Home Controller update the PrivacyMode service is gone. Consequently, the cameras can not be switched on and off anymore. Was the service removed on purpose (I hope not)? And if so, is there an alternative?

Also, it would be great if you could add operations for all camera services in the Open API documentation and the Postman collection (currently, only the PrivacyMode service is listed there).

Thank you very much ๐Ÿ™‚

david-pace avatar Nov 25 '23 15:11 david-pace

I had the same issue, but the learned that Bosch Camera App was just not connected in Bosch Smart Home App anymore. Please check if the camera is available in the Smart Home App.

tschamm avatar Nov 25 '23 16:11 tschamm

Thanks for the response @tschamm ๐Ÿ‘ As far as I can see all my cameras are still connected to the Bosch Smart Home app. Also, if I query the services of an Eyes camera at /devices/{{device_id}}/services, I get:

[
    {
        "@type": "DeviceServiceData",
        "id": "CameraNotification",
        "deviceId": "hdm:Cameras:device id",
        "path": "/devices/hdm:Cameras:device id/services/CameraNotification"
    },
    {
        "@type": "DeviceServiceData",
        "id": "CameraLight",
        "deviceId": "hdm:Cameras:device id",
        "state": {
            "@type": "cameraLightState",
            "value": "OFF"
        },
        "path": "/devices/hdm:Cameras:device id/services/CameraLight"
    }
]

so it looks like the PrivacyMode state is missing. Also, I can not control the CameraNotification as before, so something seems to be wrong.

Could you please check if PrivacyMode is listed if you query your camera(s)? Thank you ๐Ÿ™‚

david-pace avatar Nov 25 '23 20:11 david-pace

I just checked for my system. I have the software 10.18.3249-29469 installed, and I see all three services for the Camera.

    {
        "@type": "device",
        "rootDeviceId": "xx",
        "id": "hdm:Cameras:xx",
        "deviceServiceIds": [
            "CameraLight",
            "CameraNotification",
            "PrivacyMode"
        ],
        "manufacturer": "BOSCH",
        "roomId": "hz_1",
        "deviceModel": "CAMERA_EYES",
        "serial": "XX",
        "profile": "GENERIC",
        "name": "Haustรผr",
        "status": "AVAILABLE",
        "childDeviceIds": [],
        "supportedProfiles": []
    },

tschamm avatar Nov 26 '23 16:11 tschamm

Thanks for checking this :+1: I have exactly the same software version, but in my output the PrivacyMode service was missing:

{
        "@type": "device",
        "rootDeviceId": "xx",
        "id": "hdm:Cameras:xx",
        "deviceServiceIds": [
            "CameraLight",
            "CameraNotification"
        ],
        "manufacturer": "BOSCH",
        "roomId": "hz_4",
        "deviceModel": "CAMERA_EYES",
        "serial": "XX",
        "profile": "GENERIC",
        "name": "Name",
        "status": "UNAVAILABLE",
        "childDeviceIds": [],
        "supportedProfiles": []
}

Now I actively deleted a camera and re-added it (I had to re-authenticate again)...and suddenly the PrivacyMode services are back (for all cameras) ๐Ÿ™‚ Maybe someone from Bosch can explain why I still saw the cameras with two available services, although the cameras were in fact not available (they were available in the Smart Camera app, but not in the Smart Home App)?

Whatever the case, the issue with the missing PrivacyMode service is now solved. What is left to do is to add the documentation for CameraLight and CameraNotification to the Open API documentation and the Postman collection.

david-pace avatar Nov 26 '23 21:11 david-pace

@david-pace I encountered the same error today again. I can see all cameras, however the service CameraNotification is just missing. It seems the Camera Cloud has some problems reporting the features of the camera via the API. Removing/Adding the camera from the Bosch SmartHome Controller and the Bosch SmartCamera App did not help making the service appear again... Anyone from Bosch can help here?

tschamm avatar May 25 '24 14:05 tschamm

@david-pace I encountered the same error today again. I can see all cameras, however the service CameraNotification is just missing. It seems the Camera Cloud has some problems reporting the features of the camera via the API. Removing/Adding the camera from the Bosch SmartHome Controller and the Bosch SmartCamera App did not help making the service appear again... Anyone from Bosch can help here?

I have also noticed the problem with the CameraNotification Service for a while now. Reconnecting the camera service, resetting the camera completely and connecting it again does not help...

beilm avatar Jun 21 '24 21:06 beilm