Eine ID, die Ereignissen zugewiesen wird, die im Rahmen einer einzelnen Sitzung mit zugehörigen Ereignissen auftreten. Kann zum Konsolidieren von Ereignissen verwendet werden.
string Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
eventId
Eine mit dem Ereignis verknüpfte ID.
Verwenden Sie ihn mit dem GenerateImage-Befehl, um das Kamerabild herunterzuladen, das sich auf dieses Ereignis bezieht.
Ein Objekt, das Ressourcen angibt, die möglicherweise ähnliche Aktualisierungen wie dieses Ereignis haben. Die Ressource des Ereignisses selbst (aus dem resourceUpdate-Objekt) ist immer in diesem Objekt vorhanden.
object
Weitere Informationen zu den verschiedenen Arten von Ereignissen und ihrer Funktionsweise finden Sie unter Ereignisse.
Fehler
Die folgenden Fehlercodes können in Bezug auf dieses Attribut zurückgegeben werden:
Fehlermeldung
RPC
Fehlerbehebung
Das Kamerabild kann nicht mehr heruntergeladen werden.
DEADLINE_EXCEEDED
Veranstaltungsbilder laufen 30 Sekunden nach der Veröffentlichung der Veranstaltung ab. Laden Sie das Bild vor Ablauf des Zeitraums herunter.
Die Ereignis-ID gehört nicht zur Kamera.
FAILED_PRECONDITION
Verwenden Sie die richtige eventID, die vom Kameraereignis zurückgegeben wird.
[null,null,["Zuletzt aktualisiert: 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"]]
