# Customization

The VirtualCar360 Player and Player 360 can be configured using URL parameters. Parameters control gallery lookup, language, autoplay, HUD behavior, background color, slide mode, other vehicles and interior image display.

## Passing configuration

Most configuration is passed as query string parameters:

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&bg=black&autoplay=true
```

In selected Player variants, the key and vehicle identifier can also be passed in the URL path:

```txt
https://player360-staging.web.app/dealers/{key}/cars/{carId}
```

Example:

```txt
https://player360-staging.web.app/dealers/2f2b265625d76a6704b08093c652fd79/cars/10209937?ann_dealer_id=72&ann_show_more=true&bg=aaa
```

## Vehicle identification

The Player can load a vehicle presentation using:

- `carId`,
- `vin`,
- `numberPlates`,
- `numberplates`.


`carId` is the most precise method because it points to a specific Player presentation. If `carId` is not available, use VIN or registration number to automatically load the latest Player available for the vehicle.

Tip
For offer listings, VIN or registration number is usually the most convenient lookup method because these values are already available in the customer's system.

## Configuration parameters

| Parameter | Default value | Description |
|  --- | --- | --- |
| `key` | `''` | Image-set key. It can also be passed as a path parameter. |
| `carId` | `''` | Internal Player identifier. Points to a specific vehicle presentation. |
| `vin` | `''` | Alternative lookup by VIN. |
| `numberPlates` | `''` | Alternative lookup by registration number. |
| `numberplates` | `''` | Alias for `numberPlates`. |
| `lang` | browser language, fallback `en` | Interface language. Supported values: `bg`, `hr`, `cs`, `da`, `nl`, `en`, `et`, `fi`, `fr`, `de`, `el`, `hu`, `it`, `lv`, `lt`, `mt`, `pl`, `pt`, `ro`, `sk`, `sl`, `es`, `sv`. |
| `autoplay` | `true` | Enables autoplay. |
| `hudhide` | `5` | Controls HUD visibility. `-1` means always visible, `0` means hidden, a positive number means seconds before hiding after no interaction. |
| `bg` | `#000` | Player background color. Accepts CSS-compatible values such as `bg=fff`, `bg=black`, `bg=%23000000`. Invalid values fall back to `#000`. |
| `slide_mode` | `auto` | Photo sliding mode. Supported values: `auto`, `basic`, `carousel`, `swipe`. Invalid values fall back to `auto`. |
| `ann_dealer_id` | `''` | Dealer ID for the **Other vehicles** section. If missing or not numeric, the button is not displayed. |
| `ann_show_more` | `false` | Displays a large preview in the center of the screen when hovering over a vehicle thumbnail in **Other vehicles**. |
| `interior_fullscreen` | `true` | Displays 2:1 interior images as `cover` relative to the browser window. |


## Examples

### Minimal configuration by `carId`

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937
```

### Lookup by VIN

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&vin=1NKCLR0X1XR568641
```

### Lookup by registration number

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&numberPlates=WW4433E
```

### Polish interface and white background

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&lang=pl&bg=%23ffffff
```

### Player with other vehicles

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&ann_dealer_id=72&ann_show_more=true
```

### HUD always visible

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&hudhide=-1
```

### HUD hidden

```txt
https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&hudhide=0
```

## Best practices

- Pass only one vehicle identifier: `carId`, `vin` or `numberPlates`.
- Use `carId` when you need to point to a specific Player.
- Use VIN or registration number for easy connection with offer data.
- Use `loading="lazy"` when many Players are embedded on a listing page.
- Use `ann_dealer_id` only when the **Other vehicles** section should be available.
- Encode `#` as `%23` when using HEX colors in `bg`.