ORKFileResult Class Reference

Inherits from ORKResult : NSObject
Declared in ORKFileResult.h

The ORKFileResult class is a result that references the location of a file produced during a task.

A file result is typically generated by the framework as the task proceeds. When the task completes, it may be appropriate to serialize the linked file for transmission to the server.

Active steps typically produce file results when CoreMotion or HealthKit are serialized to disk using a data logger (ORKDataLogger). Audio recording also produces a file result.

When you write a custom step, use files to report results only when the data is likely to be too big to hold in memory for the duration of the task. For example, fitness tasks that use sensors can be quite long and can generate a large number of samples. To compensate for the length of the task, you can stream the samples to disk during the task, and return an ORKFileResult object in the result hierarchy, usually as a child of an ORKStepResult object.

  contentType

The MIME content type of the result.

@property (nonatomic, copy, nullable) NSString *contentType

Discussion

For example, @"application/json".

Declared In

ORKFileResult.h

  fileURL

The URL of the file produced.

@property (nonatomic, copy, nullable) NSURL *fileURL

Discussion

It is the responsibility of the receiver of the result object to delete the file when it is no longer needed.

The file is typically written to the output directory of the task view controller, so it is common to manage the archiving or cleanup of these files by archiving or deleting the entire output directory.

Declared In

ORKFileResult.h