---
title: "scheduleBuffer(_:at:options:completionHandler:)"
framework: avfaudio
role: symbol
role_heading: Instance Method
path: "avfaudio/avaudioplayernode/schedulebuffer(_:at:options:completionhandler:)"
---

# scheduleBuffer(_:at:options:completionHandler:)

Schedules the playing samples from an audio buffer at the time and playback options you specify.

## Declaration

```swift
func scheduleBuffer(_ buffer: AVAudioPCMBuffer, at when: AVAudioTime?, options: AVAudioPlayerNodeBufferOptions = [], completionHandler: (@Sendable () -> Void)? = nil)
```

```swift
func scheduleBuffer(_ buffer: AVAudioPCMBuffer, at when: AVAudioTime?, options: AVAudioPlayerNodeBufferOptions = []) async
```

## Parameters

- `buffer`: The buffer to play.
- `when`: The time the buffer plays. For more information, see doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode#Scheduling-Playback-Time.
- `options`: The playback options that control buffer scheduling.
- `completionHandler`: The handler the system calls after the player schedules the buffer for playback on the render thread, or the player stops.

## Discussion

Discussion

## See Also

### Scheduling Playback

- [scheduleFile(_:at:completionHandler:)](avfaudio/avaudioplayernode/schedulefile(_:at:completionhandler:).md)
- [scheduleFile(_:at:completionCallbackType:completionHandler:)](avfaudio/avaudioplayernode/schedulefile(_:at:completioncallbacktype:completionhandler:).md)
- [scheduleSegment(_:startingFrame:frameCount:at:completionHandler:)](avfaudio/avaudioplayernode/schedulesegment(_:startingframe:framecount:at:completionhandler:).md)
- [scheduleSegment(_:startingFrame:frameCount:at:completionCallbackType:completionHandler:)](avfaudio/avaudioplayernode/schedulesegment(_:startingframe:framecount:at:completioncallbacktype:completionhandler:).md)
- [scheduleBuffer(_:completionHandler:)](avfaudio/avaudioplayernode/schedulebuffer(_:completionhandler:).md)
- [scheduleBuffer(_:at:options:completionCallbackType:completionHandler:)](avfaudio/avaudioplayernode/schedulebuffer(_:at:options:completioncallbacktype:completionhandler:).md)
- [scheduleBuffer(_:completionCallbackType:completionHandler:)](avfaudio/avaudioplayernode/schedulebuffer(_:completioncallbacktype:completionhandler:).md)
- [AVAudioPlayerNodeBufferOptions](avfaudio/avaudioplayernodebufferoptions.md)
- [AVAudioPlayerNodeCompletionCallbackType](avfaudio/avaudioplayernodecompletioncallbacktype.md)
- [AVAudioPlayerNodeCompletionHandler](avfaudio/avaudioplayernodecompletionhandler.md)