In-App iOS Hooks

Overview

If your application creates videos and you'd like your users to share them using Viddy, you can use the Document Interaction API to open your video in Viddy's sharing flow.

Benefits

• Add new mobile sharing option for your users
• Promote your app to Viddy's creative community
• Brand the video to your heart's content

Implementation

You must first save your file in MP4 format and use the filename extension ".viddy". For best results, Viddy prefers the following format: 

Dimensions: 640 x 480 (4:3) or 640 x 360 (16;9)
Video Format: MP4
Video Bit Rate: 1.5 Mpbs
Audio Format: AAC
Audio Bit Rate: 128 Kbps
Frame Rate: 29.97 fps
Max Runtime: 00:15 seconds

In addition we also support the following dimensions: 320x240, 352x288, 960x540, 1280x720

Using the iOS Document Interaction APIs you can trigger the video to be opened by Viddy. The Identifier for our Document Interaction UTI is com.viddy.media, and it conforms to the public.mpeg-4 UTI. In addition we also support  "com.apple.quicktime-movie" format files but recommend using com.viddy.media 

When triggered, a popup will show all the apps that handle the particular file type. For .viddy files this should only be Viddy. The developer needs to check if the "com.viddy" URL namespace is available. If unavailable, this means Viddy isn't installed on the user's device. The developer would have to 

If Viddy is installed, the user will be immediately presented with the FX screen. The video is preloaded and sized appropriately for Viddy. Other than using the appropriate video format, described above, our only requirement is that the video is at least 480px wide. 

Please note: If the video is longer than :15 seconds or larger than the required format, it will be trimmed / resized automatically.

In addition, the app developer can also send us an annotation with a return_uri parameter that provides a link the user needs to be directed to after the video upload is complete. 

Sample Objective-C code:

UIDocumentInteractionController *docController = [UIDocumentInteractionController interactionControllerWithURL:[NSURL fileURLWithPath:path]];
docController.UTI = @"com.viddy.media";
docController.annotation = [NSDictionary dictionaryWithObjectsAndKeys:@"http://www.yourUrl.com", @"return_uri", @"Your App Name", @"application_name", nil];
docController.delegate = self;
[docController retain];

Addition Documentation

Previewing and Opening Files
http://developer.apple.com/library/ios/#documentation/FileManagement/Conceptual/DocumentInteraction_TopicsForIOS/Articles/PreviewingandOpeningItems.html#//apple_ref/doc/uid/TP40010410-SW1

UIDocumentInteractionController Class Reference
http://developer.apple.com/library/ios/#documentation/UIKit/Reference/UIDocumentInteractionController_class/Reference/Reference.html