FSPickerDelegate

// Called when user dismisses the picker controller.
- (void)fsPickerDidCancel:(FSPickerController *)picker;
// Called when picking of a single file resulted in error.
// This does not mean that picking of the rest of the files (in case of multiple files available) is interrupted.
// All files of multiple files pick, that resulted in error will call this method.
- (void)fsPicker:(FSPickerController *)picker pickingDidError:(NSError *)error;
// Called when picking of a single file completed with success.
// If you are picking multiple files this will be called for each of successfully picked file.
- (void)fsPicker:(FSPickerController *)picker pickedMediaWithBlob:(FSBlob *)blob;
// Called when "files picking" is finished. Blobs array will contain blobs of all successfully picked files.
- (void)fsPicker:(FSPickerController *)picker didFinishPickingMediaWithBlobs:(NSArray<FSBlob *> *)blobs;

The most important property is the apiKey. It is the only property you need to provide in order for FSPicker to actually work. You can find your application's api key in your developer portal.

Sources

NSArray

apikey

The sources array allows you to configure the sources you would like to have available in your application. You can find the source names below. If no array or an empty array is set, all the sources are displayed in the picker.

Mimetypes

NSArray

mimeTypes

The mimeTypes array is used for constraining the displayed files to certain types. There are typedefs defined for your convenience. If this property is not provided, all file types will be available for uploading (/).

Multiple Mode

Boolean

selectMultiple

Set to YES by default. If set to NO, FSPicker will automatically upload the first file that is selected, otherwise it will wait until the upload button is selected.

Max Files

NSInteger

maxFiles

Sets the maximum number of files you can upload simultaneously. No limit is set by default.

Front Camera

Boolean

defaultToFrontCamera

Set this option to YES if you want to open the "Camera" source with the front camera by default.

Data

NSData

data

Path to the Data to export. You must have this property or the localDataURL property set, in order to use FSSaveController.

Data URL

NSUrl

localDataURL

URL to local data. You must have either this property or the data property set, in order to use FSSaveController.

Data Mimetype

FSMimeType

dataMimeType

Mimetype to set for the files you would like to export. This setting is not required, but it is recommended that you provide it or the dataExtension setting.

Data Extension

NSString

dataExtension

Extension to set for the files you would like to export. You can use it interchangeably with the dataMimeType option.

Proposed Filename

NSString

proposedFileName

File name that will be set in the "file name field". This should not include an extension. If no name is provided, the end user will be required to provide it.

Store Options

Convenience class

storeOptions

FSStoreOptions is a Convenience class to create an optional object that configures how to store uploaded data. FSStoreOptions can be initialized with either NSDictionary or by default [[FSStoreOptions alloc] init] and then setting the values "by hand".

FSStoreOptions

Convenience class to create an optional object that configures how to store uploaded data. FSStoreOptions can be initialized with either NSDictionary or by default [[FSStoreOptions alloc] init] and then setting the values "by hand".

Where to store the file. The default is S3 FSStoreLocationS3. Other options are FSStoreLocationAzure, FSStoreLocationDropbox, FSStoreLocationRackspace and FSStoreLocationGoogleCloud. You must have configured your storage in the developer portal to enable this feature.

path

NSString

path

The path to store the file at within the specified file store. For S3, this is the key where the file will be stored at. By default, Filestack stores the file at the root at a unique id, followed by an underscore, followed by the filename, for example "3AB239102DB_myphoto.png". If the provided path ends in a '/', it will be treated as a folder, so if the provided path is "myfiles/" and the uploaded file is named "myphoto.png", the file will be stored at "myfiles/909DFAC9CB12_myphoto.png", for example.

container

NSString

container

The bucket or container in the specified file store where the file should end up. This is especially useful if you have different containers for testing and production and you want to use them both on the same Filestack app. If this parameter is omitted, the file is stored in the default container specified in your developer portal. Note that this parameter does not apply to the Dropbox file store.

access

NSString

FSAccess typedef of NSString

Unavailable in storeURL method. Options are FSAccessPublic or FSAccessPrivate. Indicates that the file should be stored in a way that allows public access going directly to the underlying file store. For instance, if the file is stored on S3, this will allow the S3 url to be used directly. This has no impact on the ability of users to read from the Filestack file URL. Defaults to 'private'.

base64decode

Boolean

base64decode

Specify that you want the data to be first decoded from base64 before being written to the file. For example, if you have base64 encoded image data, you can use this flag to first decode the data before writing the image file.