To a Remote URL

View on GitHub

VideoEditor SDK supports saving videos to a remote URL.

For the sake of this example, we create a video from a URL and present the video editor in a modal. Note, that we have to make the current class the delegate of the VideoEditViewController in order to handle export and cancellation there.

Implementing the Video Export Delegate Method#

When a video export is successful the method videoEditViewControllerDidFinish is invoked on the delegate class and a VideoEditorResult object is passed as an argument.

If no modifications have been made to the original video, we will not process the original video at all and also not reencode it. In this case, result.output.url will point to the original video that was passed to the editor, if available.

If you want to ensure that the original video is always reencoded, even if no modifications have been made to it, you can set VideoEditViewControllerOptions.forceExport to true, in which case result.output.url will always point to a newly generated video.

Create a Request Object#

In order to upload the exported video, create a URLRequest object for the web service that is supposed to receive the video upload and set the httpMethod to POST.

Create an Upload Task#

Using the URLSession networking API we create an uploadTask passing the url, urlRequest and a closure to handle the request outcome. In this example, we simply log the status code and potential errors. In a production app you would display some message to the user communicating the status of the request.

Once the upload successfully finished, we recommend that you delete the temporary file. Here, we first check whether the video file was passed without changes. This check is only necessary when working with the Simulator, since in production the app bundle is read-only.

Start Upload Task in Background#

Invoking the method resume on the upload tasks starts it in the background, allowing us to dismiss the view controller immediately.


import UIKit
import VideoEditorSDK

class SaveVideoToRemoteURLSwift: Example, VideoEditViewControllerDelegate {
  override func invokeExample() {
    // Create a `Video` from a URL to a video in the app bundle.
    let video = Video(url: Bundle.main.url(forResource: "Skater", withExtension: "mp4")!)

    // Create and present the video editor. Make this class the delegate of it to handle export and cancelation.
    let videoEditViewController = VideoEditViewController(videoAsset: video)
    videoEditViewController.delegate = self
    videoEditViewController.modalPresentationStyle = .fullScreen
    presentingViewController?.present(videoEditViewController, animated: true, completion: nil)
  }

  // MARK: - VideoEditViewControllerDelegate

  func videoEditViewControllerShouldStart(_ videoEditViewController: VideoEditViewController, task: VideoEditorTask) -> Bool {
    // Implementing this method is optional. You can perform additional validation and interrupt the process by returning `false`.
    true
  }

  func videoEditViewControllerDidFinish(_ videoEditViewController: VideoEditViewController, result: VideoEditorResult) {
    // The user exported a new video successfully and the newly generated video is located at `result.output.url`.
    // If **no modifications** have been made to the original video, we will not process the original video at all
    // and also not reencode it. In this case `result.output.url` will point to the original video that was passed to the editor,
    // if available. If you want to ensure that the original video is always reencoded, even if no modifications have
    // been made to it, you can set `VideoEditViewControllerOptions.forceExport` to `true`, in which case `result.output.url` will
    // always point to a newly generated video.

    // Create a `URLRequest` object for the web service that will receive this upload. This example doesn't use a valid
    // URL and the request will fail.
    var urlRequest = URLRequest(url: URL(string: "http://localhost/fileupload")!)
    // Most web services will expect the 'POST' HTTP method for file uploads.
    urlRequest.httpMethod = "POST"

    // Create the upload task.
    let uploadTask = URLSession.shared.uploadTask(with: urlRequest, fromFile: result.output.url) { data, response, error in
      if let error = error {
        print("The file upload failed: \(error)")
      }

      if let response = response as? HTTPURLResponse {
        print("The server replied with status code \(response.statusCode)")
      }

      if let data = data {
        print("Received a \(data.count) byte answer from the server.")
      }

      // Remove the video when done uploading. If the video was passed without rendering, we won't delete the file.
      // In production this check would not be needed because the app bundle is read-only.
      // Unfortunately, with the Simulator it is not read-only so we need to include this check
      // or the example will crash when opened a second time.
      if result.status != .passedWithoutRendering {
        try? FileManager.default.removeItem(at: result.output.url)
      }
    }

    // Start the upload task. This will run in the background, so the view controller can be dismissed immediately.
    uploadTask.resume()
    presentingViewController?.dismiss(animated: true, completion: nil)
  }

  func videoEditViewControllerDidFail(_ videoEditViewController: VideoEditViewController, error: VideoEditorError) {
    // There was an error generating the video.
    print(error.localizedDescription)
    // Dismissing the editor.
    presentingViewController?.dismiss(animated: true, completion: nil)
  }

  func videoEditViewControllerDidCancel(_ videoEditViewController: VideoEditViewController) {
    // The user tapped on the cancel button within the editor. Dismissing the editor.
    presentingViewController?.dismiss(animated: true, completion: nil)
  }
}