# Body Camera {% hint style="warning" %} This submodule utilizes API endpoints that require the **Pro** version of Sonoran CAD or higher. For more information, view our [pricing ](https://docs.sonoransoftware.com/cad/pricing/faq)page. {% endhint %} {% hint style="success" %} Looking for VPS, web, or dedicated hosting? Check out our official [server hosting](https://docs.sonoransoftware.com/promotions/fivem-hosting)! {% endhint %}
## What is the live Body Camera? Sonoran CAD is the only external CAD system offering livestream video from in-game users accessible through the [live map](#live-map), [active units preview](#preview), or a [dedicated window](#window). ## Activation Guide ### 1. Download and Install the Core If you haven't already, be sure to install and configure the [Sonoran CAD Core](https://docs.sonoransoftware.com/cad/integration-plugins/in-game-integration/fivem-installation) first. ### 2. Activate Locations The [locations submodule](https://docs.sonoransoftware.com/cad/integration-plugins/in-game-integration/fivem-installation/available-plugins/locations) includes all logic required to send bodycam images to the CAD. ### 3. Adjust the Core Configuration The bodycam settings are stored inside of the core configuration file.
Configuration Options | Variable | Description | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `command` | The command name to toggle your body camera on or off. | | `requireUnitDuty` | If enabled, the player must be logged into the CAD to use the body camera. | | `enableAnimation` | Play an in-game animation when activating or deactivating the body camera. | | `enableOverlay` |

Enables or disables the blinking body camera image on screen when enabled.
Default true

| | `overlayLocation` |

The position (corner) of the screen where the body camera image is displayed.
Options: top-left, top-right, bottom-left, bottom-right
Default: top-right

| | `enableBeeps` |

Enables or disables the body camera beeping when turned on.
Default: true

| | `beepType` |

Type of audio that the beeps use.

native = GTAV Native Sounds

nui = Custom Sound File

| | `beepFrequency` |

Adjusts the frequency at which unit body camera beeps when turned on(in milliseconds).
Default: 30000 (30 seconds)

| | `beepRange` | The range at which a person can hear the bodycam beeps | | `screenshotFrequency` |

Adjusts the frequency at which unit body cameras update (in milliseconds).
Default: 2000 (2 seconds)

| | `defaultKeybind` | The default keybind for toggling the bodycam. | | `autoEnableWithLights` | Automatically enable bodycam when emergency lights are enabled/disabled. | | `autoEnableWithWeapons` | Automatically enable bodycam when a weapon is drawn. | | `clothing` | Clothing items that must be worn in order to have a body camera. | | `weapons` | Weapons that when drawn enable bodycam. | | `bodycamCommandChangeFrequency` |

The command to adjust your individual body camera screenshot frequency to be different than the server's screenshotFrequency value.
Default: bodycamFreq

|
## In-Game Usage When in-game, units must also be actively signed into the dispatch, police, fire, or EMS panel. Use the `/bodycam` command to toggle your body camera on or off. On first usage, players will be prompted to grant permission for the bodycam:
#### Body Camera Overlay When your bodycam is on and being viewed in the CAD a periodic beep and body overlay will appear on your screen.
### Beeps The body camera plays server-sided beeps periodically while activated. * `beepFrequency` determines how often these beeps are played * `beepRange` determines how far away these beeps are heard ### Automatic Activation The body camera will automatically activate when an officer activates their lights or draws a firearm. * `autoEnableWithWeapons` enables automatic activation when one of the `weapons` items are used. * `autoEnableWithLights` to enabled automatic activation when emergency lights are enabled. ### Force Off You can now force your body camera off using `/bodycam forceoff` until you manually turn it back on via the `/bodycam` command. While in the forced-off state, the body camera will no longer automatically turn on when someone is viewing, or based upon any automatic events. ### Unit Duty Requirement You can enable or disable the requirement for a unit to have to be logged into the Police, EMS or Fire portions of CAD in order to activate their bodycam by setting `requireUnitDuty` to `true`. ### Keybind Users can customize a keybind to toggle their bodycams on and off. Navigate to Settings > Keybinds > FiveM and look for the keybind "Toggle BodyCam" under the resource `sonorancad` ### Animation When toggling your body camera on or off, an animation will play if `enableAnimation` is `true`. ### In-Game Recording By default, each recording includes a 30-second shadow buffer followed by 1 minute 30 seconds of video, for a maximum total length of 2 minutes. The shadow buffer length can be adjusted with `recording.shadowBufferSeconds`, but the total recording length cannot exceed 2 minutes. Recording can be started manually using a configurable keybind located under **Keybinds -> FiveM -> Sonoran CAD**. You can also enable automatic bodycam recording through `recording.autoRecordEvents`. Developers can also trigger bodycam recordings with a [client event](https://github.com/Sonoran-Software/SonoranCAD-Documentation/blob/master/integration-plugins/in-game-integration/framework-development-documentation/client-events.md#bodycam-record-toggle). Recordings can be viewed in the CAD under **Unit Management** > **Body Cam Recordings**
## CAD Usage
### Active Units In the active units panel, hover over the camera icon to view a preview of their bodycam.
### Window Click on the active unit preview or the pop out button on the live map to open a dedicated bodycam viewer window.
### Live Map In the live map, selecting a unit or hovering near a unit in the 3D map will show the bodycam.