SCNRecorder
SCNRecorder allows you to record videos and to capture images from ARSCNView, SCNView and ARView (RealityKit) without sacrificing performance. It gives you an incredible opportunity to share the media content of your augmented reality app or SceneKit based game.
Starting version 2.2.0 SCNRecorder supports Metal only.
Requirements
- iOS 12.0+
- Xcode 12.0+
- Swift 5.0+
Installation
CocoaPods
pod 'SCNRecorder', '~> 2.7'
Carthage
github "gorastudio/SCNRecorder"
Usage
Import the SCNRecorder module.
import SCNRecorder
Call sceneView.prepareForRecording() at viewDidLoad.
@IBOutlet var sceneView: SCNView!
override func viewDidLoad() {
super.viewDidLoad()
sceneView.prepareForRecording()
}
And now you can use new functions to capture videos.
try sceneView.startVideoRecording()
sceneView.finishVideoRecording { (videoRecording) in
/* Process the captured video. Main thread. */
let controller = AVPlayerViewController()
controller.player = AVPlayer(url: recording.url)
self.navigationController?.pushViewController(controller, animated: true)
}
To capture an image it is enough to call:
sceneView.takePhoto { (photo: UIImage) in
/* Your photo is now here. Main thread. */
}
or
sceneView.takePhotoResult { (result: Result<UIImage, Swift.Error>) in
/* Result is here. Main thread. */
}
Look at the Example project for more details.
Audio capture
ARSCNView
To capture video with audio from ARSCNView enable audio in the ARConfiguration.
let configuration = ARWorldTrackingConfiguration()
configuration.providesAudioData = true
sceneView.session.run(configuration)
SCNView
To capture audio from SCNView you have to implement it by yourself.
var captureSession: AVCaptureSession?
override func viewDidLoad() {
super.viewDidLoad()
sceneView.prepareForRecording()
guard let recorder = sceneView.recorder else { return }
let captureSession = AVCaptureSession()
guard let captureDevice = AVCaptureDevice.default(for: .audio) else { return }
do {
let captureInput = try AVCaptureDeviceInput(device: captureDevice)
guard captureSession.canAddInput(captureInput) else { return }
captureSession.addInput(captureInput)
}
catch { print("Can't create AVCaptureDeviceInput: \(error)")}
guard captureSession.canAddRecorder(recorder) else { return }
captureSession.addRecorder(recorder)
captureSession.startRunning()
self.captureSession = captureSession
}
or, simply
var captureSession: AVCaptureSession?
override func viewDidLoad() {
super.viewDidLoad()
sceneView.prepareForRecording()
captureSession = try? .makeAudioForRecorder(sceneView.recorder!)
}
Music Overlay
Instead of capturing audio using microphone you can play music and add it to video at the same time.
let auidoEngine = AudioEngine()
override func viewDidLoad() {
super.viewDidLoad()
sceneView.prepareForRecording()
do {
audioEngine.recorder = sceneView.recorder
// If true, use sound data from audioEngine if any
// If false, use sound data ARSession/AVCaptureSession if any
sceneView.recorder?.useAudioEngine = true
let player = try AudioEngine.Player(url: url)
audioEngine.player = player
player.play()
}
catch {
print(\(error))
}
}
RealityKit
To support recording RealityKit, copy ARView+MetalRecordable.swift and ARView+SelfSceneRecordable.swift files to your project. Then look at RealityKitViewController.swift for usage.
That's it!
Look at the Example project for more details.
Author
Thanks to Fedor Prokhorov and Dmitry Yurlov for testing, reviewing and inspiration.
License
This project is licensed under the MIT License - see the LICENSE file for details
14.5k Dec 27, 2022
6 Sep 23, 2022
121 Aug 1, 2022
37 Dec 7, 2022
3 Nov 5, 2022
11 Sep 24, 2022
104 Sep 9, 2022
89 Oct 27, 2022
0 Dec 18, 2021
234 Aug 5, 2022
15.8k Dec 31, 2022
24 Jan 4, 2023
0 Dec 7, 2021
9 Dec 1, 2022
4.4k Dec 26, 2022
1.6k Jan 7, 2023
2.8k Jan 5, 2023
28 Nov 18, 2022
177 Nov 20, 2022
0 Dec 14, 2021