{"hierarchy":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode"]]},"identifier":{"interfaceLanguage":"swift","url":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/playAudio()"},"kind":"symbol","legalNotices":{"copyright":"Copyright © 2026 Apple Inc. All rights reserved.","privacyPolicy":"https:\/\/www.apple.com\/privacy\/privacy-policy","termsOfUse":"https:\/\/www.apple.com\/legal\/internet-services\/terms\/site.html"},"metadata":{"availableLanguages":["de-DE","en-US","es-419","fr-FR","it-IT","ja-JP","ko-KR","pt-BR","zh-CN"],"externalID":"c:objc(cs)AVAudioPlayerNode(im)playAndReturnError:","fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"playAudio"},{"kind":"text","text":"() "},{"kind":"keyword","text":"throws"}],"modules":[{"name":"AVFAudio"}],"navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAndReturnError:"}],"platforms":[{"introducedAt":"27.0","name":"iOS"},{"introducedAt":"27.0","name":"iPadOS"},{"introducedAt":"27.0","name":"Mac Catalyst"},{"introducedAt":"27.0","name":"macOS"},{"introducedAt":"27.0","name":"tvOS"},{"introducedAt":"27.0","name":"visionOS"},{"introducedAt":"27.0","name":"watchOS"}],"role":"symbol","roleHeading":"Instance Method","symbolKind":"method","title":"playAudio()"},"primaryContentSections":[{"declarations":[{"languages":["swift"],"platforms":["iOS","iPadOS","Mac Catalyst","macOS","tvOS","visionOS","watchOS"],"tokens":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"playAudio"},{"kind":"text","text":"() "},{"kind":"keyword","text":"throws"}]}],"kind":"declarations"},{"content":[{"anchor":"discussion","level":2,"text":"Discussion","type":"heading"},{"inlineContent":[{"text":"Start or resume playback immediately.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"text":"equivalent to playAtTime:nil error:&error","type":"text"}],"type":"paragraph"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"seeAlsoSections":[{"anchor":"Controlling-playback","generated":true,"identifiers":["doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/prepare(withFrameCount:)","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/playAudio(at:)","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/play()","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/play(at:)","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/isPlaying","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/pause()","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/stop()"],"title":"Controlling playback"}],"variants":[{"paths":["\/documentation\/avfaudio\/avaudioplayernode\/playaudio()"],"traits":[{"interfaceLanguage":"swift"}]},{"paths":["\/documentation\/avfaudio\/avaudioplayernode\/playaudio()"],"traits":[{"interfaceLanguage":"occ"}]}],"references":{"doc://com.apple.avfaudio/documentation/AVFAudio":{"abstract":[{"text":"Play, record, and process audio; configure your app’s system audio behavior.","type":"text"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio","kind":"symbol","role":"collection","title":"AVFAudio","type":"topic","url":"\/documentation\/avfaudio"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode":{"abstract":[{"text":"An object for scheduling the playback of buffers or segments of audio files.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"identifier","text":"AVAudioPlayerNode"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"AVAudioPlayerNode"}],"role":"symbol","title":"AVAudioPlayerNode","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/isPlaying":{"abstract":[{"text":"A Boolean value that indicates whether the player is playing.","type":"text"}],"fragments":[{"kind":"keyword","text":"var"},{"kind":"text","text":" "},{"kind":"identifier","text":"isPlaying"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"s:Sb","text":"Bool"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/isPlaying","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"playing"}],"role":"symbol","title":"isPlaying","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/isplaying"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/pause()":{"abstract":[{"text":"Pauses the node’s playback.","type":"text"}],"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"pause"},{"kind":"text","text":"()"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/pause()","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"pause"}],"role":"symbol","title":"pause()","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/pause()"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/play()":{"abstract":[{"text":"Starts or resumes playback immediately.","type":"text"}],"deprecated":true,"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"play"},{"kind":"text","text":"()"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/play()","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"play"}],"role":"symbol","title":"play()","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/play()"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/play(at:)":{"abstract":[{"text":"Starts or resumes playback at a time you specify.","type":"text"}],"deprecated":true,"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"play"},{"kind":"text","text":"("},{"kind":"externalParam","text":"at"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)AVAudioTime","text":"AVAudioTime"},{"kind":"text","text":"?)"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/play(at:)","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAtTime:"}],"role":"symbol","title":"play(at:)","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/play(at:)"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/playAudio()":{"abstract":[],"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"playAudio"},{"kind":"text","text":"() "},{"kind":"keyword","text":"throws"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/playAudio()","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAndReturnError:"}],"role":"symbol","title":"playAudio()","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/playaudio()"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/playAudio(at:)":{"abstract":[],"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"playAudio"},{"kind":"text","text":"("},{"kind":"externalParam","text":"at"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)AVAudioTime","text":"AVAudioTime"},{"kind":"text","text":"?) "},{"kind":"keyword","text":"throws"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/playAudio(at:)","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAtTime:error:"}],"role":"symbol","title":"playAudio(at:)","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/playaudio(at:)"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/prepare(withFrameCount:)":{"abstract":[{"text":"Prepares the file regions or buffers you schedule for playback.","type":"text"}],"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"prepare"},{"kind":"text","text":"("},{"kind":"externalParam","text":"withFrameCount"},{"kind":"text","text":": "},{"kind":"typeIdentifier","preciseIdentifier":"c:@T@AVAudioFrameCount","text":"AVAudioFrameCount"},{"kind":"text","text":")"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/prepare(withFrameCount:)","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"prepareWithFrameCount:"}],"role":"symbol","title":"prepare(withFrameCount:)","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/prepare(withframecount:)"},"doc://com.apple.avfaudio/documentation/AVFAudio/AVAudioPlayerNode/stop()":{"abstract":[{"text":"Clears all of the node’s events you schedule and stops playback.","type":"text"}],"fragments":[{"kind":"keyword","text":"func"},{"kind":"text","text":" "},{"kind":"identifier","text":"stop"},{"kind":"text","text":"()"}],"identifier":"doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/stop()","kind":"symbol","navigatorTitle":[{"kind":"text","text":"- "},{"kind":"identifier","text":"stop"}],"role":"symbol","title":"stop()","type":"topic","url":"\/documentation\/avfaudio\/avaudioplayernode\/stop()"},"doc://com.apple.documentation/documentation/Foundation/NSError":{"abstract":[{"text":"Information about an error condition including a domain, a domain-specific error code, and application-specific information.","type":"text"}],"fragments":[{"kind":"keyword","text":"class"},{"kind":"text","text":" "},{"kind":"identifier","text":"NSError"}],"identifier":"doc:\/\/com.apple.documentation\/documentation\/Foundation\/NSError","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"NSError"}],"role":"symbol","title":"NSError","type":"topic","url":"\/documentation\/foundation\/nserror"},"doc://com.apple.documentation/documentation/ObjectiveC/BOOL":{"abstract":[{"text":"Type to represent a Boolean value.","type":"text"}],"fragments":[{"kind":"identifier","text":"BOOL"}],"identifier":"doc:\/\/com.apple.documentation\/documentation\/ObjectiveC\/BOOL","kind":"symbol","navigatorTitle":[{"kind":"identifier","text":"BOOL"}],"role":"symbol","title":"BOOL","type":"topic","url":"\/documentation\/objectivec\/bool"},"doc://com.apple.documentation/documentation/technologies":{"abstract":[],"identifier":"doc:\/\/com.apple.documentation\/documentation\/technologies","kind":"technologies","role":"overview","title":"Technologies","type":"topic","url":"\/documentation\/technologies"}},"variantOverrides":[{"patch":[{"op":"replace","path":"\/identifier\/interfaceLanguage","value":"occ"},{"op":"replace","path":"\/metadata\/platforms","value":[{"introducedAt":"27.0","name":"iOS"},{"introducedAt":"27.0","name":"iPadOS"},{"introducedAt":"27.0","name":"Mac Catalyst"},{"introducedAt":"27.0","name":"macOS"},{"introducedAt":"27.0","name":"tvOS"},{"introducedAt":"27.0","name":"visionOS"},{"introducedAt":"27.0","name":"watchOS"}]},{"op":"replace","path":"\/metadata\/roleHeading","value":"Instance Method"},{"op":"replace","path":"\/metadata\/title","value":"playAndReturnError:"},{"op":"replace","path":"\/metadata\/symbolKind","value":"method"},{"op":"replace","path":"\/metadata\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAndReturnError:"}]},{"op":"replace","path":"\/hierarchy","value":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode"]]}},{"op":"add","path":"\/topicSections","value":null},{"op":"add","path":"\/relationshipsSections","value":null},{"op":"replace","path":"\/seeAlsoSections","value":[{"anchor":"Controlling-playback","generated":true,"identifiers":["doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/prepare(withFrameCount:)","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/playAudio(at:)","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/play()","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/play(at:)","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/isPlaying","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/pause()","doc:\/\/com.apple.avfaudio\/documentation\/AVFAudio\/AVAudioPlayerNode\/stop()"],"title":"Controlling playback"}]},{"op":"replace","path":"\/primaryContentSections\/0","value":{"declarations":[{"languages":["occ"],"platforms":["iOS","iPadOS","Mac Catalyst","macOS","tvOS","visionOS","watchOS"],"tokens":[{"kind":"text","text":"- ("},{"identifier":"doc:\/\/com.apple.documentation\/documentation\/ObjectiveC\/BOOL","kind":"typeIdentifier","preciseIdentifier":"c:@T@BOOL","text":"BOOL"},{"kind":"text","text":") "},{"kind":"identifier","text":"playAndReturnError:"},{"kind":"text","text":"("},{"identifier":"doc:\/\/com.apple.documentation\/documentation\/Foundation\/NSError","kind":"typeIdentifier","preciseIdentifier":"c:objc(cs)NSError","text":"NSError"},{"kind":"text","text":" **) "},{"kind":"internalParam","text":"outError"},{"kind":"text","text":";"}]}],"kind":"declarations"}},{"op":"add","path":"\/primaryContentSections\/1","value":{"kind":"parameters","parameters":[{"content":[{"inlineContent":[{"text":"On exit, if an error occurs, a description of the error.","type":"text"}],"type":"paragraph"}],"name":"outError"}]}},{"op":"add","path":"\/primaryContentSections\/2","value":{"content":[{"anchor":"return-value","level":2,"text":"Return Value","type":"heading"},{"inlineContent":[{"text":"YES for success","type":"text"}],"type":"paragraph"}],"kind":"content"}},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode\/title","value":"AVAudioPlayerNode"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode\/fragments","value":[{"kind":"identifier","text":"AVAudioPlayerNode"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode\/navigatorTitle","value":[{"kind":"identifier","text":"AVAudioPlayerNode"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1isPlaying\/title","value":"playing"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1isPlaying\/fragments","value":[{"kind":"identifier","text":"playing"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1pause()\/title","value":"pause"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1pause()\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"pause"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1play()\/title","value":"play"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1play()\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"play"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1play(at:)\/title","value":"playAtTime:"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1play(at:)\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAtTime:"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1playAudio()\/title","value":"playAndReturnError:"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1playAudio()\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAndReturnError:"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1playAudio(at:)\/title","value":"playAtTime:error:"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1playAudio(at:)\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"playAtTime:error:"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1prepare(withFrameCount:)\/title","value":"prepareWithFrameCount:"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1prepare(withFrameCount:)\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"prepareWithFrameCount:"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1stop()\/title","value":"stop"},{"op":"replace","path":"\/references\/doc:~1~1com.apple.avfaudio~1documentation~1AVFAudio~1AVAudioPlayerNode~1stop()\/fragments","value":[{"kind":"text","text":"- "},{"kind":"identifier","text":"stop"}]},{"op":"replace","path":"\/references\/doc:~1~1com.apple.documentation~1documentation~1Foundation~1NSError\/fragments","value":[{"kind":"identifier","text":"NSError"}]}],"traits":[{"interfaceLanguage":"occ"}]}]}