[null,null,["עדכון אחרון: 2025-09-01 (שעון UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eCameraSound\u003c/code\u003e trait applies to devices that can detect sound events, like the Nest Cam, Nest Hub Max, and Nest Doorbell.\u003c/p\u003e\n"],["\u003cp\u003eThis trait only has an event for when sound is detected and does not include any fields or commands.\u003c/p\u003e\n"],["\u003cp\u003eWhen a sound is detected, an event is triggered with details such as an event ID, timestamp, and session ID, which can be used for image retrieval and event correlation.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the provided event IDs with the GenerateImage command to download images associated with the sound event within a 30-second timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThis trait may return specific error codes like \u003ccode\u003eDEADLINE_EXCEEDED\u003c/code\u003e if an image request is made after its expiration or \u003ccode\u003eFAILED_PRECONDITION\u003c/code\u003e if an incorrect event ID is used.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nCameraSound Schema\n\n[Nest Cam (legacy)](/nest/device-access/api/camera) [Nest Hub Max](/nest/device-access/api/display) [Nest Doorbell (legacy)](/nest/device-access/api/doorbell)\n\n`sdm.devices.traits.CameraSound`\n\nThis trait belongs to any device that supports sound detection events.\n\n\u003cbr /\u003e\n\nFields\n\n\nThere are no fields available for this trait.\n\n\u003cbr /\u003e\n\nCommands\n\nThere are no commands available for this trait.\n\nEvents\n\n\u003cbr /\u003e\n\nSound\n\nSound has been detected by the camera.\n\nSound event \n\nPayload \n\n {\n \"eventId\" : \"2a0bf6b9-3d1f-4e60-a397-a4f919ddcc61\",\n \"timestamp\" : \"2019-01-01T00:00:01Z\",\n \"resourceUpdate\" : {\n \"name\" : \"enterprises/project-id/devices/device-id\",\n \"events\" : {\n \"sdm.devices.events.CameraSound.Sound\" : {\n \"eventSessionId\" : \"CjY5Y3VKaTZwR3o4Y19YbTVfMF...\",\n \"eventId\" : \"MsKrvlt1fwH1TDU5A7qxAe6FHG...\"\n }\n }\n }\n \"userId\" : \"AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi\",\n \"resourceGroup\" : [\n \"enterprises/project-id/devices/device-id\"\n ]\n }\n\nSound event fields\n\n| Field | Description | Data Type |\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|\n| `eventSessionId` | An ID given to events occurring as part of a single session of related events. May be used for consolidating events. | `string` Example: \"CjY5Y3VKaTZwR3o4Y19YbTVfMF...\" |\n| `eventId` | An ID associated with the event. Use it with the [GenerateImage command](/nest/device-access/traits/device/camera-event-image#generateimage) to download the camera image related to this event. | `string` Example: \"MsKrvlt1fwH1TDU5A7qxAe6FHG...\" |\n\nEvent payload fields\n\n| Field | Description | Data Type |\n|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|\n| `eventId` | The unique identifier for the event. | `string` Example: \"2a0bf6b9-3d1f-4e60-a397-a4f919ddcc61\" |\n| `timestamp` | The time when the event occurred. | `string` Example: \"2019-01-01T00:00:01Z\" |\n| `resourceUpdate` | An object that details information about the resource update. | `object` |\n| `userId` | A unique, obfuscated identifier that represents the user. | `string` Example: \"AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi\" |\n| `resourceGroup` | An object that indicates resources that might have similar updates to this event. The resource of the event itself (from the `resourceUpdate` object) will always be present in this object. | `object` |\n\nSee [Events](/nest/device-access/api/events) for more information on the different\ntypes of events and how they work.\n\n\u003cbr /\u003e\n\n\nErrors\n\nThe following error code(s) may be returned in relation to this trait:\n\n| Error Message | RPC | Troubleshooting |\n|---------------------------------------------------|-----------------------|-------------------------------------------------------------------------------------------------------------------|\n| Camera image is no longer available for download. | `DEADLINE_EXCEEDED` | Event images expire 30 seconds after the event is published. Make sure to download the image prior to expiration. |\n| Event id does not belong to the camera. | `FAILED_PRECONDITION` | Use the correct `eventID` returned by the camera event. |\n\nSee the [API Error Code Reference](/nest/device-access/reference/errors/api) for\nthe full list of API error codes.\n\n\u003cbr /\u003e"]]
