Configure MV+AI beep events

Machine vision and artificial intelligence (MVAI) enable you to receive distracted driving events. In addition, if a device has its in-cabin audio enabled, the driver can receive warnings in real time when a distraced driving event might be occuring. These are called beep events. If the behavior continues for a certain amount of time, a distracted driving event is created and sent to the cloud.

To turn the in-cabin audio on or off, use the PUT /devices/{imei}/device-config call to update the audioAlarms parameter.

Beep events can not upload media to the cloud, while distracted driving events can. If you want to add video to a beep event, create a virtual event for the time of the beep event and attach the media from that to the beep event. For more details on creating virtual events, see our virtual events guide.

The following is an example of beep events and distracted driving events. Two beep events occur before the distracted driving is created and sent to the cloud with media files.

    {
       "id": 262488179,
        "eventType": "cellPhoneUse",
        "metadata": "[{\"x\":-0.4104996621608734,\"y\":0.1994648277759552,\"z\":0.19065245985984802,",
        "lon": 34.92556004,
        "speed": 31.751998901367188,
        "status": "new",
        "severity": 3,
        "eventComments": [],
        "time": "2022-01-26T14:17:15.000Z",
        "files": [
            {
                "cameraId": 1,
                "fileId": "1643206635",
                "fileType": "video"
            },
            {
                "cameraId": 2,
                "fileId": "1643206635",
                "fileType": "video"
            }
        ]
    },
    {
        "id": 262487998,
        "eventType": "cellPhoneUseBeep",
        "metadata": "[{\"x\":0.5055922269821167,\"y\":0.29318785667419434,\"z\":0.2721801698207855,",
        "lat": 32.5012692,
        "lon": 34.92675782,
        "speed": 50.76000137329102,
        "status": "new",
        "severity": 3,
        "eventComments": [],
        "time": "2022-01-26T14:17:05.000Z",
        "files": []
    },
    {
        "id": 262487811,
        "eventType": "cellPhoneUseBeep",
        "metadata": "[{\"x\":-0.5036394000053406,\"y\":-1.1343798637390137,\"z\":0.14928512275218964,",
        "lat": 32.50101549,
        "lon": 34.9279487,
        "speed": 23.075999450683597,
        "status": "new",
        "severity": 3,
        "eventComments": [],
        "time": "2022-01-26T14:16:55.000Z",
        "files": []
    },