<!--
{
  "availability" : [
    "LivePhotosKit JS: 1.3.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "LivePhotosKitJS",
  "identifier" : "/documentation/LivePhotosKitJS/LivePhotosKit.Player/proactivelyLoadsVideo",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "LivePhotosKit JS"
    ],
    "preciseIdentifier" : "instp/LivePhotosKit.Player/proactivelyLoadsVideo"
  },
  "title" : "proactivelyLoadsVideo"
}
-->

# proactivelyLoadsVideo

A boolean value that indicates whether the Player downloads bytes before the user begins playback.

```
attribute Boolean proactivelyLoadsVideo;
```

## Discussion

Whether or not the Player downloads bytes at the provided [`videoSrc`](/documentation/LivePhotosKitJS/LivePhotosKit.Player/videoSrc) before the user begins playback.

If there are many Players on a page, a value of `false` enables configuration of [`videoSrc`](/documentation/LivePhotosKitJS/LivePhotosKit.Player/videoSrc) on all Players without forcing expensive downloads of each Player’s video asset.

If there are few Players on a page, a value of `true` decreases the warmup and loading time necessary after an attempt to initiate playback before playback actually begins.

This tradeoff is left to the developer, but in the interests of out-of-the-box scalability, this property defaults to `false`.

Declarative markup attribute: `data-proactively-loads-video`

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)