---
title: "init(player:templateItem:timeRange:)"
framework: avfoundation
role: symbol
role_heading: Initializer
path: "avfoundation/avplayerlooper/init(player:templateitem:timerange:)"
---

# init(player:templateItem:timeRange:)

Creates a player looper that continuously plays the specified time range of a player item.

## Declaration

```swift
convenience init(player: AVQueuePlayer, templateItem itemToLoop: AVPlayerItem, timeRange loopRange: CMTimeRange)
```

## Parameters

- `player`: The queue player to use for playback. The player must not be nil.
- `itemToLoop`: The player item to loop, which must not be nil.
- `loopRange`: The player item time range to loop. Passing a value of doc://com.apple.documentation/documentation/CoreMedia/CMTimeRange/invalid is equivalent to a time range of [0, player item’s duration].

## Return Value

Return Value An new instance of AVPlayerLooper.

## Discussion

Discussion The player item you specify will be used as a template to generate at least 3 player item replicas that will be inserted into the specified player’s queue to accomplish the looping playback. As the player item will only be used as a template, and not for actual playback, any changes you make to the player item after initialization will not be reflected in the replicas. If you need to explicitly configure the replica player items, such as adding instances of AVPlayerItemOutput to them, you can access them through the loopingPlayerItems property. important: The specified player item’s asset should have its duration property loaded before you initialize this class so that initialization will not be blocked while waiting for the duration to become known. An invalidArgumentException will be raised if the player item has a duration of 0. You should not modify the player’s queue while AVPlayerLooper is performing looping playback. If you need to perform any additional configuration of the player prior to playback, you should set its rate to 0.0, perform the required configuration, and then begin playback once the configuration is complete. The CMTimeRange you specify will limit each item’s loop iteration to playing within the specified time range. To loop the full duration of the asset, specify a time range value of invalid for the timeRange parameter. Time range looping will be accomplished by seeking to the time range’s start time and setting player item’s forwardPlaybackEndTime property on the looping item replicas. important: An invalidArgumentException will be raised if the time range you specify has a duration of 0 or is not contained within the time range of the template player item.

## See Also

### Creating a player looper

- [init(player:templateItem:timeRange:existingItemsOrdering:)](avfoundation/avplayerlooper/init(player:templateitem:timerange:existingitemsordering:).md)
- [init(player:templateItem:)](avfoundation/avplayerlooper/init(player:templateitem:).md)