Awesome

VimeoUpload

Contents

• Getting Started
  • Installation
  • Prerequisites
  • Setup your Submodules
• Uploading Videos
• Locating your uploaded video on Vimeo
• Notable Constraints
• Want to Contribute?
• Found an Issue?
• Troubleshooting
• Questions
• License

Getting Started

Installation

VimeoUpload is available through Carthage and coming soon CocoaPods

Cocoapods

To install it, simply add the following line to your Podfile:

pod "VimeoUpload"

Carthage

Add the following to your Cartfile:

github "vimeo/VimeoUpload"

Prerequisites

1. Ensure that you've verified your Vimeo account. When you create an account, you'll receive an email asking that you verify your account. Until you verify your account you will not be able to upload videos using the API.
2. Ensure you have been granted permission to use the "upload" scope. This permission must explicitly be granted by Vimeo API admins. You can request this permission on your "My Apps" page under "Request upload access". Visit developer.vimeo.com.
3. Ensure that the OAuth token that you're using to make your requests has the "upload" scope included.
4. In order to run this project, **you will have to insert a valid OAuth token where it says "YOUR_OAUTH_TOKEN". You can obtain an OAuth token by visiting developer.vimeo.com and creating a new "app" and associated OAuth token. Without a valid OAuth token, you will be presented with a "Request failed: unauthorized (401)" error alert when you try to upload a video.

Setup your Submodules

If you are adding this library to your own project, follow the steps outlined in Getting Started with Submodules as Development Pods.

Uploading Videos

Please refer to the example projects for a demonstration of how VimeoUpload can be used to upload videos to Vimeo.

Locating your uploaded video on Vimeo

One can access a video's URL by inspecting the link property on the video that's associated with the upload descriptor: descriptor.video.link.

Notable Constraints

• iCloud Photos

If a PHAsset is in iCloud and not resident on device we need to download it to the device before asset export. Download must happen when the app is in the foreground.

• Background Sessions

Because an upload can take a significant amount of time, we must design for the user potentially backgrounding the application at any point in the process. Therefore all requests must be handled by an NSURLSession configured with a background NSURLSessionConfiguration. This means we must rely exclusively on the NSURLSessionDelegate, NSURLSessionTaskDelegate, and NSURLSessionDownloadDelegate protocols. We cannot rely on an NSURLSessionTask subclasses' completion blocks.

• Resumable Uploads

The NSURLSession API does not support resuming an interrupted background upload from an offset. The initial release of this library will use these APIs exclusively and therefore will also not support resuming an upload from an offset.

Found an Issue?

If you find any bugs or technical issues with this library, please create an issue and provide relevant code snippets, specific details about the issue, and steps to replicate behavior.

Troubleshooting

If you have any questions about using this library, please contact us directly, post in the Vimeo API Forum, or check out StackOverflow.

Want to Contribute?

If you'd like to contribute, please follow our guidelines found in CONTRIBUTING.md.

License

VimeoUpload is available under the MIT license. See the LICENSE file for more info.

Questions?

Tweet at us here: @vimeoapi.

Post on Stackoverflow with the tag vimeo-ios.

Get in touch here.

Interested in working at Vimeo? We're hiring!