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

# currentTime

The current time, in seconds, of the play head.

```
readonly attribute Number currentTime;
```

## Discussion

Setting this property moves the play head synchronously to the specified time.

Allowable values are floating points between `0` and [`duration`](/documentation/LivePhotosKitJS/LivePhotosKit.Player/duration). A value that places the play head between frames shows a weighted average of the two frames.

If the playback style is [`FULL`](/documentation/LivePhotosKitJS/LivePhotosKit.PlaybackStyle/FULL) a value of `0` corresponds to the at-rest view of the full-resolution photo. As `currentTime` increases, the Live Photo animation will be played back according to the playback style.

Because the required frames might not be decoded, setting `currentTime` could fail. In this case, `currentTime` will not take on its just-assigned value. Setting `currentTime` again to the same value in the near future will most likely succeed. There is no asynchronous callback to test for when the missing requirements for a particular `currentTime` value become available.

---

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)